0.3.0 - 2026-08-23

Release Notes

Added

• tkt context command — scope your session to specific tags so you only see relevant tickets and new tickets inherit those tags automatically
• tkt migrate command — detect and convert foreign ticket schemas (built-in tk adapter with ID remapping and dep rewiring)
• Machine capability matching via requires field — tickets only appear on frontier if the workstation has the required capabilities (machine.capabilities config)
• --tags flag on tkt new and tkt batch for explicit ticket categorization
• --requires flag on tkt new and tkt batch for declaring machine requirements
• tkt audit --deep for mechanical quality checks (evidence count mismatch, template-only closures)
• Validation criteria now enforced at ticket creation time (when configured) — agents must define success upfront, no escape hatches
• Telemetry now captures error classification on failures, which flags were used, and result counts for read commands
• Telemetry --show displays command distribution, error rate, workflow patterns, and per-command friction scores
• Telemetry --show --all displays full event history instead of last 20
• Telemetry captures parse/syntax errors when agents use wrong flag names or unknown subcommands
• Properly-migrated tickets (resolution contains "Migrated to") no longer flagged by tkt audit --deep

Changed

• tkt ready now filters by active tag context (set via tkt context) in addition to env/requires
• CREW_ENV is now legacy — prefer requires field + machine.capabilities config for new projects
• Telemetry --show output restructured with summary header before event list

Install tkt 0.3.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/smileynet/tkt/releases/download/v0.3.0/tkt-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/smileynet/tkt/releases/download/v0.3.0/tkt-installer.ps1 | iex"

Download tkt 0.3.0

File	Platform	Checksum
tkt-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
tkt-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
tkt-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
tkt-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
tkt-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.2.1 - 2026-08-18

Release Notes

Fixed

• tkt init now teaches agents about backlog workflow, status transitions, and evidence-based closure
• Agent instructions generated by tkt init --all were missing --status backlog, --evidence, and promote/demote patterns — agents would create open tickets when intending to park work

Install tkt 0.2.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/smileynet/tkt/releases/download/v0.2.1/tkt-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/smileynet/tkt/releases/download/v0.2.1/tkt-installer.ps1 | iex"

Download tkt 0.2.1

File	Platform	Checksum
tkt-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
tkt-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
tkt-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
tkt-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
tkt-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.2.0 - 2026-08-18

Release Notes

Added

• tkt init command to set up a project and deploy AI agent instructions in one step
• tkt doctor command to verify your setup is correct
• tkt doctor <path> to scan all your projects at once and report health
• tkt lint command to normalize ticket frontmatter style (quoting, field order, whitespace)
• tkt lint --check for CI — exits 1 if any file would change
• tkt validate --fix to automatically repair common ticket issues
• Validation criteria on tickets — define what "done" means at creation time
• Evidence on close — link proof to each criterion so reviewers see what was verified
• Configurable enforcement for validation evidence (warn, require, or off)
• tkt audit flags tickets closed without evidence when criteria were defined
• --dry-run flag on all mutation commands — preview what would happen without writing
• Global -o json flag — structured JSON output for all commands
• Structured error envelopes — machine-parseable errors with kind, message, hint, and exit code
• Error kind vocabulary (8 types) declared in tkt capabilities with retryable flags
• Self-update check — notifies when a newer version is available (once per day, non-blocking)
• Unified config cascade — user config provides global defaults, project config overrides per-repo
• close.allow_force config — disable the --force escape hatch project-wide or globally
• Git hash in --version output for dev build traceability (e.g., tkt 0.2.0 (ea047fb))
• Agent Plugins conformance — ships plugin.json and skills/tkt/SKILL.md per agentskills.io spec
• tkt doctor <path> now flags non-tkt git repos and supports --strict and -o json

Changed

• tkt config --show now reports the source of each resolved value (env/project/user/default)
• ready --json still works but -o json ready is now the canonical form
• Clearer README and crate description

Fixed

• Evidence gate: duplicate named evidence indices (e.g., 1=foo 1=bar) no longer bypass the complete-evidence requirement

Install tkt 0.2.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/smileynet/tkt/releases/download/v0.2.0/tkt-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/smileynet/tkt/releases/download/v0.2.0/tkt-installer.ps1 | iex"

Download tkt 0.2.0

File	Platform	Checksum
tkt-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
tkt-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
tkt-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
tkt-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
tkt-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum

0.1.0 - 2026-08-09

Release Notes

Added

• Frontier computation: tkt ready shows unblocked tickets sorted by priority
• Push-to-claim: atomic ticket allocation via git push with race detection
• Multi-level priority: urgent > high > medium > low (frontier sort order)
• Backlog status: park tickets outside the frontier with status: backlog
• Ticket lifecycle: tkt new, tkt claim, tkt close, tkt edit, tkt renumber
• Batch ticket creation: tkt batch for multiple tickets in one push
• Query with filters: tkt query --status open --priority high
• Blocked view: tkt blocked shows tickets with unsatisfied dependencies
• Validation: tkt validate checks for cycles, dangling deps, contract violations
• Audit: tkt audit for closure quality (unchecked ACs, missing resolutions, stale WIP)
• Plan sync: tkt sync-plan detects and fixes drift between tickets and plan documents
• ID collision resolution: tkt rebase auto-renumbers when upstream conflicts
• Agent discovery: tkt capabilities outputs JSON manifest of commands and workflows
• Per-project config: .tickets/config.toml for tunable behaviors (push, close, validate)
• User config: ~/.config/tkt/config.toml for debug mode and format preferences
• Color support: --color=always|never|auto, respects NO_COLOR (no-color.org)
• ASCII fallback: TKT_ASCII=1 for legacy terminals (✓→[ok], ✗→[err], ⚠→[warn])
• Spike branch awareness: auto-appends branch name to resolution on close
• Worktree support: works correctly from git worktrees
• Local-only telemetry: opt-in JSONL recording, never leaves your machine
• Debug mode: TKT_DEBUG=1|json for real-time diagnostics to stderr

Install tkt 0.1.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/smileynet/tkt/releases/download/v0.1.0/tkt-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/smileynet/tkt/releases/download/v0.1.0/tkt-installer.ps1 | iex"

Download tkt 0.1.0

File	Platform	Checksum
tkt-aarch64-apple-darwin.tar.gz	Apple Silicon macOS	checksum
tkt-x86_64-apple-darwin.tar.gz	Intel macOS	checksum
tkt-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
tkt-aarch64-unknown-linux-gnu.tar.gz	ARM64 Linux	checksum
tkt-x86_64-unknown-linux-gnu.tar.gz	x64 Linux	checksum