cc-track-tools

cc-track Tools

This skill provides access to cc-track's utility scripts. When invoked, you receive the base directory path which you use to run scripts.

How to Use

1. Note the base directory provided when this skill loads
2. Run scripts using: bun {base_directory}/scripts/{script-name}.ts [args]
3. Scripts return JSON output - parse and interpret the results

Available Scripts

prepare-completion.ts

Runs validation suite (TypeScript, lint, tests, knip) for the active task.

bun {base_directory}/scripts/prepare-completion.ts

complete-task.ts

Completes the active task: updates metadata, squashes WIP commits, creates PR.

bun {base_directory}/scripts/complete-task.ts

specify.ts

Creates spec infrastructure: git branch, spec folder, metadata, CLAUDE.md update, GitHub issue.

bun {base_directory}/scripts/specify.ts "Feature title"

backlog.ts

Add items to the project backlog or list existing items.

# Add an item
bun {base_directory}/scripts/backlog.ts "Your backlog item text"

# List all items
bun {base_directory}/scripts/backlog.ts --list

git-session.ts

Git session utilities for managing WIP commits.

# Squash WIP commits with a message
bun {base_directory}/scripts/git-session.ts squash "commit message"

# Show diff since last user commit
bun {base_directory}/scripts/git-session.ts diff

# Show WIP commits
bun {base_directory}/scripts/git-session.ts wip

# Prepare for push (run lint/tests)
bun {base_directory}/scripts/git-session.ts prepare-push

Requirements

• bun: Scripts are TypeScript and require bun to run
• Project context: Most scripts expect to run from a cc-track enabled project