Your first workspace

A workspace is where the actual work happens. This page walks you from an empty Octopush to your first message.

Open or create a project

A Project is a git repository. Point Octopush at a local repo to add it as a project, or open one you’ve already added.

[screenshot: project picker]

Create your first workspace

With a project open, create a new workspace (⌘N). Octopush creates a fresh git worktree for it — an isolated working copy that won’t touch your other workspaces or your main checkout.

Give it a name that describes the task you’re about to start.

[screenshot: new workspace dialog]

Land in Talk

A new workspace opens in Talk mode. This is a chat with the model you configured during installation. You’ll see live token counts and per-message cost as you go.

Type your first prompt and press ↵ to send. Use ⇧↵ for a newline, and ↑ / ↓ to walk through your prompt history.

[screenshot: Talk mode with a first message]

Switch modes

Your workspace has more than chat. Move between modes with:

⌘⇧1 — Talk (chat)
⌘⇧2 — Run (real terminal)
⌘⇧3 — Review (diff + git)
⌘⇧D — Direct (multi-agent pipelines)

Each mode operates on the same worktree, so a command you run in Run shows up as changes in Review.

Read Key concepts to understand the Projects → Workspaces → Modes model that makes this work.