hack tickets

This repo uses the hack tickets extension (dance.hack.tickets).

Enable

Enable globally:

• hack config set --global 'controlPlane.extensions["dance.hack.tickets"].enabled' true

Or per-project by adding .hack/hack.config.json:

{
  "controlPlane": {
    "extensions": {
      "dance.hack.tickets": { "enabled": true }
    }
  }
}

Commands

• Create: hack x tickets create --title "..." [--body "..."] [--body-file <path>] [--body-stdin] [--depends-on "..."] [--blocks "..."] [--actor "..."] [--json]
• List: hack x tickets list [--json]
• Tui: hack x tickets tui
• Show: hack x tickets show <ticket-id> [--json]
• Update: hack x tickets update <ticket-id> [--title "..."] [--body "..."] [--depends-on "..."] [--blocks "..."] [--clear-depends-on] [--clear-blocks] [--json]
• Status: hack x tickets status <ticket-id> <open|in_progress|blocked|done> [--json]
• Sync: hack x tickets sync [--json]

Recommended body template (Markdown):

## Context
## Goals
## Notes
## Links

Tip: use --body-stdin for multi-line markdown.

Data model

• Tickets are derived from an append-only event log (JSONL).
• Local state lives in .hack/tickets/ (gitignored on the main branch).
• Sync writes commits to a dedicated ref (refs/hack/tickets hidden by default) and pushes to your remote.
• Set controlPlane.tickets.git.refMode to heads to use a normal branch ref (and protect it if desired).

Tips

• Keep ticket titles short; put detail in --body.
• Use --json for agent workflows and piping.
• Run hack x tickets sync before opening PRs if you want tickets to travel with the repo.