Octopush documentation
Octopush is a native macOS IDE built for developers who work with AI agents all day.
The one-line truth: every coding session is a git worktree with an AI assigned to it — isolated, parallel, and disposable.
Instead of bolting a chat panel onto a traditional editor, Octopush makes the agentic session the unit of work. You spin up a workspace, talk to a model, run real commands, and review the diff — without the AI ever stepping on another task you have in flight.
The four surfaces
Section titled “The four surfaces”Each workspace has four modes. Three are always present; the fourth is optional.
§ TALK — A focused chat with the model of your choice. Live token counts, per-message cost, and prompt history. Switch with ⌘⇧1.
§ RUN — A real PTY terminal, not a sandboxed emulation. Run builds, tests, servers, anything. Sessions survive app restarts. Switch with ⌘⇧2.
§ REVIEW — A unified diff viewer with an embedded editor and git status. See exactly what changed, edit in place, and stage work. Switch with ⌘⇧3.
§ DIRECT — Multi-agent pipelines: chain stages, hand work between agents, gate on checkpoints. Optional per workspace. Switch with ⌘⇧D.
The mental model
Section titled “The mental model”Projects → Workspaces → Modes. A Project is your repository; a Workspace is a git worktree with an AI assigned; each Workspace gives you the four modes above.
Continue to Installation to get Octopush running on your Mac.