CLI Commands Reference

Zen provides 29 CLI commands for knowledge management, agent orchestration, and system administration.

General

CommandDescription
zenLaunch TUI (interactive interface)
zen versionShow version information
zen --helpShow full help with all commands

Workspace & Configuration

CommandDescription
zen workspace initInitialize .zen/ workspace structure
zen config showShow effective configuration (all layers merged)
zen provider listList available LLM providers
zen provider test <name>Test a provider connection
zen auth listList stored credentials

Knowledge Management

CommandDescription
zen note create <title>Create a new note
zen search run <query>Search knowledge base (5 tiers)
zen similar find <id>Find similar notes by vector similarity
zen notion query <entity>Query entity graph
zen wiki listList wiki pages
zen wiki show <id>Show a wiki page
zen wiki reindexReindex wiki pages
zen wiki lintLint wiki (orphan pages, broken wikilinks)
zen wiki distillDistill wiki content
zen ingest <path>Ingest files or RSS feeds
zen brief generateGenerate a brief from recent notes

Agentic Sessions

CommandDescription
zen session startStart an agentic session
zen session listList active sessions
zen session stop <id>Stop a session
zen chatInteractive LLM chat
zen research <topic>Run research task
zen agent listList available agents
zen dispatch run <task>Dispatch a task to agents
zen dispatch status <id>Check task status
zen dispatch listList dispatched tasks
zen dispatch cancel <id>Cancel a task

System

CommandDescription
zen serveStart HTTP gateway daemon
zen logs <service>View structured logs
zen clean <target>Clean up (trash, cache, all)
zen starter <template>Generate project scaffold from template
zen wps <action>Work process utilities

Habit & Goal Tracking

CommandDescription
zen habit logLog a habit entry
zen habit listList habits
zen goal createCreate a goal
zen goal listList goals
zen goal status <id>Check goal progress

Plugin Management

CommandDescription
zen plugin listList installed plugins
zen plugin install <id>Install a plugin
zen plugin remove <id>Remove a plugin

Quick Reference

# Initialize
zen workspace init
zen config show

# Daily workflow
zen note create "Daily Log" --tag journal
zen search run "yesterday's decisions"
zen wiki reindex
zen wiki lint

# Agentic work
zen session start
zen research "Rust async patterns"
zen dispatch run "summarize inbox"

# Maintenance
zen clean cache
zen logs agent

Full reference: zen --help for the most up-to-date list of commands and flags.