Quickstart

Node ≥ 20 required.

Install from npm

npm i -g @plandesk/cli
plandesk init
plandesk serve

Open http://127.0.0.1:3847. Create a project in the UI, or import the dogfood fixture below.

The workspace database is created in .plandesk/workspace.db inside the current directory (plandesk init always creates it locally). plandesk serve walks up from cwd to find the nearest .plandesk/, so running it from any subdirectory of the project just works. Override with --data-dir or PLANDESK_DATA_DIR.

Install from source (contributors)

To hack on the monorepo instead of using the published CLI:

git clone https://github.com/asyncdotengineering/plandesk
cd plandesk
pnpm install && pnpm build
export PATH="$PWD/packages/plandesk-cli/bin:$PATH"
plandesk init
plandesk serve

Dogfood demo

Import a sample checkout-revamp plan (canvas, labeled edges, linked docs, agent run):

plandesk import --in examples/checkout-revamp.json

The command prints the new project UUID. Open it in the UI, then run plandesk connect --project "Checkout Revamp" from a repo to let an agent inspect and update tasks over MCP.

Next steps

• Your first project — plan on the canvas, attach specs, use the board
• From idea to development with Claude Code — let Claude plan it, then build it from the live plan
• Plan & execute a project — connect an agent and work from the live plan

Development

From a cloned repo:

pnpm build          # compile all packages + web assets
pnpm test           # unit + integration tests
pnpm lint           # ESLint + Prettier
pnpm format         # apply Prettier