Purple-Horizons/tick-md

TICK.md

Coordination multi-agent de tâches via Markdown et Git

Coordonnez le travail entre humains et agents IA en utilisant des fichiers TICK.md structurés. Construit sur Git, conçu pour l'interaction en langage naturel, optimisé pour les flux de travail multi-agents.

✨ Fonctionnalités

• 🤖 IA-Natif : Serveur MCP pour une intégration transparente des bots
• 📝 Lisible par les humains : Markdown simple avec frontmatter YAML
• 🔄 Sauvegardé par Git : Contrôle de version complet et piste d'audit automatique
• 🎯 Suivi des dépendances : Déblocage automatique des tâches
• 🔒 Verrouillage de fichiers : Empêche les conflits d'édition simultanée
• 🔍 Filtrage avancé : Trouvez des tâches par statut, priorité, tags
• 📊 Visualisation : Graphes de dépendances (ASCII et Mermaid)
• 👀 Surveillance en temps réel : Mode watch pour des mises à jour en direct
• 🌐 Local d'abord : Pas de cloud nécessaire, fonctionne hors ligne

🚀 Prise en main rapide

Installer le CLI

npm install -g tick-md

Initialiser un projet

cd your-project
tick init
tick status

Créer et revendiquer des tâches

tick add "Build authentication" --priority high --tags backend
tick claim TASK-001 @yourname
tick done TASK-001 @yourname

🤖 Pour les agents IA

Installer le serveur MCP

npm install -g tick-mcp-server

Ajoutez à votre configuration MCP (par exemple, ~/Library/Application Support/Claude/claude_desktop_config.json) :

{
  "mcpServers": {
    "tick": {
      "command": "tick-mcp",
      "args": [],
      "env": {}
    }
  }
}

Utiliser les outils MCP

Le serveur MCP expose toutes les commandes CLI en tant qu'outils :

• tick_init - Initialiser un projet
• tick_add - Créer des tâches
• tick_claim - Revendiquer des tâches pour votre agent
• tick_done - Marquer les tâches comme terminées
• tick_status - Obtenir un aperçu du projet
• tick_list - Interroger et filtrer les tâches
• tick_comment - Ajouter des notes de progression

🎯 Concepts clés

Structure du fichier TICK.md

---
meta:
  project_id: my-project
  id_prefix: TASK
  next_id: 4
  updated: 2026-02-07T15:30:00-05:00
---

### TASK-001 · Build user authentication

```yaml
id: TASK-001
status: in_progress
priority: high
claimed_by: @claude-code
assigned_to: @claude-code
created_by: @gianni
created_at: 2026-02-07T10:00:00-05:00
updated_at: 2026-02-07T15:30:00-05:00
tags: [backend, auth]
depends_on: []
blocks: [TASK-002, TASK-003]
history:
  - ts: 2026-02-07T10:00:00  who: @gianni       action: created
  - ts: 2026-02-07T15:30:00  who: @claude-code  action: claimed

Build JWT-based authentication with refresh tokens

### Commits Git automatiques

Par défaut, chaque mutation crée un commit git :

```bash
[tick] TASK-001 claimed by @claude-code
[tick] TASK-001 completed by @claude-code
[tick] TASK-003: created

Contrôlez avec les flags :

• --commit - Forcer le commit
• --no-commit - Sauter le commit
• Ou configurez dans .tick/config.yml

États des tâches

• backlog - Pas prêt à commencer
• todo - Prêt à être revendiqué
• in_progress - En cours de travail
• review - En attente de révision
• blocked - En attente de dépendances
• done - Terminé

Verrouillage de fichiers

Le CLI utilise .tick.lock pour empêcher les modifications simultanées. Lorsqu'un agent revendique une tâche, il acquiert le verrou. Les autres agents voient que la tâche est revendiquée et ne peuvent pas la modifier.

📚 Documentation

• Spécification du protocole : https://tick.md/docs/protocol
• Référence CLI : https://tick.md/docs/cli
• Guide de démarrage : https://tick.md/docs/getting-started

💡 Exemple de flux de travail

# L'humain crée des tâches
tick add "Build landing page" --priority high --tags frontend --assign @claude-code
tick add "Write launch email" --priority medium --tags content --assign @content-bot
tick add "E2E tests" --priority medium --tags qa --depends-on TASK-001

# L'agent IA prend le travail
tick claim TASK-001 @claude-code
tick comment TASK-001 @claude-code --note "Built responsive landing with hero section"
tick done TASK-001 @claude-code

# Un autre agent se déclenche automatiquement
tick claim TASK-003 @qa-bot
tick done TASK-003 @qa-bot --skip-review

🔧 Configuration

Modifiez .tick/config.yml :

git:
  auto_commit: true      # Auto-commit lors des mutations (par défaut : true)
  commit_prefix: "[tick]"
  push_on_sync: false

locking:
  enabled: true
  timeout: 300

agents:
  default_trust: full
  require_registration: false

🌟 Meilleures pratiques pour les bots OpenClaw

1. Revendiquez toujours avant de travailler : tick claim TASK-XXX @yourbotname
2. Ajoutez des commentaires de progression : tick comment TASK-XXX @yourbotname --note "Status update"
3. Marquez comme terminé quand c'est fini : tick done TASK-XXX @yourbotname
4. Vérifiez les dépendances : Utilisez tick list --blocked pour trouver les tâches bloquées
5. Utilisez le serveur MCP : Permet une gestion des tâches en langage naturel

🔧 Configuration multi-agent OpenClaw

Guide étape par étape pour coordonner plusieurs bots OpenClaw via TICK.md.

1. Créer un dépôt de tâches partagé

gh repo create yourorg/project-tasks --private
cd project-tasks
npx tick-md init
git add -A && git commit -m "init" && git push

2. Sur le serveur de chaque bot OpenClaw

cd /data/.openclaw/workspace
git clone [email protected]:yourorg/project-tasks.git tasks
cd tasks && npx tick-md status

3. Ajouter à AGENTS.md de chaque bot

## ✅ Task Coordination (TICK.md)

I coordinate with other agents via TICK.md in `./tasks/`.

### Before starting work:
1. `cd tasks && npx tick-md sync` — get latest
2. `npx tick-md list --status backlog --priority high` — find available work
3. `npx tick-md claim TASK-XXX @mybotname` — claim before working
4. `npx tick-md done TASK-XXX @mybotname` — mark complete

### Rules:
- **Never work on a task claimed by another agent**
- **Always claim before starting**
- **Sync before and after work**

4. Ajouter à HEARTBEAT.md de chaque bot

## Task Sync (TICK.md)

- [ ] Sync tasks: `cd tasks && npx tick-md sync`
- [ ] Check for my work: `npx tick-md list --claimed-by @mybotname --status in_progress`
- [ ] Check for available tasks: `npx tick-md list --status backlog --priority high`

5. Clés de déploiement

Chaque bot a besoin d'un accès SSH au dépôt partagé. Générez une clé de déploiement sur chaque serveur :

ssh-keygen -t ed25519 -C "botname@tasks" -f ~/.ssh/tasks_deploy -N ""
cat ~/.ssh/tasks_deploy.pub
# Add this to repo Settings → Deploy Keys (with write access)

Configurez git pour l'utiliser :

cd tasks
git config core.sshCommand "ssh -i ~/.ssh/tasks_deploy -o IdentitiesOnly=yes"

6. Commande de synchronisation pour les bots

Après toute mutation tick, poussez les changements :

cd tasks && git push

Ou utilisez tick sync qui gère pull + push automatiquement.

📦 Informations sur le paquet

• CLI : tick-md sur npm
• Serveur MCP : tick-mcp-server sur npm
• GitHub : https://github.com/Purple-Horizons/tick-md
• Licence : MIT

🆘 Assistance

• Problèmes GitHub : https://github.com/Purple-Horizons/tick-md/issues
• Sponsor : https://github.com/sponsors/Purple-Horizons