Anvil

A desktop coding agent for local repositories, powered by Codex.

Anvil works against a local repo and runs commands on the local machine, but it still requires an internet connection for Codex / OpenAI model calls.

This repo is at the initial scaffold stage. The current focus is:

• shaping the product and technical plan
• defining the Electron + Codex app-server architecture
• putting repo hygiene in place early

• Electron
• React
• TypeScript
• electron-vite
• ESLint + Prettier
• Husky + lint-staged
• Conventional Commits
• release-please for SemVer releases

.
├── .github/workflows/     # CI, release, and PR title checks
├── docs/plans/            # Product and architecture planning docs
├── src/harness/           # Agent runtime + provider/tool/session scaffold
├── src/main/              # Electron main process
├── src/preload/           # Electron preload bridge
├── src/renderer/          # React renderer app
├── electron.vite.config.ts
├── eslint.config.mjs
└── release-please-config.json

corepack enable
pnpm install
pnpm dev

Other useful commands:

pnpm lint
pnpm typecheck
pnpm format
pnpm build

Use Conventional Commits:

• feat: add repo picker shell
• fix: handle missing workspace path
• docs: add MVP scope draft

Releases are managed with release-please.

• fix: -> patch release
• feat: -> minor release
• ! or BREAKING CHANGE: -> major release

A semantic PR title workflow is included so squash merges can still drive versioning correctly.

• docs/plans/mvp-scope.md
• docs/plans/desktop-runtime.md
• docs/plans/approval-and-sandboxing.md
• docs/plans/release-strategy.md