Anvil Desktop / Basics
Anvil Desktop
Anvil Desktop is the product in anvil-app: an Electron desktop app for local, repo-aware delivery work.
It connects repositories, agent sessions, work items, Git state, code review, security review, dependency analysis, documentation, diagrams, terminals, browser checks, companion controls, and handover evidence into one workspace.
The point is not to make a giant dashboard. The point is to keep delivery context close enough that a developer can inspect the work, verify the change, and hand over what happened without reconstructing the past from chat tabs and terminal scrollback.
Who it is for
Use Anvil Desktop when a change needs more than a chat transcript:
- A coding agent needs repo context, branch state, and file references.
- A work item has acceptance criteria, risks, dependencies, or follow-up tasks.
- Review findings need to survive into a PR or handover.
- Security, dependency, CI, data, or compliance checks matter.
- A teammate needs to understand what changed, what passed, and what was not verified.
Core surfaces
| Surface | Use it for |
|---|---|
| Repositories | Add local checkouts, inspect branch state, index modules, and ground sessions in the code that exists. |
| Chat | Run planning, implementation, review, investigation, documentation, and handover sessions with Codex or other configured LLM providers. |
| Work items | Bring Linear, Jira, Azure DevOps, acceptance criteria, BA findings, and follow-up tasks next to implementation work. |
| Editor and terminal | Open workspace-scoped editor and PTY sessions without losing app context. |
| Git and code review | Inspect diffs, run review workflows, separate blockers from preferences, and prepare PR handover notes. |
| Security and dependencies | Run audits, inspect package risk, export findings, and keep unresolved issues visible. |
| Documentation and diagrams | Keep docs, ADRs, generated architecture notes, Draw.io context, and Figma-adjacent design work near the repo. |
| Governance | Track lifecycle gates, impact analysis, decisions, readiness checks, and handover packs. |
| Companion controls | Use mobile, watch, Raycast, widget, and menu bar surfaces for small actions while the desktop app owns heavy review. |
Local-first shape
Anvil Desktop runs as a desktop app with privileged main-process services, a typed preload bridge, SQLite persistence, and a React renderer.
That boundary matters. Local developer tooling touches credentials, repositories, shell commands, work evidence, and connector state. Renderer code should not gain direct Node access just because a button wants to feel important.