A terminal workspace for AI agent sessions: run Claude, Codex or any shell
across several projects and git worktrees at once, and review what they
changed with VS Code's diffs, all in one TUI.
 Agents in worktrees. A session per worktree, its state in Sessions as it changes; review and commit what it did without leaving pando. More |
 Resume. Stop the daemon, start pando again: every session comes back and its agent continues the same conversation. More |
 Review and commit. Diffs inline or side by side, staging single lines, merge conflicts with VS Code's accept actions. More |
 GitHub. Pull requests with their checks, opened as a description or a diff, checked out in a worktree of their own. More |
 Language servers. References in a peek, code actions, rename and completion, from gopls or any server you configure. More |
 Editor. Untitled buffers, save with path completion, format on save. |
 Vim mode. vim_mode = true: normal, visual and insert modes in every editor. |
 Markdown. Source, rendered, or both side by side scrolling together. |
 Databases. SQLite, Postgres and MariaDB tables in a grid: filter, sort, edit, submit in one transaction. More |
 Editor groups. Files and sessions side by side or stacked, as VS Code's groups: drag a tab to a group's edge. More |
 Usage. Plan limits of every claude and codex sign-in; near a limit pando offers the profile with the most room. More |
 Quick open. ctrl+p over files, text, sessions and commands, a tab for each. More |
## How it works
```text
pando (TUI) ──┐
pando (CLI) ──┼── unix socket, JSON ──▶ daemon ──▶ sessions (PTY) in worktrees
agents ──┘
```
One daemon owns the sessions; the TUI and the CLI are its clients, so closing
the TUI leaves every agent running, and every attached TUI follows a change
made anywhere.
## Docs
| Doc | For |
| ---------------------------------------- | ---------------------------------------------------- |
| [Usage](docs/usage.md) | the user guide: sessions, review, editor, CLI, files |
| [Settings](docs/06-config.md) | `config.toml`, every setting, colors, keys |
| [Keys](docs/09-keys.md) | every key, per view and in a file |
| [Agent guide](skills/pando/SKILL.md) | driving pando from an agent; `pando skill` prints it |
| [Architecture](docs/01-architecture.md) | daemon, socket protocol, sessions, packages |
Contributors: [UI layout](docs/02-ui-layout.md) ·
[views](docs/03-views.md) · [preview](docs/04-preview.md) ·
[git](docs/05-git.md) · [testing](docs/07-testing.md) ·
[release](docs/08-release.md).
## Development
`make build` builds `./pando`, `make test` and `make lint` check it as CI
does; [AGENTS.md](AGENTS.md) and the contributor docs above describe the
code. Bugs and ideas go to [issues](https://github.com/xseman/pando/issues).
## License
Apache-2.0, see [LICENSE](LICENSE).