Skip to content

2witstudios/PurePoint

Repository files navigation

PurePoint

An agent-first coding workspace for macOS.

CI macOS License: MIT Platform: macOS

PurePoint — 10 agents streaming across 10 worktrees

Your attention is the bottleneck. Other platforms run headless agents in parallel — you get results, but you can't see the work happening, and you can't step in while it's running. PurePoint gives you a terminal command center for your workspace. Terminals, worktrees, agents — all visible, all yours. You call the plays.

A terminal that runs the whole offense.

01 — The Point Guard Screen is your command center. A terminal at your home directory where you run Claude Code, Codex, or OpenCode — whichever fits the job. Browse your conversation histories in the sidebar, pick up where you left off, and direct the work from one screen. No black boxes, no vendor lock-in — just a real terminal you control.

Point Guard command center

02 — A terminal built for agents. Split panes, isolated worktrees, live output — each agent gets its own terminal session. Jump between them, scroll history, pipe input, kill a run. It feels like a real terminal because it is one.

Split pane workspace with multiple agents

Nothing hits your codebase until you say so.

See every change as it happens.

Diffs update live as agents work — file by file, worktree by worktree. You always know exactly what's changing. Step in when something looks off, or let it ride.

Diff viewer with PR changes

Everything else you need.

Scheduling — Schedule agents. Wake up to work.

Weekly schedule calendar

Custom agents & prompts — Configure how agents approach your codebase.

Agent definitions in the Agents Hub

Swarms — Fan out across many agents at once.

Swarm definition with roster and execution config

Hotkeys — Keyboard-driven everything.

Customizable hotkeys settings

Getting Started

Three steps. That's it.

  1. Download the latest .dmg from Releases. Drag to Applications.
  2. Add to PATH — the app installs the pu CLI to ~/.pu/bin/ on first launch:
    export PATH="$HOME/.pu/bin:$PATH"
  3. Init + spawn — in any git project:
    pu init
    pu spawn "fix the typo in README"
Build from source

Prerequisites: macOS, Rust 1.88+, Xcode, just

git clone https://github.com/2witstudios/purepoint.git
cd purepoint
just setup
just build-app

The pu CLI

pu is the command-line interface to PurePoint. All commands support --json for structured output.

Command Description
pu init Initialize a PurePoint workspace
pu spawn <prompt> Spawn an agent in a new worktree
pu status Show workspace status
pu bench [agent] Suspend agents (pull them off the court)
pu play <agent> Resume a benched agent
pu kill Kill agents (by agent, worktree, or all)
pu clean Remove worktrees, kill agents, delete branches
pu attach <agent> Attach to an agent's terminal
pu logs <agent> View agent output logs
pu send <agent> <text> Send text or keys to an agent's terminal
pu health Check daemon health
pu pulse Workspace pulse — agents, runtimes, git stats
pu diff Show git diffs across agent worktrees
pu watch Live dashboard showing all agents in real-time
pu prompt list|show|create|delete Manage saved prompt templates
pu agent list|show|create|delete Manage saved agent definitions
pu swarm list|show|create|delete|run Manage and run swarm compositions
pu grid show|split|close|focus|assign Control the pane grid layout
pu schedule list|show|create|delete|enable|disable Manage scheduled tasks
pu trigger list|show|create|delete Manage event-driven triggers
pu gate <event> Evaluate git hook gates

Spawn options

pu spawn "fix the auth bug" --name fix-auth              # worktree + agent
pu spawn "refactor tests" --agent codex                   # use codex instead of claude
pu spawn "review the PR" --worktree wt-existing           # add to existing worktree
pu spawn --root "run the dev server"                      # root agent (no worktree)
pu spawn --root --agent terminal                          # plain terminal
pu spawn --template code-review --var BRANCH=main         # from saved prompt
pu spawn --file path/to/prompt.md --name task1            # from file

Run pu --help for full usage.

Documentation

Getting Started Install, first agent, cleanup
CLI Reference All 21 commands with examples
Configuration Agent types, launch args, config.yaml
Concepts Mental model: worktrees, agents, swarms, scope
Templates & Definitions Prompts, agent defs, swarm defs
Scheduling & Triggers Schedules, triggers, git hooks
Troubleshooting Common issues and solutions
Contributing Build, test, code style, architecture

Current Status

macOS only. Linux TUI is planned.

PurePoint is early and under active development — the core works, but some features are still in design. See docs/ for specs and architecture.

License

MIT — 2wit Studios

About

Turn your agents into your point guard, while you coach and draw up the plays.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages