CLI Reference

The primary way to use claustre is the TUI dashboard — just run claustre. The CLI commands below are an alternative for scripting or when you prefer the terminal.

Dashboard

claustre                  # Launch TUI (default command)
claustre dashboard        # Same as above, explicit

The default command opens the terminal dashboard where you can manage projects, create and launch tasks, monitor sessions, and interact with embedded Claude Code terminals.

Project Management

claustre add-project <name> [path]         # Register a project (path defaults to ".")
claustre remove-project <name>             # Remove a project and its data
claustre list-projects                     # List all projects with session/task counts

add-project — Registers a git repository as a claustre project. The path defaults to the current directory if omitted.

remove-project — Removes a project and all its associated tasks and sessions from the database.

list-projects — Shows all registered projects with their task and session counts.

Task Management

claustre add-task <project> <title> [-d description] [-m mode]
claustre list-tasks <project>
claustre export <project> [-o path]

add-task — Creates a new task for a project. Mode can be supervised (default, one task at a time with user interaction) or autonomous (auto-chains the next task from the queue when done).

list-tasks — Lists all tasks for a project with status symbols: ⧖ pending, ● working, ◐ in_review, ✓ done, ✗ error.

export — Exports all tasks and project stats to a JSON file. Defaults to <project>-export.json in the current directory.

Statistics

claustre stats <project>

Shows aggregate statistics for a project: total tasks completed, total sessions, time spent, tokens used, and cost.

Skills (skills.sh)

claustre skills                            # List installed global skills
claustre skills find <query>               # Search the skills.sh registry
claustre skills add <package> [-p project] # Install a skill (globally or per-project)
claustre skills remove <name> [-p project] # Remove a skill
claustre skills update                     # Update all installed skills

Skills are managed via skills.sh, a package registry for Claude Code skills. They extend Claude's capabilities with domain-specific knowledge and tools.

skills (no subcommand) — Lists all globally installed skills.

skills find — Searches the skills.sh registry for packages matching the query.

skills add — Installs a skill package. By default, skills are installed globally. Use -p project to install per-project.

skills remove — Removes an installed skill. Use -p project to remove a per-project skill.

skills update — Updates all installed skills to their latest versions.

The TUI also has a skills panel (press i) for browsing and managing skills interactively.

Internal Commands

claustre also has internal commands used by hooks and the autonomous task runner. These are not meant to be run manually.

session-update — Called by the Stop and UserPromptSubmit hooks to sync session state back to the database. Updates Claude status, detects PRs, records token usage, and handles task status transitions.

feed-next — The autonomous task chain runner. Runs as a blocking loop inside an embedded PTY: picks the next pending autonomous task, launches Claude as a subprocess, waits for completion, then loops to pick up the next task.