CLAUDE.md

Superintent Config

• Namespace: superintent-vscode
• Database: Local SQLite (.superintent/local.db)

Always search knowledge before exploring the codebase — it is the primary source of truth. All --stdin flags expect JSON input.

Setup Commands

Command	Description
npx superintent init [--url <url>]	Create database tables
npx superintent status	Check Turso connection
npx superintent dashboard [-p <port>] [-o]	Start dashboard (default port 3456, -o to auto-open browser)

Ticket Operations

Action	Command
Create	npx superintent ticket create --json <data> (JSON: {"title","intent","type","context","constraints","assumptions","changeClass","plan",[...]})
Get	npx superintent ticket get <id>
Preview	npx superintent ticket preview <id>
Update	npx superintent ticket update <id> [--json <data>] [--status] [--complete-all] [--complete-task <indices>] [--complete-dod <indices>] [--comment <text>] [--author <name>] [--context <context>] [--spec <spec-id>]
List	npx superintent ticket list [--status <status>] [--limit N]
Delete	npx superintent ticket delete <id>

Spec Operations

Action	Command
Create	npx superintent spec create --json <data> (JSON: {"title","content","author"})
Get	npx superintent spec get <id>
Preview	npx superintent spec preview <id>
List	npx superintent spec list [--limit N]
Update	npx superintent spec update <id> [--json <data>] [--title] [--comment <text>] [--author <name>]
Delete	npx superintent spec delete <id>

Knowledge Operations

Action	Command
Search	npx superintent knowledge search "<query>" [--limit N] [--namespace] [--category] [--ticket-type] [--tags] [--author] [--branch] [--branch-auto] [--min-score]
Extract	npx superintent knowledge extract <ticket-id> [--namespace <namespace>]
Create	npx superintent knowledge create --json <data> (JSON: {"title","namespace","content","category","source","confidence","scope","tags",[...]})
Get	npx superintent knowledge get <id>
Preview	npx superintent knowledge preview <id>
List	npx superintent knowledge list [--namespace] [--category] [--scope] [--source] [--author] [--branch] [--branch-auto] [--status active|inactive|all] [--limit N]
Update	npx superintent knowledge update <id> [--json <data>] [--title] [--namespace] [--category] [--tags] [--scope] [--origin] [--confidence] [--comment <text>] [--author <name>]
Activate	npx superintent knowledge activate <id>
Deactivate	npx superintent knowledge deactivate <id>
Promote	npx superintent knowledge promote <id>
Validate	npx superintent knowledge validate <id>[,<id2>,...] [--all]
Recalculate	npx superintent knowledge recalculate [--dry-run]