Reference
CLI Reference
This page reflects the actual command surface in cli/src/cli.ts. Use tick --help and tick <command> --help for full option details.
Install
npm install -g tick-md
tick --version
Core Commands
| Command | Description |
|---|
tick init | Initialize a new Tick project. |
tick status | Show project overview and task summary. |
tick add <title> | Create a task. |
tick claim [task-id] [agent] | Claim a task. |
tick release <task-id> <agent> | Release a task claim. |
tick done [task-id] [agent] | Mark task done. |
tick comment <task-id> <agent> | Add a history note. |
tick reopen <task-id> <agent> | Reopen a task. |
tick delete <task-id> | Delete a task. |
tick edit <task-id> <agent> | Edit task fields directly. |
Query and Visualization
| Command | Description |
|---|
tick list | List and filter tasks. |
tick graph | Render dependency graph (ASCII/Mermaid). |
tick watch | Watch TICK.md for live updates. |
tick validate | Validate TICK.md structure and references. |
tick repair | Attempt automated repair for common issues. |
tick conflicts | Inspect conflict state. |
tick compact | Compact task history. |
tick history-stats | Show history/compaction stats. |
Sync and Recovery
| Command | Description |
|---|
tick sync | Stage/commit/push Tick changes via git. |
tick import [file] | Import tasks from YAML. |
tick undo | Undo last Tick commit. |
tick batch start|commit|abort|status | Batch multiple operations. |
Agents
| Command | Description |
|---|
tick agent register <name> | Register an agent. |
tick agent list | List registered agents. |
Messaging and Notifications
| Command | Description |
|---|
tick broadcast <agent> <message> | Broadcast a message. |
tick broadcasts | List broadcasts. |
tick notify send <event> <message> | Send webhook notification. |
tick notify list | List webhook targets. |
tick notify test <webhook-name> | Test webhook delivery. |
tick notify queue status|list|clear|retry|remove <id> | Manage webhook retry queue. |
Archive and Backups
| Command | Description |
|---|
tick archive | Archive completed tasks. |
tick archived | List archived tasks. |
tick backup list|create|restore|show|clean | Backup management. |
tick completion <shell> | Generate shell completion script. |
Quick Workflow
tick init
tick agent register @you
tick add "Implement feature X" --priority high
tick claim TASK-001 @you
tick comment TASK-001 @you --note "Halfway done"
tick done TASK-001 @you
tick validate
tick sync --push