{"id":47720956,"url":"https://github.com/kleinpanic/oc-tasks","last_synced_at":"2026-04-02T19:33:45.575Z","repository":{"id":338529495,"uuid":"1158153139","full_name":"kleinpanic/oc-tasks","owner":"kleinpanic","description":"Unified task management CLI for OpenClaw agents. Kan ban workflow, priority queuing, SLA tracking, and multi-list support.","archived":false,"fork":false,"pushed_at":"2026-03-21T17:06:20.000Z","size":13165,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-22T01:15:56.386Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kleinpanic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":null,"dco":null,"cla":null}},"created_at":"2026-02-14T22:04:40.000Z","updated_at":"2026-03-21T09:33:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kleinpanic/oc-tasks","commit_stats":null,"previous_names":["kleinpanic/oc-tasks"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/kleinpanic/oc-tasks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kleinpanic%2Foc-tasks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kleinpanic%2Foc-tasks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kleinpanic%2Foc-tasks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kleinpanic%2Foc-tasks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kleinpanic","download_url":"https://codeload.github.com/kleinpanic/oc-tasks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kleinpanic%2Foc-tasks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31314379,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2026-04-02T19:33:44.919Z","updated_at":"2026-04-02T19:33:45.570Z","avatar_url":"https://github.com/kleinpanic.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# oc-tasks\n\nUnified task management CLI for OpenClaw agents and humans.\n\n![Version](https://img.shields.io/badge/Version-1.0.0-green)\n![Node](https://img.shields.io/badge/Node-22+-blue)\n![TypeScript](https://img.shields.io/badge/TypeScript-5-blue)\n\n## Features\n\n- **Kanban workflow**: intake → ready → in_progress → review → completed\n- **Priority-based queuing**: P0 (critical) → P4 (low)\n- **Multi-list support**: Personal, shared, agent-specific lists\n- **Agent assignment**: Assign tasks to specific OpenClaw agents\n- **SLA tracking**: Configurable SLA policies with breach alerting\n- **Effort tracking**: Built-in timer system for time tracking\n- **Smart search**: Full-text search across titles and descriptions\n- **External sync**: Sync with Mission Control and other systems\n\n## Installation\n\n```bash\n# Clone the repo\ngit clone https://github.com/kleinpanic/oc-tasks.git\ncd oc-tasks\n\n# Install dependencies\nnpm install\n\n# Build TypeScript\nnpm run build\n\n# Link binary globally\nnpm link\n# OR manually symlink\nln -s $(pwd)/bin/oc-tasks ~/.local/bin/oc-tasks\n```\n\n## Quick Start\n\n```bash\n# Add a task\noc-tasks add \"Fix navigation bug\" -p high -l agents -a dev\n\n# List all ready tasks\noc-tasks list --status ready\n\n# Get next task for an agent\noc-tasks next --agent main\n\n# Mark task as done\noc-tasks done nav-bug\n\n# Move task to review\noc-tasks move nav-bug review\n\n# Check overdue tasks\noc-tasks overdue\n\n# Show detailed task info\noc-tasks show nav-bug\n```\n\n## Commands\n\n### Core Operations\n- `list [options]` - List tasks with filtering (status, agent, priority, list)\n- `add \u003ctitle\u003e [options]` - Create a new task\n- `show \u003cid\u003e` - Show full task details + activity log\n- `done \u003cid\u003e` - Mark task as completed\n- `move \u003cid\u003e \u003cstatus\u003e` - Change task status\n- `update \u003cid\u003e [options]` - Update task fields\n\n### Workflow Management\n- `next [--agent \u003cagent\u003e]` - Get highest-priority ready task\n- `overdue` - Show tasks past due date\n- `triage` - Show intake tasks needing assignment\n- `backburner` - Show auto-backburnered tasks\n- `sla-check` - Evaluate SLA policies and alert breaches\n\n### Blocking \u0026 Dependencies\n- `block \u003cid\u003e \u003creason\u003e` - Block task with reason\n- `unblock \u003cid\u003e` - Remove blocker, move to ready\n\n### Search \u0026 Stats\n- `search \u003cpattern\u003e` - Full-text search\n- `stats [options]` - Task velocity, completion rates, agent breakdown\n\n### Time Tracking\n- `timer start \u003cid\u003e` - Start effort timer\n- `timer stop \u003cid\u003e` - Stop timer and log duration\n- `timer status` - Show active timers\n\n### Data Management\n- `sync` - Sync with external systems (Mission Control, etc.)\n- `migrate` - One-time migration from markdown todos\n- `delete \u003cid\u003e [--force]` - Delete a task\n\n## Configuration\n\nDatabase location: `~/.openclaw/data/tasks.db`\n\nDefault settings:\n- Lists: `personal`, `shared`, `agents`\n- Priorities: P0 (critical) → P4 (low)\n- Statuses: `intake`, `ready`, `backlog`, `in_progress`, `review`, `paused`, `blocked`, `completed`, `archived`\n\n## Task States\n\n| Status | Meaning | Who Acts |\n|--------|---------|----------|\n| `intake` | New, needs triage | Human |\n| `ready` | Ready to work | Agent can claim |\n| `backlog` | Deprioritized | (none) |\n| `in_progress` | Being worked on | Assigned agent |\n| `review` | Work done, awaiting approval | Human |\n| `paused` | Intentional hold | (none) |\n| `blocked` | Waiting on external dependency | (none) |\n| `completed` | Done \u0026 approved | (archived) |\n| `archived` | Historical record | (none) |\n\n## Integration with OpenClaw\n\n### AGENTS.md Integration\nThe `oc-tasks` CLI is the canonical task system for all OpenClaw agents. Agents check tasks via:\n- `oc-tasks list --list agents --status ready --agent unassigned` (find work)\n- `oc-tasks next --agent main` (get highest-priority task)\n- `oc-tasks move \u003cid\u003e review` (submit for review)\n\n### Mission Control Integration\nTasks are shared with Mission Control dashboard via SQLite WAL mode:\n- Both read from `~/.openclaw/data/tasks.db`\n- Mission Control provides web UI\n- oc-tasks provides CLI interface\n\n## macOS Compatibility\n\n**Rating: 9/10** ✅\n\n### Requirements\n- Node.js 18+ (tested on 22+)\n- npm or yarn\n- Python 3 + node-gyp (for better-sqlite3 native module)\n\n### Known Issues\n- `better-sqlite3` requires compilation on first install\n- Install Xcode Command Line Tools: `xcode-select --install`\n- If build fails, try: `npm rebuild better-sqlite3`\n\n### Database Path\nWorks seamlessly on macOS:\n- Path: `~/.openclaw/data/tasks.db` (creates directory if needed)\n- No platform-specific issues\n\n## Development\n\n```bash\n# Watch mode\nnpm run dev\n\n# Build\nnpm run build\n\n# Test\noc-tasks list  # Should work after build\n```\n\n## Architecture\n\n- **Language**: TypeScript\n- **Database**: SQLite3 (better-sqlite3)\n- **CLI Framework**: Commander.js\n- **Output**: cli-table3, chalk\n\n### Directory Structure\n```\noc-tasks/\n├── bin/oc-tasks          # Executable shim\n├── src/\n│   ├── index.ts          # Entry point\n│   ├── db.ts             # Database layer (23KB - handles all SQL)\n│   ├── commands/         # Command implementations\n│   │   ├── add.ts\n│   │   ├── list.ts\n│   │   ├── done.ts\n│   │   └── ...\n│   ├── models/           # Type definitions\n│   ├── output/           # Formatters (table, json, minimal)\n│   └── sync/             # External system sync\n├── dist/                 # Compiled JavaScript\n└── package.json\n```\n\n## Contributing\n\nThis is a personal tool for OpenClaw workflows, but PRs welcome for:\n- macOS/Linux compatibility fixes\n- New output formats\n- Performance improvements\n- Bug fixes\n\n## License\n\nMIT\n\n## Author\n\n**kleinpanic** (Klein)  \nGitHub: [@kleinpanic](https://github.com/kleinpanic)\n\nPart of the OpenClaw agent ecosystem.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkleinpanic%2Foc-tasks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkleinpanic%2Foc-tasks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkleinpanic%2Foc-tasks/lists"}