{"id":49360363,"url":"https://github.com/radiusmethod/crow","last_synced_at":"2026-04-27T16:02:04.908Z","repository":{"id":351693928,"uuid":"1193885939","full_name":"radiusmethod/crow","owner":"radiusmethod","description":"Native macOS session manager for AI-powered development — orchestrates git worktrees, Claude Code, and GitHub/GitLab issues in an embedded terminal.","archived":false,"fork":false,"pushed_at":"2026-04-24T18:39:17.000Z","size":3095,"stargazers_count":4,"open_issues_count":29,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-24T19:28:43.567Z","etag":null,"topics":["ai","claude-code","developer-tools","git-worktree","macos","swift","swiftui","terminal"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/radiusmethod.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"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}},"created_at":"2026-03-27T17:23:53.000Z","updated_at":"2026-04-24T17:34:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/radiusmethod/crow","commit_stats":null,"previous_names":["radiusmethod/crow"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/radiusmethod/crow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radiusmethod%2Fcrow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radiusmethod%2Fcrow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radiusmethod%2Fcrow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radiusmethod%2Fcrow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/radiusmethod","download_url":"https://codeload.github.com/radiusmethod/crow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radiusmethod%2Fcrow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32343571,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","claude-code","developer-tools","git-worktree","macos","swift","swiftui","terminal"],"created_at":"2026-04-27T16:02:01.937Z","updated_at":"2026-04-27T16:02:04.887Z","avatar_url":"https://github.com/radiusmethod.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Crow\n\nA native macOS application for managing AI-powered development sessions. Orchestrates git worktrees, Claude Code instances, and GitHub/GitLab issue tracking in a unified interface with an embedded Ghostty terminal.\n\n![Crow — AI-powered development session manager](docs/crow-screenshot.jpeg)\n\n## Prerequisites\n\n### System Requirements\n\n- **macOS 14.0+** (Sonoma or later)\n- **Apple Silicon** (arm64)\n- **Xcode** with Command Line Tools installed\n\n### Build Dependencies\n\n| Tool  | Version | Purpose                                | Install                                                                           |\n| ----- | ------- | -------------------------------------- | --------------------------------------------------------------------------------- |\n| Swift | 6.0+    | Compiler (ships with Xcode)            | `xcode-select --install`                                                          |\n| Zig   | 0.15.2  | Builds the Ghostty terminal framework  | `brew install zig` or [ziglang.org](https://ziglang.org/download/)                |\n| mise  | latest  | Task runner (optional)                 | `brew install mise`                                                               |\n\n### Runtime Dependencies\n\n| Tool     | Purpose                                                       | Install                                               |\n| -------- | ------------------------------------------------------------- | ----------------------------------------------------- |\n| `gh`     | GitHub CLI — issue tracking, PR status, project boards        | `brew install gh`                                     |\n| `git`    | Worktree management                                           | Ships with Xcode CLT                                  |\n| `claude` | Claude Code — AI coding assistant                             | [claude.ai/download](https://claude.ai/download)      |\n| `glab`   | GitLab CLI (optional, for GitLab repos)                       | `brew install glab`                                   |\n\n## Quick Start\n\n```bash\n# 1. Clone with submodules\ngit clone --recurse-submodules https://github.com/radiusmethod/crow.git\ncd crow\n\n# 2. Build (submodules + GhosttyKit + swift build in one shot)\nmake build\n\n# 3. Authenticate GitHub CLI — the write `project` scope is required\ngh auth login\ngh auth refresh -s project,read:org,repo\n\n# 4. Run\n.build/debug/CrowApp\n```\n\nOn first launch, a setup wizard guides you through choosing your development root directory and configuring workspaces. Alternatively, configure via the CLI without launching the GUI:\n\n```bash\n.build/debug/crow setup\n```\n\n\u003e **Note:** The required GitHub scope is the **write** `project` scope — `read:project` is insufficient because Crow updates ticket status via the `updateProjectV2ItemFieldValue` GraphQL mutation. See [docs/getting-started.md](docs/getting-started.md#3-github-authentication) for details.\n\n## Documentation\n\n- [**Getting Started**](docs/getting-started.md) — Clone, build, authenticate, and launch\n- [**CLI Reference**](docs/cli-reference.md) — Every `crow` subcommand and its flags\n- [**Architecture**](docs/architecture.md) — Packages, key components, data flow\n- [**Configuration**](docs/configuration.md) — File locations, workspace config, directory layout, session lifecycle\n- [**Troubleshooting**](docs/troubleshooting.md) — Build and runtime errors\n\n## Usage\n\n### The Sidebar\n\n- **Tickets** — Assigned issues grouped by project board status (Backlog, Ready, In Progress, In Review, Done in last 24h). Click a status to filter.\n- **Manager** — A persistent Claude Code terminal for orchestrating work. Use `/crow-workspace` here to create new sessions. Launches in `--permission-mode auto` by default so orchestration commands (`crow`, `gh`, `git`) run without per-call approval; opt out via Settings → General → Manager Terminal.\n- **Active Sessions** — One per work context. Shows repo, branch, issue/PR badges with pipeline and review status.\n- **Completed Sessions** — Sessions whose PRs have been merged or issues closed.\n\n### Creating a Session\n\nIn the Manager tab, tell Claude Code what you want to work on:\n\n```\n/crow-workspace https://github.com/org/repo/issues/123\n```\n\nOr use natural language:\n\n```\n/crow-workspace \"add authentication to the acme-api API\"\n```\n\nThis will:\n\n1. Create a git worktree with a feature branch\n2. Create a session with ticket metadata\n3. Launch Claude Code in plan mode with the issue context\n4. Auto-assign the issue and set its project status to \"In Progress\"\n\n## Features\n\n### Ticket Board\n\n- Pipeline view showing issues by project board status\n- Click a status to filter the list\n- \"Start Working\" button creates a workspace directly from an issue\n- Issues linked to active sessions show a navigation button\n\n### PR Status Tracking\n\n- Pipeline checks (passing/failing/pending)\n- Review status (approved/changes requested/needs review)\n- Merge readiness (mergeable/conflicting/merged)\n- Purple badge with checkmark for merged PRs\n\n### Auto-Complete\n\n- Sessions automatically move to \"Completed\" when their linked PR is merged or issue is closed\n- Checked every 60 seconds during the issue polling cycle\n\n### Orphan Recovery\n\n- On startup, scans git worktrees across all repos\n- Worktrees not tracked in the store are automatically recovered as sessions\n- Fetches ticket metadata and PR links from GitHub for recovered sessions\n\n### Safe Deletion\n\n- Deleting a session on a protected branch (main, master, develop) only removes the session metadata — the repo folder and branch are preserved\n- The delete confirmation dialog reflects this, showing \"Remove Session\" instead of \"Delete Everything\"\n\n## Development\n\n### Adding a New Package\n\n1. Create the package under `Packages/`\n2. Add it to the root `Package.swift` dependencies and target\n3. Import in the targets that need it\n\n### Testing\n\n```bash\nmake test     # or: swift test, or: mise test\n```\n\nTests use the [Swift Testing](https://developer.apple.com/documentation/testing/) framework (`@Test` macros). Test files live under `Packages/*/Tests/`.\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on reporting bugs, suggesting features, and submitting pull requests.\n\n## Releases\n\nOfficial releases are signed and notarized via GitHub Actions. Download the latest DMG from the [Releases](https://github.com/radiusmethod/crow/releases) page — it will install without Gatekeeper warnings.\n\n**Building from source:** Code signing is only required for distribution. Developers building from source do not need a signing certificate — `make build` and `make release` produce unsigned but fully functional builds. If macOS quarantines an unsigned `.app`, remove it with:\n\n```bash\nxattr -cr Crow.app\n```\n\n## License\n\nApache 2.0 — see [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradiusmethod%2Fcrow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fradiusmethod%2Fcrow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradiusmethod%2Fcrow/lists"}