Documentation
Everything devpit does, written down.
devpit is a desktop app for developers who run coding agents such as Claude Code. It gives every project its own terminal, a board for the work, the cost of every agent call and an orchestrator across projects, in one native window for Linux, macOS and Windows. It is free and open source under Apache 2.0, works without an account, and keeps projects, conversations and terminal history on your computer; devpit Plus, the part that runs on devpit.app, is free for now.
Start here
-
Introduction
What devpit is for, and what it keeps on your machine.
-
Installing
One line on Linux or macOS, an installer on Windows, what it needs, and where each build stands.
-
Your first project
Add a repository, open a terminal, and put a card on the board.
Concepts
-
The model
Seven objects. If something is not one of these, it does not get in.
-
Projects
The axis of parallelism: one repository, its board, its terminal.
-
The terminal
One target terminal per project, drawn by devpit, backed by tmux.
-
Worktrees
A checkout per line of work, made when needed, removed on its own once merged or when you say.
-
Orchestrators
A chat you drive that sees the projects you link to it, and the sessions of its account.
-
The project agent
A read-only agent for each project, with a dated, sourced memory that changes only when you approve.
The board
-
Columns and cards
A board per project, where moving a card is what starts the work.
-
Steps
What a column runs when a card arrives: an agent, a session or a command.
-
Moving cards
Manual, ask or auto — a lane moves a card only as far as you let it.
-
Runs and cost
Every execution of a step, what it cost, and what it left behind.
Providers and agents
-
Providers
The agent CLIs devpit drives, and the ones it only runs in a terminal.
-
Profiles
Run one CLI as several accounts: a program, arguments and environment.
-
Your agents
Agents are markdown files on your machine. devpit reads them, never copies them.
-
Skills and MCP
A read-only view of what your agent CLI already has installed.
Workspace
-
Chat
A conversation with your agent, with its cost, its questions and its checklist on screen.
-
The browser pane
The page your project serves, beside the terminal.
-
Files and changes
A file tree, the changes list, diffs and the project's artifacts, beside the terminal.
-
Capabilities
Built-in extras, installed per project: Notes and Excalidraw.
-
Notifications
Runs that ended, agents waiting on you, reminders, and how to pause all of it.
-
Focus mode
A door for one project. Unfinished, and off unless you turn it on.
-
The island
A capsule above your other windows: what every agent is doing, and the one waiting on you.
-
Reminders
A card's date going off at its time: a banner, a notification and a line in the bell.
-
Remote
This machine's terminals, board and waiting questions, from your phone or another computer, over Tailscale.
Reference
-
Settings
Every section and what it controls.
-
Keyboard shortcuts
Every key the window listens for.
-
The devpit command
`devpit` in a terminal: a menu on screen, or one subcommand with plain lines for scripts.
-
Usage and plan limits
What your sessions cost, by day, model and project.
-
Account
Optional. Today it signs you in and does nothing else.
-
Where your data lives
Everything is in ~/.devpit on this computer.
-
Troubleshooting
The refusals you may meet, and what each one means.