tick-md

Coordinate multi-agent task claims and dependencies in a Git-backed TICK.md file.

30|3|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/Purple-Horizons/tick-md --skill tick-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tick-md
Source: https://github.com/Purple-Horizons/tick-md/tree/main
Command: npx skills add https://github.com/Purple-Horizons/tick-md --skill tick-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinate work across humans and AI agents in a single, Git-backed Markdown file so tasks, claims, and history remain human-readable, machine-parseable, and versioned—preventing collisions and preserving an auditable trail of changes.

Core Features & Use Cases

  • Shared single source of truth: Tasks live in a TICK.md file with YAML frontmatter, an agents table, and per-task YAML blocks so both people and bots can read and write consistently.
  • Agent coordination & locking: Advisory locking and claim/release semantics let bots claim work safely and avoid duplicate effort.
  • Dependency tracking & automation: Dependency fields, automatic unblocking on completion, visualization via ASCII/Mermaid graphs, and validation (including circular dependency detection) support complex workflows.
  • MCP + CLI interfaces: Full CLI for humans and an MCP server exposing programmatic tools for AI agents (tick_add, tick_claim, tick_done, tick_status, etc.), plus packaging for ClawHub/OpenClaw.
  • Git-native audit trail: Mutations create commits with configurable auto-commit behavior so history and rollbacks are trivial.

Quick Start

Initialize a Tick project with the CLI to create a TICK.md file, register your agent, then add, claim, and complete tasks to coordinate work across humans and bots.

Frequently Asked Questions about tick-md

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate tasks and prevent collisions between human developers and AI agents?

Multi-agent task coordination and collision prevention are achieved by managing claims and advisory locking within a shared Git-backed Markdown file, ensuring both humans and bots can safely work on tasks without overlapping.

Can I track task dependencies and visualize them in a local-first workflow?

Task dependency tracking and visualization are supported through YAML frontmatter fields and automatic ASCII or Mermaid graph generation, helping developers map complex workflows and detect circular dependencies.

How does Git-backed task management create an audit trail for AI agents?

Git-backed task management creates an audit trail by automatically committing changes to the shared Markdown file upon mutations, providing a versioned history that makes rollbacks and change tracking trivial.

Does multi-agent task coordination work with both CLI and MCP tool interfaces?

Multi-agent task coordination supports both a full CLI for human developers and an MCP server exposing programmatic tools for AI agents, allowing seamless interaction with the shared task file.

What is the best way to manage shared tasks in a single Markdown file for both humans and bots?

Managing shared tasks in a single Markdown file uses YAML frontmatter, an agents table, and per-task blocks so data remains human-readable and machine-parseable for consistent read and write operations.

Do I need Node.js to run Git-backed Markdown task coordination?

Git-backed Markdown task coordination requires a Node.js environment version 18 or higher to initialize projects, register agents, and execute task management operations via the CLI or MCP server.