pony

Pony

Pony is a task management plugin for Claude Code sessions. It provides file-based task storage with dependency tracking, status transitions, and a real-time HUD (Heads-Up Display) for statusline rendering.

中文文档

Features

• Task Management - Create, track, and manage tasks with priorities, dependencies, and tags
• HUD Statusline - Real-time visualization of session state, task progress, and agent activity
• Agent Routing - Automatic task delegation to specialized agents based on tags
• CLI + Plugin - Use standalone CLI or integrate with Claude Code as a plugin
• Global Storage - All data stored in ~/.pony/ for cross-project access

Installation

As Claude Code Plugin

# Add Pony marketplace
claude plugin marketplace add https://github.com/leowux/pony --scope user

# Install the plugin
claude plugin install pony

As Standalone CLI

# Use directly with npx (no installation required)
npx pony-cli init

# Or install globally
npm install -g pony-cli

Quick Start

# Initialize Pony
pony init

# Create a task
pony add "Implement authentication" -p high -t implement

# List all tasks
pony list

# Get next ready task
pony next

# Update task status
pony update task_20260405_123456_789 -s running

CLI Commands

Task Commands

Command	Description
pony add <title>	Create a new task
pony list	List all tasks with summary
pony get <taskId>	Show task details
pony update <taskId>	Update task properties
pony delete [taskId]	Delete task or bulk delete completed
pony next	Get next task ready to start

Todo Commands

Quick todo lists for simple task tracking:

Command	Description
pony todo <text>	Add a quick todo item
pony todo list	List all todos
pony todo done	Mark todo as completed
pony todo clear	Clear completed todos

System Commands

Command	Description
pony init	Initialize Pony storage
pony hud [action]	Manage HUD statusline
pony logs	View logs with filtering

Task Options

pony add

• -p, --priority <level> - Priority: high, medium, low
• -d, --depends-on <ids> - Dependency task IDs
• -t, --tag <tags> - Tags for agent routing
• -o, --owner <name> - Assign owner
• --desc <text> - Task description
• --project <path> - Project association

pony list

• -s, --status <status> - Filter by status
• -o, --owner <name> - Filter by owner
• -p, --project <name> - Filter by project
• --summary - Show statistics only
• --json - JSON output

pony update

• -s, --status <status> - New status
• -p, --priority <level> - New priority
• -t, --title <title> - New title
• --owner <name> - New owner

Task Status Transitions

From	To
pending	running, cancelled
running	completed, pending, cancelled
completed	pending (reopen)
cancelled	pending (reactivate)

HUD Statusline

Pony provides a two-line HUD for Claude Code statusline:

[Pony] | session: 15m | ctx: 45% | tokens: 50K | agents: 2 | tools: 12 | skills: 1
tasks: 5 total | pending: 2 | running: 1 | completed: 2

Note: The second line (tasks) is hidden when there are no tasks.

Display Elements

Element	Description
session	Session duration with color gradient
ctx	Context window usage percentage
tokens	Input/output token consumption
agents	Active agent count
tools	Tool call count
skills	Skill invocation count
tasks	Task status summary (line 2)

Color Gradients