Lucitradocs

Install and first run

Lucitra runs a team of agents on your own machine: one plans the work, one builds it, and one reviews it. Tasks run in their own worktree, and a task that wants to push waits for you.

Not released yet. @lucitra/lucitra is not on npm, so the commands below do not resolve today. They are the interface as it will ship, documented ahead of release rather than after it.

Install

npx @lucitra/lucitra

To keep the command on your PATH:

npm install -g @lucitra/lucitra

Requirements

  • Node 24 or later. The package declares it, and an older Node fails before anything runs.
  • One agent runtime on your PATH: claude, codex or goose.

Open the shell

Run lucitra with no arguments, inside a repository:

cd your-project
lucitra

The shell shows the team, what is running, and anything waiting on you.

Scope a task

plan turns a goal into tasks without running any of them, so you can read the plan first:

lucitra plan "add rate limiting to the public API"

To see what the repository already says needs doing, from issues, drafts and old TODOs:

lucitra candidates

Run one, then approve the push

lucitra start-build
lucitra tasks

start-build returns as soon as the task has an id; the work happens in its own worktree. When a task is ready to push it stops and waits:

lucitra approve

decline refuses the push and leaves the worktree alone.

Next