Xylocopa CLI
Xylocopa is a visual orchestrator for Claude Code agents: GTD tasks, parallel agents in git worktrees, phone approvals.
- 54 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- It runs many Claude Code agents with access to your projects and command execution.
- It exposes agent control over the network from a phone, which needs a password, HTTPS and restricted access.
Install
- Works in
Manual install
curl -fsSL https://raw.githubusercontent.com/jianpengyao/xylocopa/master/setup.sh | bashThe Getting Started command from the README. The installer clones into `~/xylocopa-main` and asks for directories and ports.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- It runs many Claude Code agents with access to your projects and command execution.
- It exposes agent control over the network from a phone, which needs a password, HTTPS and restricted access.
This is third-party code. Review the repository files before installing.
What it does
Xylocopa deploys on your own server and runs Claude Code agents through a GTD loop. Tasks enter an inbox by voice or text, one click turns a task into an agent, and each agent works in its own git worktree. Plans and tool calls are approved in chat, and notifications arrive when you are away. Each agent lives in a tmux session that can be attached from a terminal or the browser. Lessons land in the project's `PROGRESS.md` and are retrieved for later agents, and a stopped attempt is summarized automatically. The installer sets up the app with a self-signed certificate, and on a phone it installs as a PWA.
Who it is for. Developers with several projects who run Claude Code on a server and want to manage many tasks from a phone.
Good fit when
- Five tasks must be spread over agents with a notification only when your answer is needed.
- An agent stopped and the next one should start from a short summary of the attempt, not from zero.
- You want to attach to a live agent session from a phone browser.
- You want lessons to accumulate in `PROGRESS.md` and be fed to new agents.
Not a fit when
- Work runs with one agent in one terminal.
- No Linux or macOS server with tmux is at hand.
- A third-party installer from the network cannot be run.
Example request
Create three tasks in Xylocopa, start an agent for each and notify me when my answer is needed.Limitations
Linux or macOS, Node.js 18 or newer, Python 3.11 or newer, tmux and a signed-in Claude Code CLI are required. A Claude Pro or Max subscription is enough. Installation runs the `setup.sh` script from the network, so read it first. Arrange outside access through a private network or Tailscale, since password auth, an inactivity lock and HTTPS are built in. Agents get rights over your projects, and the SQLite database sits in the install directory.
How to disable. Stop the services through pm2 and delete the `~/xylocopa-main` directory. Claude Code sessions stay in `~/.claude/projects/` and lessons stay in each project's `PROGRESS.md`.
FAQ
What does installation need?
Linux or macOS, Node.js 18 or newer, Python 3.11 or newer, tmux and a Claude Code CLI signed in by running `claude`.
How do I connect from a phone?
Open `https://<server-address>:3000` in Safari or Chrome, trust the self-signed certificate and add the app to the Home Screen. Tailscale works for outside access.
Where is data stored?
The SQLite database lives in the install directory, sessions stay as Claude Code's native JSONL in `~/.claude/projects/` and lessons live in each repository's `PROGRESS.md`.
How do agents work in parallel?
Each agent gets its own git worktree and tmux session, so one agent's edits do not disturb another's.
Are there reminders and schedules?
Yes, attention jobs are compiled from plain phrases such as wake me when the GPU frees up and combine time, interval, state and webhook triggers.
Discussion
No questions or reviews yet.
Related
CLI toolsOne desktop window for Claude Code, Codex, Gemini CLI and OpenCode: terminals, pull requests, diffs and approvals
Streams Claude Code hidden thinking, tool calls and subagents to a separate terminal with a live session tree
A workflow template for Claude Code and five more agents: a backlog task, a diff review and a commit.
Claude Code kit with eight phase agents, 21 skills and hooks that keep the agent inside set limits.
Over twenty skills for coding agents: MCP and hooks, plan mode, a bug-fix protocol, prompting and a bash safety hook
A tool and skill that let Claude Code hand tasks to Claude, Codex or OpenCode subagents in separate Git worktrees
README in short
The loop follows GTD: capture, dispatch to an agent, monitor, review and remember lessons. CLI sessions show up in the web app and sync runs both ways.