TaskWing

Give your AI tools a brain.

Website · Tutorial · Vision · Install

---

Your AI tools start every session from zero. They don't know your stack, your patterns, or why you chose PostgreSQL over MongoDB.

TaskWing fixes this. One command extracts your architecture into a local database. Every AI session after that just knows.

Without TaskWing              With TaskWing
─────────────────             ─────────────
8–12 file reads               1 MCP query
~25,000 tokens                ~1,500 tokens
2–3 minutes                   42 seconds
Zero persistent context       170+ knowledge nodes

Install

brew install josephgoksu/tap/taskwing

No signup. No account. Works offline. Everything stays local in SQLite.

Alternative: install via curl

curl -fsSL https://taskwing.app/install.sh | sh

Quick Start

# 1. Extract your architecture (one-time)
cd your-project
taskwing bootstrap
# → 22 decisions, 12 patterns, 9 constraints extracted

# 2. Connect to your AI tool
taskwing mcp install claude    # or: cursor, gemini, codex, copilot, opencode

# 3. Set a goal and go
taskwing goal "Add Stripe billing"
# → Plan decomposed into 5 executable tasks

# 4. Execute with your AI assistant
/taskwing:next       # Get next task with full context
# ...work...
/taskwing:done       # Mark complete, advance to next

That's it. Your AI assistant now has persistent architectural context across every session.

Works With

Supported Models

Brand names and logos are trademarks of their respective owners; usage here indicates compatibility, not endorsement.

What It Does

Capability	Description
Memory	Extracts and persists architectural decisions, patterns, and constraints
Planning	Turns a goal into an executable plan with decomposed tasks
Task Execution	AI-driven task lifecycle — next, start, complete, verify
Code Intelligence	Symbol search, call graphs, impact analysis, simplification
Debugging	AI-powered root cause analysis with systematic diagnosis
MCP Integration	Exposes everything to your AI tools via Model Context Protocol

Slash Commands

Use these from your AI assistant once connected:

Command	When to use
/taskwing:ask	Search project knowledge (decisions, patterns, constraints)
/taskwing:remember	Persist a decision, pattern, or insight to project memory
/taskwing:next	Start the next approved task with full context
/taskwing:done	Complete the current task after verification
/taskwing:status	Check current task progress and acceptance criteria
/taskwing:plan	Clarify a goal and build an approved execution plan
/taskwing:debug	Root-cause-first debugging before proposing fixes
/taskwing:explain	Deep explanation of a code symbol and its call graph
/taskwing:simplify	Simplify code while preserving behavior

MCP setup (manual)

taskwing mcp install handles this automatically. If you need to configure manually, add to your AI tool's MCP config:

{
  "mcpServers": {
    "taskwing": {
      "command": "taskwing",
      "args": ["mcp"]
    }
  }
}

Tool	Description
ask	Search project knowledge (decisions, patterns, constraints)
task	Unified task lifecycle (next, current, start, complete)
plan	Plan management (clarify, decompose, expand, generate, finalize, audit)
code	Code intelligence (find, search, explain, callers, impact, simplify)
debug	Diagnose issues systematically with AI-powered analysis
remember	Store knowledge in project memory

Autonomous task execution (hooks)

TaskWing integrates with Claude Code's hook system for autonomous plan execution:

taskwing hook session-init      # Initialize session tracking
taskwing hook continue-check    # Check if should continue to next task
taskwing hook session-end       # Cleanup session
taskwing hook status            # View current session state

Circuit breakers prevent runaway execution:

• --max-tasks=5 — Stop after N tasks for human review
• --max-minutes=30 — Stop after N minutes

AWS Bedrock setup

llm:
  provider: bedrock
  model: anthropic.claude-sonnet-4-5-20250929-v1:0
  bedrock:
    region: us-east-1
  apiKeys:
    bedrock: ${BEDROCK_API_KEY}

Model	Use case
anthropic.claude-opus-4-6-v1	Highest quality reasoning
anthropic.claude-sonnet-4-5-20250929-v1:0	Best default balance
amazon.nova-premier-v1:0	AWS flagship Nova
amazon.nova-pro-v1:0	Strong balance
meta.llama4-maverick-17b-instruct-v1:0	Open-weight general model

Or configure interactively: taskwing config

• taskwing bootstrap
• taskwing goal "<goal>"
• taskwing ask "<query>"
• taskwing task
• taskwing plan status
• taskwing slash
• taskwing mcp
• taskwing doctor
• taskwing config
• taskwing start

Documentation

• Getting Started
• Product Vision
• Architecture
• Workflow Pack

License

MIT