CLI Reference

Conversation and execution

tokendance                              # Start interactive session
tokendance run "summarize this repo"    # One-shot, non-interactive

Command	What it does
tokendance	Launch the full interactive terminal with slash commands and context management
tokendance run "<prompt>"	Submit a single prompt and get the result — ideal for scripts and automation

Diagnostics and config

tokendance doctor --json               # Check API keys, permissions, status
tokendance config validate --json      # Validate configuration files

Command	What it does
tokendance doctor	Diagnose environment health: API key presence, permission config, system compatibility
tokendance config validate	Validate format and values of config files under ~/.config/tokendance/
tokendance config path	Print the full path to the active config file

Sessions and transcripts

tokendance sessions                      # List past sessions
tokendance transcript search "needle"    # Search conversation history
tokendance resume <session-id>           # Resume a saved session

Command	What it does
tokendance sessions	List all past conversation sessions with summaries
tokendance transcript search "<query>"	Search all JSONL transcripts for a keyword
tokendance transcript export <id>	Export the full conversation record for a session
tokendance resume <id>	Resume an unfinished session with its previous context intact
tokendance context	Inspect current session context usage
tokendance compact	Compact context to free token space

Workflow commands

Command	What it does
tokendance diff	Show changes in the working directory since last commit
tokendance review	Run a code review on the current diff
tokendance quality "<cmd>"	Run a quality check command and collect results
tokendance tasks	Manage the task list for the current session
tokendance todo	Manage to-do items for the current session
tokendance tools	List available tools and their permission status
tokendance worktree	Manage isolated Git workspaces
tokendance agents	Manage sub-agent configuration and status
tokendance memory	Manage persistent cross-session memory

All commands support --json output for consumption by AgentHub, scripts, and diagnostic panels.

Edit this page on GitHub