Skip to content

josephgoksu/TaskWing

Repository files navigation

TaskWing

TaskWing helps me turn a goal into executed tasks with persistent context across AI sessions.

Go Report Card License

Supported Models

OpenAI Anthropic Google Gemini AWS Bedrock Ollama

Works With

Claude Code OpenAI Codex Cursor GitHub Copilot Gemini CLI OpenCode

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

Focused Workflow

# 1) Bootstrap project memory
cd your-project
taskwing bootstrap

# 2) Create and activate a plan from one goal
taskwing goal "Add Stripe billing"

# 3) Execute from your AI assistant
/tw-next
# ...work...
/tw-done

What TaskWing Does

  • Stores architecture decisions, constraints, and patterns in local project memory.
  • Generates executable tasks from a goal using that memory.
  • Exposes context and task lifecycle tools to AI assistants via MCP.

Core Commands

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

MCP Tools

Tool Description
recall Retrieve 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

AWS Bedrock (OpenAI-Compatible) Setup

TaskWing supports Bedrock as a first-class provider for chat/planning/query flows.

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

You can also configure it interactively:

taskwing config

Recommended Bedrock model IDs:

  • 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 strong general model)

MCP Setup (Claude/Codex)

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

Docs

License

MIT