TaskWing

TaskWing

The local-first knowledge layer for AI development.

Website · Tutorial · Vision · Install

---

Your AI tools start every session from zero -- and every session, your code context flows through someone else's cloud.

TaskWing takes the opposite approach. One command extracts your architecture into a local knowledge base on your machine. No cloud. No account. Every AI session after that just knows -- without your knowledge base leaving your infrastructure.

Without TaskWing              With TaskWing
─────────────────             ─────────────
8-12 file reads               1 taskwing ask
~25,000 tokens                ~1,500 tokens
2-3 minutes                   42 seconds
No architectural 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. Declare a TaskWing project + generate AI tool integration files
cd your-project
taskwing init                  # writes .taskwing.yaml + .claude/commands/taskwing/

# 2. Extract your architecture (one-time)
taskwing learn
# -> 22 decisions, 12 patterns, 9 constraints extracted

# 3. Plan and execute with your AI assistant
/taskwing:plan       # Create a plan
/taskwing:next       # Get next task with full context
# ...work...
/taskwing:done       # Mark complete, advance to next

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

Slash commands are pure prompts that drive the taskwing CLI directly - no MCP server, no daemon, no per-AI registration. They work in any AI client that can run shell commands.

Private by Architecture

TaskWing keeps your knowledge base on your machine. No cloud database, no account, no sync.

  YOUR MACHINE                          EXTERNAL
  ─────────────────────────────────     ─────────────────────────
                                        ┌───────────────────────┐
  ┌──────────────┐   code context       │ LLM Provider          │
  │ Your codebase ├────────────────────>│ (OpenAI, Anthropic,   │
  └──────────────┘   (bootstrap only)   │  Google, Bedrock)     │
         │                              └───────────┬───────────┘
         │                                          │ findings
         v                                          │
  ┌──────────────────────┐  <───────────────────────┘
  │ .taskwing/memory.db  │
  │ Local SQLite         │  Your knowledge base.
  │ Never uploaded.      │  Never leaves your machine.
  └──────────┬───────────┘
             │ taskwing CLI (local subprocess)
             v
  ┌──────────────────────┐              ┌───────────────────────┐
  │ AI Tool              │  may send    │ Tool's own cloud      │
  │ (Claude, Cursor,     ├─────────────>│ (per their privacy    │
  │  Copilot, Gemini)    │  to their    │  policy)              │
  └──────────────────────┘  servers     └───────────────────────┘

  FULL AIR-GAP (everything stays left of the line):