{"id":48838868,"url":"https://github.com/boatclaw/boatclaw","last_synced_at":"2026-04-18T11:24:07.851Z","repository":{"id":351102472,"uuid":"1208123085","full_name":"boatclaw/boatclaw","owner":"boatclaw","description":"AI-powered task automation - connect your project board to AI, tasks become pull requests automatically","archived":false,"fork":false,"pushed_at":"2026-04-14T23:20:40.000Z","size":488,"stargazers_count":3,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-15T01:41:56.126Z","etag":null,"topics":["ai","automation","automations","claude","cli","codex","cursor","developer-tools","github","jira","linear","productivity","trello"],"latest_commit_sha":null,"homepage":"https://boatclaw.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/boatclaw.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","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},"funding":{"github":["isializada"]}},"created_at":"2026-04-11T21:10:51.000Z","updated_at":"2026-04-14T23:17:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/boatclaw/boatclaw","commit_stats":null,"previous_names":["boatclaw/boatclaw"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/boatclaw/boatclaw","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boatclaw%2Fboatclaw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boatclaw%2Fboatclaw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boatclaw%2Fboatclaw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boatclaw%2Fboatclaw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boatclaw","download_url":"https://codeload.github.com/boatclaw/boatclaw/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boatclaw%2Fboatclaw/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31863499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"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","automation","automations","claude","cli","codex","cursor","developer-tools","github","jira","linear","productivity","trello"],"created_at":"2026-04-15T01:01:16.869Z","updated_at":"2026-04-18T11:24:07.841Z","avatar_url":"https://github.com/boatclaw.png","language":"TypeScript","readme":"# Boatclaw\n\nAI-powered task automation for development teams.\n\nConnect your project board to AI — tasks become pull requests automatically.\n\n[![npm version](https://img.shields.io/npm/v/boatclaw.svg)](https://www.npmjs.com/package/boatclaw)\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D18-green.svg)](https://nodejs.org)\n\n**[boatclaw.dev](https://boatclaw.dev)**\n\n---\n\n## How it works\n\n```\nBoard Card  →  AI Agent  →  GitHub PR\n```\n\n1. Create a card in your trigger list (e.g., \"Todo\")\n2. Boatclaw picks it up, moves to \"In Progress\"\n3. AI implements the task in your codebase\n4. Pull request created automatically\n5. Card moves to \"Done\"\n\n## Supported Platforms\n\n### Project Boards\n- **Trello** - Kanban boards\n- **Jira** - Atlassian projects\n- **Linear** - Modern issue tracking\n\n### AI Providers\n- **Claude Code** - Full support with interactive mode\n- **Cursor** - Basic support\n- **Codex** - Basic support (OpenAI)\n\n## Install\n\n```bash\nnpm install -g boatclaw\n```\n\n## Quick Start\n\n```bash\nboatclaw setup     # Interactive setup wizard\nboatclaw start     # Start the worker\n```\n\n## Requirements\n\n- Node.js 18+\n- AI CLI installed and authenticated:\n  - [Claude Code](https://claude.ai/code) (recommended)\n  - [Cursor](https://cursor.sh)\n  - OpenAI API key (for Codex)\n- Board API credentials (Trello/Jira/Linear)\n- GitHub token (optional, for auto PR creation)\n\n## Commands\n\n```bash\nboatclaw setup              # Setup wizard\nboatclaw status             # View configuration\nboatclaw start              # Start worker\nboatclaw start --dry-run    # Test mode (no changes)\nboatclaw start --interactive # Enable ask_human mode (Claude only)\n\nboatclaw projects           # Manage projects\nboatclaw agents             # Manage AI agents/roles\nboatclaw context            # Manage AI context files\n\nboatclaw github setup       # Configure GitHub integration\nboatclaw reset              # Reset configuration\n```\n\n## Configuration\n\nAll config stored in `~/.boatclaw/config.yaml`\n\n### Projects\n\nYour codebases that agents work on:\n- Local path to the repository\n- GitHub repo (owner/repo) for PR creation\n- Context file (e.g., CONTEXT.md with tech stack info)\n- Base branch and branch prefix\n\n### Agents (Roles)\n\nAI workers that pick up tasks based on labels:\n- **Labels** - Which card labels trigger this agent\n- **Projects** - Which projects this agent can work on\n- **Model** - AI model (haiku/sonnet/opus/auto)\n- **Context** - Custom instructions for this agent\n\n### Workflow\n\nMap board lists/statuses to workflow stages:\n- **Trigger** - Tasks picked up here (e.g., \"Todo\")\n- **Working** - Currently being processed (e.g., \"In Progress\")\n- **Review** - PR created, awaiting review (optional)\n- **Success** - Completed successfully (e.g., \"Done\")\n- **Failed** - Error occurred (e.g., \"Canceled\")\n\n## Interactive Mode (Claude Code only)\n\nWhen enabled, Claude can ask clarifying questions during task execution:\n\n```bash\nboatclaw start --interactive\n```\n\nHow it works:\n1. Claude encounters an ambiguous task\n2. Posts a question as a comment on the ticket\n3. Waits for your reply (comment starting with \"Answer:\")\n4. Continues with your guidance\n\nThis uses Claude's MCP (Model Context Protocol) to enable two tools:\n- `ask_human` - posts a question, waits for reply\n- `post_update` - posts progress updates without blocking\n\n## Example\n\n```bash\n# Setup your board and projects\nboatclaw setup\n\n# Start watching for tasks\nboatclaw start\n```\n\nCreate a card on your board:\n\u003e **Title:** Add user authentication\n\u003e **Label:** backend\n\u003e **Description:** Implement JWT-based auth for the API\n\nBoatclaw will:\n1. Move card to \"In Progress\"\n2. Run AI on your backend project\n3. Create a PR with the implementation\n4. Add completion summary as comment\n5. Move card to \"Done\"\n\n## Multi-Project Support\n\nOne card can trigger work across multiple projects. Configure agents with:\n```yaml\nroles:\n  fullstack:\n    labels: [fullstack]\n    projects: ['*']  # All projects\n    model: opus\n```\n\nWhen an agent has 2+ projects, Boatclaw runs a **planning phase** before execution:\n\n1. Analyzes the task to decide which projects actually need changes\n2. Determines execution order (e.g., backend API first, then frontend)\n3. Detects shared contracts/APIs between projects\n4. Posts the plan to the ticket for transparency\n\n**How context flows between projects:**\n- Each project runs in its own session\n- Before starting the next project, Boatclaw re-fetches ticket comments\n- The previous project's completion summary is passed as context\n- If a cross-project task has shared contracts and one project fails, remaining projects are aborted\n\n**Planner model** — uses `haiku` by default (fast, cheap). Configurable:\n```yaml\nai:\n  plannerModel: haiku  # or sonnet, opus\n```\n\n## Review Phase\n\nAfter task completion, cards move to the review list where an AI reviewer:\n- Reviews the actual PR (if created) or local git diff\n- Only reviews projects that were in the plan (not all role projects)\n- Approves or requests changes\n- Moves card to Done (approved) or Failed (rejected)\n\nAll projects must pass review for the card to reach Done.\n\n## Vision\n\nAI is getting good at writing code. What's missing is the automation around it — the glue between \"here's what I want\" and \"here's your pull request.\"\n\nBoatclaw is built on a simple belief: developers should focus on thinking, not typing. Describe what you want on your board, and AI agents handle the implementation. Today that means reviewing PRs. Tomorrow it means trusting the full pipeline — from idea to production.\n\nWe're working toward a world where one person with good ideas and clear thinking can do the work of an entire team. Not by working harder, but by letting AI handle the repetitive parts of building software.\n\n## Roadmap\n\nWhat we're working on next:\n\n- [ ] Test suite — unit and integration tests for reliability\n- [ ] Smarter context handling — auto-detect tech stack, read existing code patterns\n- [ ] Webhook mode — real-time triggers instead of polling\n- [ ] More AI providers — Gemini, GitHub Copilot\n- [ ] More platforms — GitLab, Bitbucket, Asana, GitHub Projects\n- [ ] Auto-review — AI reviews its own PRs before requesting human review\n- [ ] Notifications — Slack, Discord, email updates on task progress\n- [ ] Auto-merge — configurable trust levels for automatic merging\n- [ ] Dashboard — web UI for monitoring agents and task history\n- [ ] Multi-agent collaboration — agents that review each other's work\n\nHave ideas? [Open an issue](https://github.com/boatclaw/boatclaw/issues).\n\n## Development\n\n```bash\ngit clone https://github.com/boatclaw/boatclaw.git\ncd boatclaw\nnpm install\nnpm run build\nnpm link\n```\n\n## Contributing\n\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## Security\n\nTo report a vulnerability, please see [SECURITY.md](SECURITY.md).\n\n## License\n\n[MIT](LICENSE)\n\n","funding_links":["https://github.com/sponsors/isializada"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboatclaw%2Fboatclaw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboatclaw%2Fboatclaw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboatclaw%2Fboatclaw/lists"}