Documentation

What devpit is for, and what it keeps on your machine.

One line on Linux or macOS, an installer on Windows, what it needs, and where each build stands.

• Windows
• Staying up to date

Add a repository, open a terminal, and put a card on the board.

Seven objects. If something is not one of these, it does not get in.

The axis of parallelism: one repository, its board, its terminal.

• The Manager

One target terminal per project, drawn by devpit, backed by tmux.

• Sessions that outlive the window

A checkout per line of work, made when needed and removed when you say.

A chat you drive that sees the projects you link to it, and the sessions of its account.

• Orchestrator sessions

A board per project, where moving a card is what starts the work.

What a column runs when a card arrives: an agent, a session or a command.

• Agent steps
• Session steps
• Command steps

Manual, ask or auto — a lane moves a card only as far as you let it.

Every execution of a step, what it cost, and what it left behind.

• Reading a check

The agent CLIs devpit drives, and the ones it only runs in a terminal.

• Claude Code
• Codex, Gemini, Cursor and the rest

Run one CLI as several accounts: a program, arguments and environment.

Agents are markdown files on your machine. devpit reads them, never copies them.

A read-only view of what your agent CLI already has installed.

A conversation with your agent, with its cost, its questions and its checklist on screen.

The page your project serves, beside the terminal.

• Signing in
• Letting an agent drive a page

A file tree, the changes list, diffs and the project's artifacts, beside the terminal.

Built-in extras, installed per project: Notes and Excalidraw.

• Notes
• Excalidraw

Runs that ended, agents waiting on you, reminders, and how to pause all of it.

A door for one project. Unfinished, and off unless you turn it on.

A capsule above your other windows: what every agent is doing, and the one waiting on you.

A card's date going off at its time: a banner, a notification and a line in the bell.

This machine's terminals, board and waiting questions, from your phone or another computer, over Tailscale.

Every section and what it controls.

Every key the window listens for.

What your sessions cost, by day, model and project.

Optional. Today it signs you in and does nothing else.

Everything is in ~/.devpit on this computer.

The refusals you may meet, and what each one means.