38 lines
2.9 KiB
Markdown
38 lines
2.9 KiB
Markdown
|
# byre
|
||
|
|
|
||
|
|
A server and macOS app for running many coding agents (Claude Code and Codex) in parallel on your own Mac, each on its own branch, with a lead agent that keeps track of them for you.
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
- **Tasks.** Each task gets its own git worktree, branch and port block. Talk to its agent in a live transcript; messages sent mid-turn reach it after its next tool call.
|
||
|
|
- **Lead agent.** One long-running agent per user watches every task, tells you what needs you, points the right pane at it, and starts, messages, merges or discards tasks when you ask. It keeps notes on how you work and passes them to task agents.
|
||
|
|
- **Inbox.** Agents ask structured questions with a recommended answer; you answer by clicking. macOS notifications for questions, turn summaries and errors.
|
||
|
|
- **Cross-vendor reviews.** Every turn that changes files is snapshotted and reviewed by the other vendor's model. Findings go back to the agent, and you can fix or ignore each one.
|
||
|
|
- **Snapshots and forks.** Step through a task's snapshots, diff any of them, and fork a new task from any one, conversation included.
|
||
|
|
- **Merge.** One click: the agent merges main in and resolves conflicts, then byre squashes, pushes and closes the task, with co-author trailers and a git note recording the task. Merge after review, and one merge per project at a time with a queue.
|
||
|
|
- **Subtasks and teams.** Agents can spawn subtasks on their own branches and merge them back, or several agents can share one worktree and talk through a board.
|
||
|
|
- **Workflows.** Named graphs of stages, each run as its own task, with fan-out and fan-in.
|
||
|
|
- **TODO.md.** A project's `TODO.md` items show on its dashboard; start or discuss one in a click.
|
||
|
|
- **Changes, Files and Terminal.** Per-task diff view with line comments sent to the agent, a read-only file browser, and a shell in the worktree.
|
||
|
|
- **Previews.** Agents expose dev servers over HTTPS through `tailscale serve`.
|
||
|
|
- **Screen and app control.** Agents can see and drive the Mac byre runs on (screen capture, accessibility, Orion, Chrome DevTools) and the Macs you have the app open on (shell, files, the same screen tools).
|
||
|
|
- **Status.** Running turns, stuck or zombie agent processes, rate-limit usage and connected clients.
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
|
||
|
|
macOS, Go, Xcode, [Tailscale](https://tailscale.com), and the `claude` and `codex` CLIs. Identity comes from Tailscale: byre only serves requests that arrive through `tailscale serve`.
|
||
|
|
|
||
|
|
## Running
|
||
|
|
|
||
|
|
Install the server as a launchd service and build the app as described under "Running as a service" and "macOS app" in [docs/operations.md](docs/operations.md). Point the app at byre's `tailscale serve` URL (`tailscale serve status` prints it).
|
||
|
|
|
||
|
|
## Docs
|
||
|
|
|
||
|
|
- [docs/operations.md](docs/operations.md): layout, data, service, APIs and how every feature works.
|
||
|
|
- [docs/macos.md](docs/macos.md): the macOS app.
|
||
|
|
- [AGENTS.md](AGENTS.md): rules for agents working on byre.
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
[Apache 2.0](LICENSE)
|