✓ Verified 💻 Development ✓ Enhanced Data

Tick Md

Coordinate work across human and AI agents using structured Markdown files.

Rating
3.9 (227 reviews)
Downloads
1,269 downloads
Version
1.0.0

Overview

Coordinate work across human and AI agents using structured Markdown files.

Complete Documentation

View Source →

Tick Multi-Agent Coordination

Coordinate work across human and AI agents using structured Markdown files. Users interact naturally with you, and you maintain tasks transparently in TICK.md.

Installation

Prerequisites: The Tick CLI and MCP server should already be installed and configured by your environment.

First time setup? See INSTALL.md for editor-specific installation instructions.

Safety Boundaries

  • Ask for explicit user approval before editing editor MCP config files.
  • Ask for explicit user approval before running any command that pushes to remote git (tick sync --push or git push).
  • If user approval is not explicit, use read-only/status commands and explain what write action is pending.
Quick Check:
bash
# Verify CLI is available
tick --version

# Check if TICK.md exists in project
ls TICK.md

# If not, initialize
tick init

Core Concept

Tick Protocol = Git-based task coordination via TICK.md files

  • Human-readable: Standard Markdown with YAML
  • Machine-parseable: Structured for tools
  • Git-backed: Full version control and audit trail
  • Local-first: No cloud required

Quick Start

Check if Tick is initialized

bash
ls TICK.md

If not initialized

bash
tick init

Get current status

bash
tick status

Common Workflows

1. User Asks You to Do Something

User: "Can you refactor the authentication system?"

Your Actions:

bash
# 1. Create task
tick add "Refactor authentication system" --priority high --tags backend,security

# 2. Register yourself (first time only)
tick agent register @your-name --type bot --roles "engineer,refactoring"

# 3. Claim the task
tick claim TASK-XXX @your-name

# 4. Work on it (do the actual work)

# 5. Add progress comments
tick comment TASK-XXX @your-name --note "Analyzing current auth flow"
tick comment TASK-XXX @your-name --note "Refactored to use JWT tokens"

# 6. Mark complete
tick done TASK-XXX @your-name

2. User Asks About Project Status

User: "What tasks are we working on?"

bash
# Get comprehensive status
tick status

# Or filter and list tasks
tick list --status in_progress
tick list --claimed-by @bot-name

Summarize the output naturally for the user.

3. Coordination with Other Agents

User: "Have the other agents finished their tasks?"

bash
# Check overall status
tick status

# List agents and their work
tick agent list --verbose

# Validate the project
tick validate

4. Breaking Down Complex Work

User: "Build a user dashboard with charts and data export"

Your Actions:

bash
# Create parent task
tick add "Build user dashboard" --priority high --tags frontend

# Create subtasks with dependencies
tick add "Design dashboard layout" --priority high --tags frontend,design
tick add "Implement data charts" --priority medium --tags frontend,charts --depends-on TASK-XXX
tick add "Add CSV export" --priority low --tags frontend,export --depends-on TASK-XXX

# Visualize dependencies
tick graph

Command Reference

Project Management

bash
tick init                          # Initialize new project
tick status                        # View project overview
tick list                          # List tasks with filters
tick graph                         # Visualize dependencies
tick watch                         # Monitor changes in real-time
tick validate                      # Check for errors
tick sync --pull                   # Pull latest changes
# tick sync --push                 # Only with explicit user approval

Task Operations

bash
tick add "Task title" \
  --priority high \                # urgent|high|medium|low
  --tags backend,api \             # Comma-separated tags
  --assigned-to @agent \           # Assign to agent
  --depends-on TASK-001 \          # Dependencies
  --estimated-hours 4              # Time estimate

tick claim TASK-001 @agent         # Claim task (sets in_progress)
tick release TASK-001 @agent       # Release task (back to todo)
tick done TASK-001 @agent          # Complete task
tick reopen TASK-001 @agent        # Reopen completed task
tick delete TASK-001               # Delete a task
tick comment TASK-001 @agent \     # Add note
  --note "Progress update"
tick edit TASK-001 \               # Direct field edit
  --title "New title" \
  --priority high \
  --status in_progress

Corrections & Recovery

bash
tick reopen TASK-001 @agent        # Reopen completed task
tick reopen TASK-001 @agent \      # Reopen and re-block dependents
  --re-block

tick delete TASK-001               # Delete task, cleans up deps
tick delete TASK-001 --force       # Delete even if has dependents

tick edit TASK-001 --title "X"     # Change title
tick edit TASK-001 --priority high # Change priority
tick edit TASK-001 --status todo   # Change status directly
tick edit TASK-001 --tags a,b,c    # Replace tags
tick edit TASK-001 --add-tag new   # Add tag
tick edit TASK-001 --remove-tag old # Remove tag
tick edit TASK-001 \               # Edit dependencies
  --depends-on TASK-002,TASK-003

tick undo                          # Undo last tick operation
tick undo --dry-run                # Preview what would be undone

Bulk Operations

bash
tick import tasks.yaml             # Import tasks from YAML file
tick import - < tasks.yaml         # Import from stdin
tick import tasks.yaml --dry-run   # Preview import

tick batch start                   # Begin batch mode (no auto-commit)
tick batch status                  # Check batch status
tick batch commit                  # Commit all batched changes
tick batch abort                   # Discard batched changes

Advanced Task Listing

bash
tick list                          # All tasks, grouped by status
tick list --status blocked         # Only blocked tasks
tick list --priority urgent        # High-priority tasks
tick list --assigned-to @alice     # Tasks for specific agent
tick list --tag backend            # Tasks with tag
tick list --json                   # JSON output for scripts

Dependency Visualization

bash
tick graph                         # ASCII dependency tree
tick graph --format mermaid        # Mermaid flowchart
tick graph --show-done             # Include completed tasks

Real-time Monitoring

bash
tick watch                         # Watch for changes
tick watch --interval 10           # Custom polling interval
tick watch --filter in_progress    # Only show specific status

Agent Management

bash
tick agent register @name \        # Register new agent
  --type bot \                     # human|bot
  --roles "dev,qa" \               # Comma-separated roles
  --status idle                    # working|idle|offline

tick agent list                    # List all agents
tick agent list --verbose          # Detailed info
tick agent list --type bot         # Filter by type
tick agent list --status working   # Filter by status

MCP Tools (Alternative to CLI)

If using Model Context Protocol, use these tools instead of CLI commands:

Status and Inspection

  • tick_status - Get project status (agents, tasks, progress)
  • tick_validate - Validate TICK.md structure
  • tick_agent_list - List agents with optional filters

Task Management

  • tick_add - Create new task
  • tick_claim - Claim task for agent
  • tick_release - Release claimed task
  • tick_done - Complete task (auto-unblocks dependents)
  • tick_comment - Add note to task

Corrections & Recovery

  • tick_reopen - Reopen completed task
  • tick_delete - Delete a task
  • tick_edit - Direct field edit (bypasses state machine)
  • tick_undo - Undo last tick operation

Agent Operations

  • tick_agent_register - Register new agent
MCP Example:
javascript
// Create task via MCP
await tick_add({
  title: "Refactor authentication",
  priority: "high",
  tags: ["backend", "security"],
  assignedTo: "@bot-name"
})

// Claim it
await tick_claim({
  taskId: "TASK-023",
  agent: "@bot-name"
})

Best Practices

1. Natural Conversation First

✅ Good: User says "refactor the auth", you create task automatically ❌ Bad: Making user explicitly create tasks

2. Always Use Your Agent Name

Register once:

bash
tick agent register @your-bot-name --type bot --roles "engineer"

Then use consistently:

bash
tick claim TASK-001 @your-bot-name
tick done TASK-001 @your-bot-name

3. Provide Context in Comments

bash
# ✅ Good - explains what and why
tick comment TASK-005 @bot --note "Switched from REST to GraphQL for better type safety and reduced over-fetching"

# ❌ Bad - too vague
tick comment TASK-005 @bot --note "Updated API"

4. Break Down Large Tasks

Create subtasks with dependencies:

bash
tick add "Set up CI/CD pipeline" --priority high
tick add "Configure GitHub Actions" --depends-on TASK-010
tick add "Add deployment scripts" --depends-on TASK-011
tick add "Set up staging environment" --depends-on TASK-011

5. Check Status Before Claiming

bash
# Make sure task exists and isn't claimed
tick status

# Then claim
tick claim TASK-XXX @your-name

Understanding TICK.md Structure

The file has three sections:

  • Frontmatter (YAML): Project metadata
  • Agents Table (Markdown): Who's working on what
  • Task Blocks (YAML + Markdown): Individual tasks with history
Example:
markdown
---
project: my-app
schema_version: "1.0"
next_id: 5
---

# Agents

| Name | Type | Roles | Status | Working On |
|------|------|-------|--------|------------|
| @alice | human | owner | working | TASK-003 |
| @bot | bot | engineer | idle | - |

# Tasks

\
yaml id: TASK-001 title: Build authentication status: done priority: high claimed_by: null

... more fields

history:
  • ts: 2026-02-07T10:00:00Z
who: @bot action: created
  • ts: 2026-02-07T14:00:00Z
who: @bot action: done \
text
Implemented JWT-based authentication with token refresh...

Advanced Features

Automatic Dependency Unblocking

When you complete a task, dependent tasks automatically unblock:

bash
# TASK-002 depends on TASK-001
# TASK-002 status: blocked

tick done TASK-001 @bot
# TASK-002 automatically changes to: todo

Circular Dependency Detection

Validation catches circular dependencies:

bash
tick validate
# Error: Circular dependency detected: TASK-001 → TASK-002 → TASK-003 → TASK-001

Smart Commit Messages

bash
# Only run with explicit user approval
tick sync --push
# Automatically generates: "feat: complete TASK-001, TASK-002; update TASK-003"

Reopening Completed Tasks

If a task was marked done prematurely:

bash
tick reopen TASK-001 @bot
# Sets status back to in_progress, records in history

tick reopen TASK-001 @bot --re-block
# Also re-blocks any tasks that depend on this one

Fixing Mistakes

bash
# Undo the last tick operation
tick undo

# Preview what would be undone first
tick undo --dry-run

# Direct field edits (bypasses state machine)
tick edit TASK-001 --status todo --priority urgent

Batch Operations

For multiple changes without individual commits:

bash
tick batch start
# Now make multiple changes...
tick add "Task 1" --priority high
tick add "Task 2" --priority medium
tick claim TASK-001 @bot
# ...
tick batch commit   # Single commit for all changes
# Or: tick batch abort  # Discard all changes

Real-time Monitoring

bash
tick watch
# [10:23:45] ✓ Added: TASK-015 - Implement user search
# [10:24:12] 🔒 TASK-015 claimed by @bot
# [10:26:33] ⟳ TASK-015: in_progress → done

Quick Reference Card

text
Workflow:      init → add → claim → work → comment → done → sync
Essential:     status | add | claim | done | list | graph
Corrections:   reopen | delete | edit | undo
Bulk:          import | batch start/commit/abort
Coordination:  agent register | agent list | validate | watch
Git:           sync --pull | sync --push (explicit user approval required)

Key Reminders

  • Users interact with YOU, not with Tick directly
  • YOU maintain the TICK.md transparently
  • Dashboard is for inspection, not primary interaction
  • Always use your agent name consistently
  • Comment frequently to show progress
  • Validate before syncing
  • Check status before claiming
  • Break down complex work into subtasks

Resources

  • GitHub: https://github.com/your-org/tick-md
  • Documentation: https://tick-md.dev/docs
  • CLI npm: https://npmjs.com/package/tick-md
  • MCP Server npm: https://npmjs.com/package/tick-mcp-server

License

MIT

Installation

Terminal bash 

openclaw install tick-md
Copied!

💻Code Examples

**Quick Check**:

quick-check.sh
# Verify CLI is available
tick --version

# Check if TICK.md exists in project
ls TICK.md

# If not, initialize
tick init

**Your Actions**:

your-actions.sh
# 1. Create task
tick add "Refactor authentication system" --priority high --tags backend,security

# 2. Register yourself (first time only)
tick agent register @your-name --type bot --roles "engineer,refactoring"

# 3. Claim the task
tick claim TASK-XXX @your-name

# 4. Work on it (do the actual work)

# 5. Add progress comments
tick comment TASK-XXX @your-name --note "Analyzing current auth flow"
tick comment TASK-XXX @your-name --note "Refactored to use JWT tokens"

# 6. Mark complete
tick done TASK-XXX @your-name

tick list --claimed-by @bot-name

tick-list---claimed-by-bot-name.txt
Summarize the output naturally for the user.

### 3. Coordination with Other Agents

**User**: "Have the other agents finished their tasks?"

tick validate

tick-validate.txt
### 4. Breaking Down Complex Work

**User**: "Build a user dashboard with charts and data export"

**Your Actions**:

tick graph

tick-graph.txt
## Command Reference

### Project Management

tick agent list --status working # Filter by status

tick-agent-list---status-working--filter-by-status.txt
## MCP Tools (Alternative to CLI)

If using Model Context Protocol, use these tools instead of CLI commands:

### Status and Inspection
- `tick_status` - Get project status (agents, tasks, progress)
- `tick_validate` - Validate TICK.md structure
- `tick_agent_list` - List agents with optional filters

### Task Management
- `tick_add` - Create new task
- `tick_claim` - Claim task for agent
- `tick_release` - Release claimed task
- `tick_done` - Complete task (auto-unblocks dependents)
- `tick_comment` - Add note to task

### Corrections & Recovery
- `tick_reopen` - Reopen completed task
- `tick_delete` - Delete a task
- `tick_edit` - Direct field edit (bypasses state machine)
- `tick_undo` - Undo last tick operation

### Agent Operations
- `tick_agent_register` - Register new agent

**MCP Example**:

})

.txt
## Best Practices

### 1. Natural Conversation First

✅ **Good**: User says "refactor the auth", you create task automatically
❌ **Bad**: Making user explicitly create tasks

### 2. Always Use Your Agent Name

Register once:

tick comment TASK-005 @bot --note "Updated API"

tick-comment-task-005-bot---note-updated-api.txt
### 4. Break Down Large Tasks

Create subtasks with dependencies:

tick claim TASK-XXX @your-name

tick-claim-task-xxx-your-name.txt
## Understanding TICK.md Structure

The file has three sections:

1. **Frontmatter** (YAML): Project metadata
2. **Agents Table** (Markdown): Who's working on what
3. **Task Blocks** (YAML + Markdown): Individual tasks with history

**Example**:

Implemented JWT-based authentication with token refresh...

implemented-jwt-based-authentication-with-token-refresh.txt
## Advanced Features

### Automatic Dependency Unblocking

When you complete a task, dependent tasks automatically unblock:

Tags

#web_and-frontend-development

Quick Info

Category Development
Model Claude 3.5
Complexity Multi-Agent
Author gianni-dalerta
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install tick-md

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Acestep Lyrics Transcription

Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.

⚡ GPT-Optimized #ai_and-llms #api #script
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0