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.