https://github.com/josephgoksu/taskwing
Open-source task manager + MCP hooks—CLI meets AI.
https://github.com/josephgoksu/taskwing
ai ai-powered automation cli developer-tools go golang lightweight local-first open-source product-management productivity task-management task-manager
Last synced: about 1 month ago
JSON representation
Open-source task manager + MCP hooks—CLI meets AI.
- Host: GitHub
- URL: https://github.com/josephgoksu/taskwing
- Owner: josephgoksu
- License: other
- Created: 2025-06-03T11:53:23.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-08-26T23:28:44.000Z (about 2 months ago)
- Last Synced: 2025-08-27T06:58:55.399Z (about 2 months ago)
- Topics: ai, ai-powered, automation, cli, developer-tools, go, golang, lightweight, local-first, open-source, product-management, productivity, task-management, task-manager
- Language: Go
- Homepage: https://taskwing.app
- Size: 493 KB
- Stars: 9
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# TaskWing
**AI-powered CLI task manager built for developers**
[](https://goreportcard.com/report/github.com/josephgoksu/TaskWing)
[](https://github.com/josephgoksu/TaskWing/releases)
[](https://golang.org)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[](https://github.com/josephgoksu/TaskWing/issues)
[](https://github.com/josephgoksu/TaskWing/pulls)
[](https://github.com/josephgoksu/TaskWing/releases)
TaskWing integrates directly with Claude Code, Cursor, and other AI tools via the Model Context Protocol. Manage tasks from your terminal or let AI handle it for you.
## Why TaskWing?
- **🤖 AI-Native**: Full MCP integration for Claude Code, Cursor, and other AI tools
- **⚡ Zero Config**: Works immediately, stores data locally in your project
- **🔗 Smart Dependencies**: Automatic dependency tracking and circular reference prevention
- **📚 Learning System**: Captures patterns from completed projects for future AI assistance
- **🚀 Developer-First**: Built for developers who value focus and efficiency
## By [@josephgoksu](https://x.com/josephgoksu)
[](https://x.com/josephgoksu)
## Quick Start
### Installation
#### One-liner install (recommended)
```bash
curl -sSfL https://raw.githubusercontent.com/josephgoksu/TaskWing/main/install.sh | sh
```
> **Note**: After installation, you may need to add `~/.local/bin` to your PATH:
>
> ```bash
> echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
> ```
#### Alternative: Go install
If you have Go installed:
```bash
go install github.com/josephgoksu/TaskWing@latest
```
#### Verify installation
```bash
taskwing version
```
### First Steps
**New to TaskWing?** Start with the interactive guide:
```bash
taskwing quickstart
```
**Or jump straight in:**
```bash
# Initialize in your project
taskwing init
# Interactive menu (great for beginners)
taskwing interactive
# Or use direct commands
taskwing add "Fix authentication bug" --priority urgent
taskwing ls # List all tasks
taskwing start # Begin working
taskwing done # Mark complete
```
### AI Integration
**Quick setup for Claude Code:**
1. Start MCP server:
```bash
taskwing mcp
```
2. Add to Claude Code config:
```json
{
"mcpServers": {
"taskwing": {
"command": "taskwing",
"args": ["mcp"]
}
}
}
```
3. Ask Claude: _"What tasks do I have?"_ or _"Create a task to refactor the auth module"_
**Example AI interactions:**
- _"Break down this feature into tasks"_
- _"What should I work on next?"_
- _"Create tasks from this GitHub issue"_
- _"Show me my current sprint status"_
See [MCP Setup Guide](MCP.md) for detailed configuration and [AI Examples](EXAMPLES.md) for advanced patterns.
## Core Features
### 🎯 Task Management
- **Rich metadata**: Priority, status, dependencies, acceptance criteria
- **Flexible workflow**: `todo` → `doing` → `review` → `done`
- **Smart search**: Find tasks by title, description, or partial ID
- **Board view**: Kanban-style project visualization
### 🤖 AI Integration
- **MCP Protocol**: Direct integration with Claude Code, Cursor, and AI tools
- **Context-aware**: AI knows your current task and project state
- **Intelligent suggestions**: Get next task recommendations
- **Planning assistance**: Break down features into actionable tasks
### 🔗 Smart Dependencies
- **Relationship tracking**: Parent/child tasks and dependencies
- **Circular prevention**: Automatic detection and prevention
- **Dependency health**: Analyze and fix broken relationships
### ⚡ Developer Experience
- **Zero config**: Works immediately in any project
- **Local-first**: All data stored in your project directory
- **Fast commands**: Optimized for daily use with aliases
- **Interactive mode**: Menu-driven interface for exploration
**Example workflows:**
```bash
# Sprint planning
taskwing add "Implement user auth" --priority high
taskwing add "Add login form" --parent
taskwing add "Add logout functionality" --parent
taskwing board-snapshot # See the plan
# Daily workflow
taskwing current # See active task
taskwing next # Get AI suggestions
taskwing start # Focus on task
taskwing done # Mark complete
# Project analysis
taskwing search "auth" # Find auth-related tasks
taskwing analytics # View completion metrics
taskwing workflow-status # See project phase
```
For complete command reference, see [User Guide](DOCS.md#commands-reference).
## Real-World Examples
### Daily Development Workflow
```bash
# Morning standup
taskwing current # What am I working on?
taskwing board-snapshot # Sprint overview
# Start new work
taskwing add "Implement OAuth2 flow" --priority high
taskwing start # Focus mode
# AI assistance
# Ask Claude: "Break down this OAuth task into smaller steps"
# Claude creates subtasks automatically via MCP
# End of day
taskwing done # Mark complete
taskwing next # What's next?
```
### Project Planning with AI
```bash
# Upload PRD to Claude and ask:
# "Create a task breakdown for this feature spec"
# Claude uses MCP to:
taskwing batch-create-tasks # Create multiple tasks
taskwing board-reconcile # Organize dependencies
taskwing workflow-status # Show project phases
```
## Documentation
| Document | Purpose |
| ------------------------------ | ----------------------------------------------- |
| **[DOCS.md](DOCS.md)** | User guide - Installation, commands, workflows |
| **[MCP.md](MCP.md)** | AI integration - Setup and tool reference |
| **[EXAMPLES.md](EXAMPLES.md)** | AI interaction examples - Common usage patterns |
| **[CLAUDE.md](CLAUDE.md)** | Developer guide - Architecture and contributing |
## For Developers
### Quick Development Setup
```bash
# Clone and setup
git clone https://github.com/josephgoksu/TaskWing.git
cd TaskWing
make dev-setup # Install dev tools
# Development workflow
make build # Build binary
make test-quick # Fast tests
make lint # Format and lint
# Testing
make test-all # Comprehensive test suite
make test-mcp # Test MCP integration
make coverage # Generate coverage report
```
### Architecture
- **Local-first**: All data in project `.taskwing/` directory
- **Go 1.24+**: Built with Cobra CLI framework
- **MCP Integration**: Full Model Context Protocol support
- **File-based storage**: JSON/YAML/TOML with file locking
- **33+ MCP tools**: Comprehensive AI integration
### Contributing
We welcome contributions! Key areas:
- 🐛 **Bug fixes**: See [issues](https://github.com/josephgoksu/TaskWing/issues)
- ✨ **New MCP tools**: Extend AI capabilities
- 📄 **Documentation**: Improve user experience
- 🧪 **Testing**: Increase coverage and reliability
See [CLAUDE.md](CLAUDE.md) for detailed development guide.
## License
MIT License - see [LICENSE](LICENSE) file.
---
[](https://www.star-history.com/#josephgoksu/TaskWing&Date)
**Built for the terminal. Powered by AI. Made for developers.** 🚀