Is this tool intended for humans or AI agents?

It is designed for both. The minimal CLI interface is easy for AI agents to navigate, while the markdown format and simple commands make it perfect for developers who want to avoid heavy project management software.

Can Claude Code manage task dependencies with this skill?

Yes, the skill includes commands like 'tk dep add' and 'tk dep tree' to define and visualize relationships between tasks, ensuring the AI agent works on the right priorities.

How are the tickets stored?

Tickets are stored as individual markdown files in a .tickets/ directory at the root of your project. Each file includes YAML frontmatter for metadata, making them human-readable and Git-friendly.

Can I export ticket data for other tools?

Yes, the 'tk query' command outputs your ticket data in JSON format, which can be piped into jq or other scripts for custom reporting or integration.

How do I find tickets that are ready for work?

You can use the 'tk ready' command, which specifically filters for open tickets that have no unresolved dependencies, allowing for an immediate start on actionable items.

Git-Backed Ticket Management

Name: Git-Backed Ticket Management
Author: radutopala

byradutopala

•

生産性とワークフロー

Manages software development tasks directly within your repository using a Git-friendly, markdown-based ticket system designed for AI agents.

tk provides a lightweight, CLI-driven ticket management system that stores all project data as markdown files with YAML frontmatter inside a .tickets/ directory. Designed specifically for AI agents and developers who prefer staying in the terminal, it enables seamless task tracking, status updates, and dependency management without the overhead of external SaaS platforms. Because all tickets reside in the repository, they are versioned alongside your code, ensuring that project state and task history are always in sync with your codebase.

主な機能

01Advanced dependency tracking with tree visualization and cycle checking

021 GitHub stars

03Markdown-based ticket storage with Git-compatible YAML frontmatter

04Robust filtering by status, assignee, priority, and custom tags

05JSON export capabilities for easy integration with automation scripts

06Complete CLI workflow for creating, claiming, and closing tasks

ユースケース

01Enforcing task order by managing complex software dependencies directly via CLI

02Structuring and assigning specific sub-tasks for AI coding agents to complete autonomously

03Maintaining a local-first bug tracker and feature roadmap within private repositories

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add radutopala/ticket tk

For use in Claude.ai and ChatGPT

Download Skill