td

td is a skill for Claude Code, Codex from espennilsen/pi. It costs 44 tokens per session (1,864 once invoked), scanned A, original, MIT.

A local command-line task manager for coding work, including issues, sessions, progress logs, handoffs, dependencies, and boards. A handoff is a written summary that lets another person or agent continue the work.

In plain words
What is it for?
Use it to start and prioritize issues, track progress, record decisions and blockers, manage dependencies, and prepare handoffs.
Why use it?
It keeps priorities, decisions, blockers, and unfinished work in one place. This reduces lost context when work moves between sessions or people.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/espennilsen/pi/td
Any agent
npx skills add espennilsen/pi --skill td
Clone the repo
git clone --depth 1 https://github.com/espennilsen/pi

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for td

README.md
[![agentmods](https://agentmods.dev/badge/skills/espennilsen/pi/td.svg)](https://agentmods.dev/skills/espennilsen/pi/td)
Your own site
<a href="https://agentmods.dev/skills/espennilsen/pi/td"><img src="https://agentmods.dev/badge/skills/espennilsen/pi/td.svg" alt="Measured on agentmods" height="20"></a>
Per session 44 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,864 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00044 $0.01864
Opus 5 $0.00022 $0.00932
Sonnet 5 $0.00009 $0.00373
Haiku 4.5 $0.00004 $0.00186

Measured 4d ago against content hash 333f1eb0b820, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

td scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/td/SKILL.md · 223 lines

How it starts

The opening of the file, as written. The whole thing — 223 lines — stays where its author put it; the contents beside it link to each section on GitHub.

td — Task & Session Management

td is a local-first task management CLI optimized for AI-assisted development workflows. It tracks issues, sessions, structured handoffs, and progress logs.

Session Workflow

Every session follows this pattern:

  1. Start — Load context and begin a new session:

    td usage --new-session    # Full context dump (issues, logs, handoffs)
    td status                 # Quick dashboard: focus, reviews, blocked, ready
    
  2. Pick work — Find what to work on:

    td next                   # Highest-priority open issue
    td ready                  # All open issues sorted by priority
    td list --mine            # Issues assigned to current session
    
  3. Start an issue — Set focus and mark in-progress:

    td start <issue-id>       # Sets focus + status to in_progress
    
  4. Log progress — Track decisions, blockers, attempts:

    td log "Implemented auth middleware"              # Progress (default)
    td log --blocker "Waiting on API key from team"   # Blocker
    td log --decision "Using JWT over session tokens"  # Decision
    td log --tried "Attempted Redis caching"           # Attempted approach
    td log --result "Redis too complex, using in-memory" # Result
    td log --hypothesis "Rate limiting might fix 429s"   # Hypothesis
    
  5. Handoff — Capture structured state before ending session:

    td handoff <issue-id> \
      --done "Implemented login endpoint" \
      --done "Added JWT validation" \
      --remaining "Add refresh token flow" \
      --remaining "Write tests for auth middleware" \
      --decision "Using RS256 for JWT signing" \
      --uncertain "Should we support OAuth2 providers?"
    
  6. Submit for review — When work is complete:

    td review <issue-id>      # Submit for review (preferred)
    
  7. Review — Different session approves or rejects:

    td reviewable             # What can I review?
    td approve <issue-id>     # Ship it → closed
    td reject <issue-id> --reason "Need tests"  # Back to in_progress
    

Read the full file on GitHub · 223 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 223 lines · 44 tokens per session scan A 333f1eb0b820

Subscribe to this mod's changes

td is a skill published in the GitHub repository espennilsen/pi (117 stars, last pushed 11d ago), licensed MIT. It adds 44 tokens to every session and 1,864 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

wayfinder

Plan a huge chunk of work (more than one agent session can hold) as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.

mattpocock/skills · 46 tokens

sap-transport-overview

System-wide inventory of open transport requests — every visible modifiable request, who owns it, how big it is, and supported risk signals such as empty/local requests, explicit locks, and confirmed manifest overlaps. Headers-only and cheap; NO source diffs. Use when asked "what transports are open in the system"…

arc-mcp/arc-1 · 106 tokens

timeline-creator

Create HTML timelines and project roadmaps with Gantt charts, milestones, phase groupings, and progress indicators. Use when users request timelines, roadmaps, Gantt charts, project schedules, or milestone visualizations.

mhattingpete/claude-skills-marketplace · 47 tokens

pm-all

Skill "pm-all" from wei63w/pm-manager, covering user input, outline and shared workflow (all /pm- commands).

wei63w/pm-manager · 8 tokens

bootstrap-prd

Set up PRD-driven development infrastructure for a new project, including directory structure, templates, and roadmap.

joshukraine/dotfiles · 25 tokens

finn-spec

Interview the user about a raw idea until confident, then file a build-ready issue in Linear. Use when asked to run Finn-loop's spec interview, draft a queue-ready issue, or plan a feature. Interactive — requires the user present; never run unattended.

finna/Finn-loop · 56 tokens