devpit.app

mx

ns

coraline.ns.cloudflare.com

nitin.ns.cloudflare.com

caa

txt

dmarc

v=DMARC1; p=quarantine; adkim=r; aspf=r; rua=mailto:dmarc_rua@onsecureserver.net;

User-agent: *
Allow: /
Sitemap: https://devpit.app/sitemap.xml

# devpit

> A native app for controlling your coding agents: one target terminal per project, a board that runs the work, a spending cap on every agent call, and an orchestrator across projects. For Linux, macOS and Windows; free and open source. Projects, conversations and files stay on the user's computer.

## Start here

- [Introduction](https://devpit.app/docs/introduction.md): What devpit is for, and what it keeps on your machine.
- [Installing](https://devpit.app/docs/installing.md): One line on Linux or macOS, an installer on Windows, what it needs, and where each build stands.
  - [Windows](https://devpit.app/docs/windows.md): A native installer with psmux inside it, or the Linux build inside WSL 2.
  - [Staying up to date](https://devpit.app/docs/updating.md): How devpit updates itself, and why your terminals survive it.
- [Your first project](https://devpit.app/docs/first-project.md): Add a repository, open a terminal, and put a card on the board.

## Concepts

- [The model](https://devpit.app/docs/the-model.md): Seven objects. If something is not one of these, it does not get in.
- [Projects](https://devpit.app/docs/projects.md): The axis of parallelism: one repository, its board, its terminal.
  - [The Manager](https://devpit.app/docs/manager.md): Every project's board in one place.
- [The terminal](https://devpit.app/docs/terminal.md): One target terminal per project, drawn by devpit, backed by tmux.
  - [Sessions that outlive the window](https://devpit.app/docs/sessions.md): Close devpit, reopen it, and what was running is still running.
- [Worktrees](https://devpit.app/docs/worktrees.md): A checkout per line of work, made when needed and removed when you say.
- [Orchestrators](https://devpit.app/docs/orchestrators.md): A chat you drive that sees the projects you link to it, and the sessions of its account.
  - [Orchestrator sessions](https://devpit.app/docs/orchestrator-sessions.md): The Sessions panel, handing a card's work to a session, hearing back, and replies you send as yourself.

## The board

- [Columns and cards](https://devpit.app/docs/board.md): A board per project, where moving a card is what starts the work.
- [Steps](https://devpit.app/docs/steps.md): What a column runs when a card arrives: an agent, a session or a command.
  - [Agent steps](https://devpit.app/docs/agent-steps.md): One headless turn that answers in JSON, with a spending cap.
  - [Session steps](https://devpit.app/docs/session-steps.md): A session you drive, in the card's terminal tab.
  - [Command steps](https://devpit.app/docs/command-steps.md): Your tests, builds and deploys, with context passed only as environment.
- [Moving cards](https://devpit.app/docs/moving-cards.md): Manual, ask or auto — a lane moves a card only as far as you let it.
- [Runs and cost](https://devpit.app/docs/runs.md): Every execution of a step, what it cost, and what it left behind.
  - [Reading a check](https://devpit.app/docs/checks.md): Verdict, validity and findings — why exit code zero is not a pass.

## Providers and agents

- [Providers](https://devpit.app/docs/providers.md): The agent CLIs devpit drives, and the ones it only runs in a terminal.
  - [Claude Code](https://devpit.app/docs/claude-code.md): The CLI devpit drives end to end: chat, agent steps and session steps.
  - [Codex, Gemini, Cursor and the rest](https://devpit.app/docs/terminal-agents.md): Agent CLIs devpit launches and recognises in a terminal.
- [Profiles](https://devpit.app/docs/profiles.md): Run one CLI as several accounts: a program, arguments and environment.
- [Your agents](https://devpit.app/docs/agents.md): Agents are markdown files on your machine. devpit reads them, never copies them.
- [Skills and MCP](https://devpit.app/docs/skills-and-mcp.md): A read-only view of what your agent CLI already has installed.

## Workspace

- [Chat](https://devpit.app/docs/chat.md): A conversation with your agent, with its cost, its questions and its checklist on screen.
- [The browser pane](https://devpit.app/docs/browser.md): The page your project serves, beside the terminal.
  - [Signing in](https://devpit.app/docs/browser-sessions.md): Separate sessions per pane, and a signed-in session brought over from your browser.
  - [Letting an agent drive a page](https://devpit.app/docs/browser-agents.md): Off by default, said out loud while it happens, and blind to password fields.
- [Files and changes](https://devpit.app/docs/files-and-changes.md): A file tree, the changes list, diffs and the project's artifacts, beside the terminal.
- [Capabilities](https://devpit.app/docs/capabilities.md): Built-in extras, installed per project: Notes and Excalidraw.
  - [Notes](https://devpit.app/docs/notes.md): Markdown notes saved as files in the project.
  - [Excalidraw](https://devpit.app/docs/excalidraw.md): Hand-drawn diagrams saved as files in the project.
- [Notifications](https://devpit.app/docs/notifications.md): Runs that ended, agents waiting on you, reminders, and how to pause all of it.
- [Focus mode](https://devpit.app/docs/focus.md): A door for one project. Unfinished, and off unless you turn it on.
- [The island](https://devpit.app/docs/island.md): A capsule above your other windows: what every agent is doing, and the one waiting on you.
- [Reminders](https://devpit.app/docs/reminders.md): A card's date going off at its time: a banner, a notification and a line in the bell.
- [Remote](https://devpit.app/docs/remote.md): This machine's terminals, board and waiting questions, from your phone or another computer, over Tailscale.

## Reference

- [Settings](https://devpit.app/docs/settings.md): Every section and what it controls.
- [Keyboard shortcuts](https://devpit.app/docs/shortcuts.md): Every key the window listens for.
- [Usage and plan limits](https://devpit.app/docs/usage.md): What your sessions cost, by day, model and project.
- [Account](https://devpit.app/docs/account.md): Optional. Today it signs you in and does nothing else.
- [Where your data lives](https://devpit.app/docs/your-data.md): Everything is in ~/.devpit on this computer.
- [Troubleshooting](https://devpit.app/docs/troubleshooting.md): The refusals you may meet, and what each one means.