Cadence

English · 简体中文 · 日本語 · 한국어 · Deutsch · Français · Español · Português (Brasil) · Русский

Cadence turns Pi into a conversation-driven engineering workflow: enter /cadence [goal], agree on the result once, and a persistent owner builds, recovers and verifies it. Use it from the terminal or the optional WebUI.

How it works

flowchart TD
    A["/cadence goal"] --> B["Investigate (readonly)"]
    B --> C["Align, then approve once"]
    C --> D["Independent assignments run in parallel worktrees"]
    D --> E["Real checks + automatic Agent review"]
    E -->|"pass"| F["Local merge into your branch"]
    E -->|"fail"| G["Self-revise"]
    G --> D
    F --> H["Curate knowledge (fixed budget)"]
    H -.-> B

flowchart LR
    A["Check fails"] --> B["Repair"] --> C["Re-plan the route"] --> D["Recorded deviation"] --> E["Stop only for outside conditions"]

flowchart LR
    T["Pi terminal"] <-->|"attach / detach"| O[("Persistent owner")]
    W["WebUI<br/>board · branches · steer"] <-->|"attach / detach"| O
    O --> X["Workers in worktrees"] --> Y["Your branch"]
    O -.-> K[".cadence/ knowledge"]

Why Cadence

Cadence is a trusted assistant, not a sandbox: its agents use host tools in the approved checkout or worktree. Use it on code you can review and recover.

Install

Requires Node >=22.19.0 and Pi logged in to a model provider; Cadence reuses Pi's login.

npm install -g @abelxiaoxing/cadence
pi install "$(npm root -g)/@abelxiaoxing/cadence"
cadence server install   # optional WebUI and boot service

cadence server install prints a private link (http://127.0.0.1:17423/?token=…). The token grants access to your workspace: keep the link private.

Use

Browser

1. Open the printed link once (cadence token-link --reveal prints it again).
2. Pick a working folder with the lower-right button.
3. Send /cadence [goal], then answer the clarifying questions.
4. Click Implement this plan and follow the board and the Subagents dock. Images can be pasted or dropped (details).

Terminal

Enter /cadence <goal> once in a trusted project's Pi conversation; the mode stays on after a goal completes. exit cadence or 退出 Cadence leaves it and never cancels accepted work. /cadence-history [run-id] is readonly. CADENCE_PARALLEL (default 4) sets concurrent workers. Details: conversation mode, history.

cadence project open /absolute/project   # one owner, port and history per project

Manage the service

cadence server status
cadence server restart     # after an upgrade or a .env / models.json change
cadence server upgrade     # fetch, install, restart; rolls back if the new version fails
cadence server stop
cadence server uninstall   # before npm uninstall -g
cadence doctor             # leftovers and recent recoveries; --fix for the rest

A crash or power loss needs no cleanup: the next start recovers and says what it did. See service management and remote access.

Development

Pi can also load a local checkout or packed tarball: add its absolute or relative path to Pi's packages, or try pi -e ./cadence. Cadence requires Pi 1.5.0 or a compatible 1.x host; development pins and tested runtimes are not universal compatibility promises.

bun install
bun run verify

Guidance by area is in engineering/ and AGENTS.md. verify is the single fast gate; it needs an official Node build and a private temporary directory (verification).

License

MIT. Bundled adaptations, fonts and vendors keep their own licenses: reuse and distribution, third-party notices.