iss

Local issue tracker for git repos. Stores issues in .tasks.json at the repo root — works from any subdirectory.

Commands

To see up-to-date usage, use the -h flag (e.g. iss -h or iss new -h).

• new — create an issue (--title required; optional --desc, --tag)
• list — list issues (default: open; filter by --status, --tag)
• show — show full detail for an issue by ID
• edit — edit title/description by ID; opens $EDITOR if no flags given
• close — mark an issue closed
• reopen — reopen a closed issue
• delete — permanently remove an issue by ID
• comment — add a comment to an issue (--text or opens $EDITOR)
• tag — add a tag to an issue
• untag — remove a tag from an issue
• search — full-text search across titles, descriptions, comments, and tags

AI-Assisted Development

iss ships with an agent skill in skills/iss/ that lets Claude Code use iss automatically — no manual commands needed.

Install the skill by pointing Claude Code at the skills/ directory:

// .claude/settings.json
{
  "skills": { "directories": ["skills"] }
}

Once loaded, Claude will create, close, tag, and search issues whenever you mention bugs, tasks, or TODOs in conversation. Say "log a bug", "what's open", or "mark that done" and Claude runs the right iss command for you.