Docs/Workflows/macOS App

macOS App

PurePoint's macOS app provides a graphical workspace for managing agents.

Opening a project

Launch PurePoint from Applications. Add a project directory. The app reads .pu/manifest.json to discover existing worktrees and agents.

Multiple projects can be open simultaneously, each with its own agents and worktrees.

Sidebar

The sidebar shows all worktrees and agents with live status indicators:

  • Green: streaming (actively working)
  • Yellow: waiting (idle)
  • Red: broken (exited)

Click any agent to view its terminal in the main area.

Command palette

Open with Cmd+N. Gives instant access to:

  • Built-in agent types (Claude, Codex, OpenCode, Terminal)
  • Your custom agent defs
  • Saved swarms

Pick one, name the worktree, enter a prompt, and spawn. Fuzzy search narrows the list.

Pane grid

Split your workspace into terminal panes:

ActionShortcut
Split RightCmd+K Cmd+L
Split BelowCmd+K Cmd+J
Close PaneCmd+K Q
Focus UpCmd+K Up
Focus DownCmd+K Down
Focus LeftCmd+K Left
Focus RightCmd+K Right

Drag dividers to resize. Layouts persist across sessions.

Each pane displays one agent's terminal. Use pu grid assign <agent_id> from the CLI to assign agents to panes.

Point Guard Screen

The Point Guard Screen is a built-in terminal that opens at your home directory (~/), not inside any project. Rather than a custom chat interface, it gives you a real terminal where you run the AI CLI tool of your choice.

  • Customizable launch command — configure it to start Claude Code, Codex, or OpenCode
  • Full terminal access — not a black box; it is a real terminal you have complete control over
  • Conversation sidebar — browse past sessions in the left sidebar, search by keyword, and resume any previous conversation
  • Tool-agnostic — works with any supported AI CLI, so you are never locked into a single tool

From the Point Guard Screen you direct the work: spawn agents, check status, review progress, and course-correct — all from one place.

Diff viewer

Review agent work without leaving PurePoint:

  • Unstaged changes per worktree
  • PR diffs via gh CLI integration
  • Syntax-highlighted inline diffs
  • Modified files list with change indicators

Agents Hub

Three tabs for managing definitions:

  • Prompts: Create, edit, and browse prompt templates
  • Agents: Named agent defs with type, template, and tags
  • Swarms: Multi-agent compositions with roster and execution config

Schedule calendar

Browse schedules in month, week, day, or list view. See upcoming scheduled runs and their configurations.

Settings

Access via the settings panel:

  • General: Default behaviors
  • Display: Appearance preferences
  • Hotkeys: Rebind all keyboard shortcuts with live key recording and conflict detection
  • About: Version and updates (auto-update via Sparkle)

Keyboard shortcuts

All actions are rebindable in Settings > Hotkeys.