Tack
Getting Started

Configuration

Configure Tack for your project with .tack/config.yaml

Create .tack/config.yaml in your project root:

daemon:
  listen: "127.0.0.1:9800"
  data_dir: ".tack/data"
  base_branch: "main"

sandbox:
  provider: local
  # post_create:              # optional setup commands
  #   - "bun install"

agents:
  runtime: pi
  max_concurrent: 4
  stagger_delay_ms: 1000
  pi:
    provider: anthropic
    model: claude-opus-4-6
    thinking_level: medium
  timeouts:
    default:
      max_duration_minutes: 30
      idle_minutes: 10
    builder:
      max_duration_minutes: 45
    reviewer:
      max_duration_minutes: 15

quality_gates:
  - "bun test"
  - "bunx tsc --noEmit"
  - "bun run lint"

Credentials

Store API keys in ~/.config/tack/credentials.yaml:

anthropic:
  setup_token: "sk-ant-..."
github:
  pat: "ghp_..."

Project Layout

.tack/
  config.yaml          # Runtime config
  blueprints/          # Workflow definitions (ships with defaults)
    stream.yaml
  rules/               # Project-specific agent guidance
    project.yaml
  data/                # Managed by Tack: SQLite, activity logs
    tack.db
    activity/

Configuration Reference

See the full config reference for all available options.

On this page