tick-md

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.