Getting started

Ouijit runs your coding agents side by side. Give each one a task, and it works in its own copy of the repo while you watch, review and merge.

Requirements

  • macOS 13 or later (Apple Silicon or Intel), or Linux x64
  • Git 2.20 or later
  • An agent CLI: claude, codex, pi or opencode

Install

Open the DMG and drag Ouijit.app into Applications.

Open Ouijit and add a project. Its board walks you through a practice task.

Where to go next

  • Worktrees: how each task gets its own copy of the repo.
  • Hooks: start your agent when a task starts.
  • Terminals: the sidebar, the terminal stack and shortcuts.
  • Command palette: jump to anything with ⌘K.
  • Panels: open the agent's plan, a dev server or a script beside its terminal.
  • Sandbox: let an agent run without permission prompts, kept to its worktree.
  • Pull requests: review and merge in Ouijit.

Coming from another tool

From Conductor and from Vibe Kanban map their ideas onto Ouijit's.

Updates

Ouijit checks for updates when it opens and every hour after. On macOS it downloads the update and offers to restart. On Linux it links to the release. You can turn this off under App Settings → Updates.

Missing tools

Help & setup lists the tools Ouijit looks for (git, the agent CLIs, gh and nono) and which ones it found. A feature that needs a missing tool says so where you use it.

Projects folder

Projects you create or clone go in ~/Ouijit/projects. Change it under App Settings → Projects.

Build from source

You need Node.js 22.22 or later and a C/C++ toolchain:

  • macOS: xcode-select --install
  • Linux: sudo apt install build-essential python3 on Debian or Ubuntu
git clone https://github.com/ouijit/ouijit.git
cd ouijit
npm install
npm start

For agents

If you're an agent in an Ouijit terminal, ouijit is on your PATH and its reference is in your system prompt. Start with For agents. Every page here is also plain Markdown at /docs/<slug>.md.