planalot

A local plan workspace daemon and browser UI for agent planning workflows.

⚠️ Experimental — early phase. Planalot is in an experimental, pre-1.0 stage. The CLI commands, HTTP API, on-disk plan format, and overall behavior may change without notice between releases, and breaking changes can land in any version. Not yet recommended for production use.

Install

Install the CLI globally from npm:

npm install -g planalot

Then wire Planalot into your agent harness:

# For Claude Code
planalot install cc

# For Codex
planalot install codex

# For Pi
planalot install pi

Stack

• Node.js 22+ native HTTP daemon
• TypeScript ESM packages
• Vite + React single-file browser app
• SSE for live session updates
• pnpm workspaces

Quick start

pnpm install
pnpm build
printf '# Plan\n' > PLAN.md
pnpm planalot PLAN.md

The CLI starts or reuses a per-user daemon, creates a Planalot-owned workspace under ~/.planalot/plans/<id>, and opens the browser UI. Imported files are copied into Planalot; Planalot owns the source of truth after creation/import.

Plan workspaces

Each plan is stored as:

~/.planalot/plans/<id>/
  manifest.json
  feedback.json
  requirements/
    index.md
  design/
    architecture.md
    flow.html
  tasks/
    tasks.md

requirements/index.md is required and canonical. Additional .md and .html files live under requirements/, design/, or tasks/.

Useful CLI commands:

pnpm planalot create --name "Payments Plan" --json
pnpm planalot import PLAN.md --name "Payments Plan" --json
pnpm planalot find payments --status planning --json
pnpm planalot read <planId> --all --json
pnpm planalot write <planId> design/architecture.md --stdin --json
pnpm planalot open <planId>
pnpm planalot wait-feedback <planId> --timeout 600 --json
pnpm planalot feedback-result <planId> --stdin --json
pnpm planalot implement <planId> --json

Pi install

pnpm planalot install pi

Then restart Pi or run /reload. The Pi extension provides /planalot <existing-plan.md> and the planalot_open_plan tool.

Claude Code install

pnpm planalot install cc

This installs ~/.claude/skills/planalot/SKILL.md. If an older generated ~/.claude/commands/planalot.md exists, the installer updates it as a fallback, but Claude Code prefers the skill. In Claude Code, use /planalot to create, import, review, or continue Planalot-owned layered plan workspaces.

To check whether the generated Claude Code skill matches the local Planalot CLI version:

pnpm planalot install cc --check

Codex install

pnpm planalot install codex
codex plugin add planalot@personal

Then start a new Codex thread and use $planalot. The Codex plugin opens Planalot from the current workspace, but feedback from the browser is manual/copyable until Codex exposes a live extension message bridge like Pi's sendUserMessage.

To check whether the generated Codex plugin, generated skill, Codex cache, and local Planalot CLI version are in sync:

pnpm planalot install codex --check

License

Apache-2.0. See LICENSE and NOTICE.