OpenClaw

---
name: ticket_rs
description: Dependency-aware issue tracking with tk (ticket-rs). Issues stored as Markdown in .tickets/.
metadata:
  openclaw:
    requires:
      bins: [tk]
---

# Issue Tracking with tk

This project uses **tk (ticket-rs)** for dependency-aware issue tracking.
Issues are stored as Markdown files in `.tickets/`.

## Quick Commands

- `tk triage` - AI-powered recommendations and project health
- `tk ready` - Find issues with no blockers
- `tk next` - Single top recommendation
- `tk create "Title" -t task -p 2` - Create issue
- `tk show <id>` - View issue details
- `tk close <id>` - Complete work
- `tk dep add <blocked> <blocker>` - Add dependency
- `tk dep tree <id>` - Visualize dependencies

## Issue Format

Issues are Markdown files with YAML frontmatter:

```markdown
---
status: open
type: feature
priority: 1
deps: [tk-abc123]
labels: [backend]
---
# Issue Title

Description here.
```

## Status Values

- `open` - Ready to be worked on
- `in_progress` - Currently being worked on
- `blocked` - Waiting on dependencies
- `closed` - Completed

## Priority Levels

- P0 (0) - Critical
- P1 (1) - High
- P2 (2) - Medium (default)
- P3 (3) - Low
- P4 (4) - Lowest

## Workflow

1. Start session: `tk triage` for AI recommendations
2. Find work: `tk ready` for unblocked issues
3. Claim work: `tk claim <id>` before starting
4. Complete work: `tk resolve <id>` to close and see unblocked issues

{
  "skills": {
    "ticket_rs": {
      "enabled": true,
      "settings": {
        "heartbeat": "0 9 * * 1-5"  // Weekday mornings at 9am
      }
    }
  }
}

// In ~/.openclaw/openclaw.json
{
  "skills": {
    "ticket_mcp": {
      "enabled": true,
      "mcp": {
        "command": "uvx",
        "args": ["ticket-mcp"]
      }
    }
  }
}

tk create "Fix payment timeout" -t bug -p 1