{"id":30642317,"url":"https://github.com/josephgoksu/taskwing","last_synced_at":"2026-04-06T19:03:09.947Z","repository":{"id":307378694,"uuid":"995381971","full_name":"josephgoksu/TaskWing","owner":"josephgoksu","description":"Local-first AI knowledge layer. Extract architecture, query from any AI tool via MCP. Private by architecture.","archived":false,"fork":false,"pushed_at":"2026-03-21T21:26:34.000Z","size":4339,"stargazers_count":83,"open_issues_count":2,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-02T08:24:55.387Z","etag":null,"topics":["ai","architecture","claude","claude-code","cli","code-intelligence","codex-cli","developer-tools","gemini","golang","local-first","mcp","ollama","open-source","privacy","sqlite"],"latest_commit_sha":null,"homepage":"https://taskwing.app","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/josephgoksu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-06-03T11:53:23.000Z","updated_at":"2026-03-30T05:36:00.000Z","dependencies_parsed_at":"2025-07-31T00:49:08.630Z","dependency_job_id":"3f80bbf8-2be5-443b-8388-7026ff045b64","html_url":"https://github.com/josephgoksu/TaskWing","commit_stats":null,"previous_names":["josephgoksu/taskwing"],"tags_count":88,"template":false,"template_full_name":null,"purl":"pkg:github/josephgoksu/TaskWing","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephgoksu%2FTaskWing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephgoksu%2FTaskWing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephgoksu%2FTaskWing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephgoksu%2FTaskWing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/josephgoksu","download_url":"https://codeload.github.com/josephgoksu/TaskWing/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/josephgoksu%2FTaskWing/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31485516,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-06T17:22:55.647Z","status":"ssl_error","status_checked_at":"2026-04-06T17:22:54.741Z","response_time":112,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","architecture","claude","claude-code","cli","code-intelligence","codex-cli","developer-tools","gemini","golang","local-first","mcp","ollama","open-source","privacy","sqlite"],"created_at":"2025-08-31T02:08:26.267Z","updated_at":"2026-04-06T19:03:09.925Z","avatar_url":"https://github.com/josephgoksu.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003cimg src=\"https://taskwing.app/taskwing-icon.svg\" alt=\"TaskWing\" width=\"80\"\u003e\n  \u003cbr\u003e\n  TaskWing\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003eThe local-first knowledge layer for AI development.\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://taskwing.app\"\u003eWebsite\u003c/a\u003e ·\n  \u003ca href=\"docs/TUTORIAL.md\"\u003eTutorial\u003c/a\u003e ·\n  \u003ca href=\"docs/PRODUCT_VISION.md\"\u003eVision\u003c/a\u003e ·\n  \u003ca href=\"#install\"\u003eInstall\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://goreportcard.com/report/github.com/josephgoksu/TaskWing\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/josephgoksu/TaskWing\" alt=\"Go Report Card\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"demos/ask.gif\" alt=\"TaskWing ask demo\" width=\"800\"\u003e\n\u003c/p\u003e\n\n---\n\nYour AI tools start every session from zero -- and every session, your code context flows through someone else's cloud.\n\n**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.\n\n```\nWithout TaskWing              With TaskWing\n─────────────────             ─────────────\n8-12 file reads               1 MCP query\n~25,000 tokens                ~1,500 tokens\n2-3 minutes                   42 seconds\nNo architectural context       170+ knowledge nodes\n```\n\n## Install\n\n```bash\nbrew install josephgoksu/tap/taskwing\n```\n\nNo signup. No account. Works offline. Everything stays local in SQLite.\n\n\u003cdetails\u003e\n\u003csummary\u003eAlternative: install via curl\u003c/summary\u003e\n\n```bash\ncurl -fsSL https://taskwing.app/install.sh | sh\n```\n\u003c/details\u003e\n\n## Quick Start\n\n```bash\n# 1. Extract your architecture (one-time)\ncd your-project\ntaskwing bootstrap\n# -\u003e 22 decisions, 12 patterns, 9 constraints extracted\n\n# 2. Connect to your AI tool\ntaskwing mcp install claude    # or: cursor, gemini, codex, copilot, opencode\n\n# 3. Plan and execute with your AI assistant\n/taskwing:plan       # Create a plan via MCP\n/taskwing:next       # Get next task with full context\n# ...work...\n/taskwing:done       # Mark complete, advance to next\n```\n\nThat's it. Your AI assistant now has local architectural context across every session.\n\n## Private by Architecture\n\nTaskWing keeps your knowledge base on your machine. No cloud database, no account, no sync.\n\n```\n  YOUR MACHINE                          EXTERNAL\n  ─────────────────────────────────     ─────────────────────────\n                                        ┌───────────────────────┐\n  ┌──────────────┐   code context       │ LLM Provider          │\n  │ Your codebase ├────────────────────\u003e│ (OpenAI, Anthropic,   │\n  └──────────────┘   (bootstrap only)   │  Google, Bedrock)     │\n         │                              └───────────┬───────────┘\n         │                                          │ findings\n         v                                          │\n  ┌──────────────────────┐  \u003c───────────────────────┘\n  │ .taskwing/memory.db  │\n  │ Local SQLite         │  Your knowledge base.\n  │ Never uploaded.      │  Never leaves your machine.\n  └──────────┬───────────┘\n             │ local stdio (MCP)\n             v\n  ┌──────────────────────┐              ┌───────────────────────┐\n  │ AI Tool              │  may send    │ Tool's own cloud      │\n  │ (Claude, Cursor,     ├─────────────\u003e│ (per their privacy    │\n  │  Copilot, Gemini)    │  to their    │  policy)              │\n  └──────────────────────┘  servers     └───────────────────────┘\n\n\n  FULL AIR-GAP (everything stays left of the line):\n\n  ┌──────────────┐        ┌─────────┐        ┌──────────────┐\n  │ Your codebase ├──────\u003e│ Ollama  ├──────\u003e│ .taskwing/   │\n  └──────────────┘        │ (local) │        │ memory.db    │\n                          └─────────┘        └──────┬───────┘\n                                                    │ local stdio\n                                                    v\n                                             ┌──────────────┐\n                                             │ Local AI tool │\n                                             └──────────────┘\n                                             Zero network calls.\n```\n\n**What TaskWing controls:** Your knowledge base is stored and queried locally. MCP serves responses over local stdio -- no network calls.\n\n**What your AI tool controls:** Cloud-based tools (Claude, Cursor, Copilot) may send conversations to their own servers. Check their privacy settings (e.g., Cursor's Privacy Mode, Copilot's data retention policies).\n\n**Full air-gap:** Use [Ollama](https://ollama.com/) for bootstrap + a local AI tool. Nothing leaves your machine.\n\n## Works With\n\n\u003c!-- TASKWING_TOOLS_START --\u003e\n[![Claude Code](https://img.shields.io/badge/Claude_Code-191919?logo=anthropic\u0026logoColor=white)](https://www.anthropic.com/claude-code)\n[![OpenAI Codex](https://img.shields.io/badge/OpenAI_Codex-412991?logo=openai\u0026logoColor=white)](https://developers.openai.com/codex)\n[![Cursor](https://img.shields.io/badge/Cursor-111111?logo=cursor\u0026logoColor=white)](https://cursor.com/)\n[![GitHub Copilot](https://img.shields.io/badge/GitHub_Copilot-181717?logo=githubcopilot\u0026logoColor=white)](https://github.com/features/copilot)\n[![Gemini CLI](https://img.shields.io/badge/Gemini_CLI-4285F4?logo=google\u0026logoColor=white)](https://github.com/google-gemini/gemini-cli)\n[![OpenCode](https://img.shields.io/badge/OpenCode-000000?logo=opencode\u0026logoColor=white)](https://opencode.ai/)\n\u003c!-- TASKWING_TOOLS_END --\u003e\n\n## Supported Models\n\n\u003c!-- TASKWING_PROVIDERS_START --\u003e\n[![OpenAI](https://img.shields.io/badge/OpenAI-412991?logo=openai\u0026logoColor=white)](https://platform.openai.com/)\n[![Anthropic](https://img.shields.io/badge/Anthropic-191919?logo=anthropic\u0026logoColor=white)](https://www.anthropic.com/)\n[![Google Gemini](https://img.shields.io/badge/Google_Gemini-4285F4?logo=google\u0026logoColor=white)](https://ai.google.dev/)\n[![AWS Bedrock](https://img.shields.io/badge/AWS_Bedrock-OpenAI--Compatible_Beta-FF9900?logo=amazonaws\u0026logoColor=white)](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-chat-completions.html)\n[![Ollama](https://img.shields.io/badge/Ollama-Local-000000?logo=ollama\u0026logoColor=white)](https://ollama.com/)\n\u003c!-- TASKWING_PROVIDERS_END --\u003e\n\n\u003c!-- TASKWING_LEGAL_START --\u003e\nBrand names and logos are trademarks of their respective owners; usage here indicates compatibility, not endorsement.\n\u003c!-- TASKWING_LEGAL_END --\u003e\n\n## What It Does\n\n| Capability | Description |\n|:-----------|:------------|\n| **Local knowledge** | Extracts decisions, patterns, and constraints into local SQLite |\n| **Plan to tasks** | Turns a plan into decomposed tasks with architecture context |\n| **AI-driven lifecycle** | Task execution -- next, start, complete, verify |\n| **Code analysis** | Symbol search, call graphs, impact analysis, simplification |\n| **Root cause first** | AI-powered diagnosis before proposing fixes |\n| **Works everywhere** | Exposes everything to 6+ AI tools via local MCP |\n\n## Slash Commands\n\nUse these from your AI assistant once connected:\n\n| Command | When to use |\n|:--------|:------------|\n| `/taskwing:plan` | Clarify a goal and build an approved execution plan |\n| `/taskwing:next` | Start the next approved task with full context |\n| `/taskwing:done` | Complete the current task after verification |\n| `/taskwing:context` | Get full project knowledge dump for complete architectural context |\n\n\u003cdetails\u003e\n\u003csummary\u003eMCP setup (manual)\u003c/summary\u003e\n\n`taskwing mcp install` handles this automatically. If you need to configure manually, add to your AI tool's MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"taskwing\": {\n      \"command\": \"taskwing\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n\n\u003c!-- TASKWING_MCP_TOOLS_START --\u003e\n| Tool | Description |\n|------|-------------|\n| `ask` | Search project knowledge (decisions, patterns, constraints) |\n| `task` | Unified task lifecycle (`next`, `current`, `start`, `complete`) |\n| `plan` | Plan management (`clarify`, `decompose`, `expand`, `generate`, `finalize`, `audit`) |\n| `code` | Code intelligence (`find`, `search`, `explain`, `callers`, `impact`, `simplify`) |\n| `debug` | Diagnose issues systematically with AI-powered analysis |\n| `remember` | Store knowledge in project memory |\n\u003c!-- TASKWING_MCP_TOOLS_END --\u003e\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eAutonomous task execution (hooks)\u003c/summary\u003e\n\nTaskWing integrates with Claude Code's hook system for autonomous plan execution:\n\n```bash\ntaskwing hook session-init      # Initialize session tracking\ntaskwing hook continue-check    # Check if should continue to next task\ntaskwing hook session-end       # Cleanup session\ntaskwing hook status            # View current session state\n```\n\n**Circuit breakers** prevent runaway execution:\n- `--max-tasks=5` -- Stop after N tasks for human review\n- `--max-minutes=30` -- Stop after N minutes\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eAWS Bedrock setup\u003c/summary\u003e\n\n```yaml\nllm:\n  provider: bedrock\n  model: anthropic.claude-sonnet-4-5-20250929-v1:0\n  bedrock:\n    region: us-east-1\n  apiKeys:\n    bedrock: ${BEDROCK_API_KEY}\n```\n\n| Model | Use case |\n|:------|:---------|\n| `anthropic.claude-opus-4-6-v1` | Highest quality reasoning |\n| `anthropic.claude-sonnet-4-5-20250929-v1:0` | Best default balance |\n| `amazon.nova-premier-v1:0` | AWS flagship Nova |\n| `amazon.nova-pro-v1:0` | Strong balance |\n| `meta.llama4-maverick-17b-instruct-v1:0` | Open-weight general model |\n\nOr configure interactively: `taskwing config`\n\n\u003c/details\u003e\n\n\u003c!-- TASKWING_COMMANDS_START --\u003e\n- `taskwing bootstrap`\n- `taskwing ask \"\u003cquery\u003e\"`\n- `taskwing task`\n- `taskwing mcp`\n- `taskwing doctor`\n- `taskwing config`\n- `taskwing start`\n\u003c!-- TASKWING_COMMANDS_END --\u003e\n\n## Documentation\n\n- [Getting Started](docs/TUTORIAL.md)\n- [Product Vision](docs/PRODUCT_VISION.md)\n- [Architecture](docs/architecture/)\n- [Workflow Pack](docs/WORKFLOW_PACK.md)\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosephgoksu%2Ftaskwing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjosephgoksu%2Ftaskwing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosephgoksu%2Ftaskwing/lists"}