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,pioropencode
Install
Open the DMG and drag Ouijit.app into Applications.
On Debian or Ubuntu, install the package:
curl -LO https://github.com/ouijit/ouijit/releases/latest/download/ouijit-linux-x64.deb
sudo apt install ./ouijit-linux-x64.deb Anywhere else, unzip the app into a folder and run it from there:
curl -LO https://github.com/ouijit/ouijit/releases/latest/download/ouijit-linux-x64.zip
unzip ouijit-linux-x64.zip -d ~/.local/share
~/.local/share/ouijit-linux-x64/ouijit 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 python3on 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.