# XControl

> XControl is an open-source agent for multi-agent frameworks. Runs coding agent CLIs in tmux panes, resumes sessions, and lets agents message each other. It is available on CLI, Linux and self-hosted.

- **Kind:** Agent
- **Pricing:** Open source
- **Platforms:** CLI, Linux, self-hosted
- **Repository:** https://github.com/faustinoaq/xcontrol
- **Categories:** [multi-agent frameworks](https://ai-powered.com/categories/multi-agent-frameworks), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says xcontrol started as a set of tmux scripts used to juggle agents across several project folders, then was cleaned up and shared. You describe a group of agents in a small TOML file, each bound to a project folder, a role label and a coding agent CLI, and xcontrol opens them together in one tmux session.

Once running, you can detach and reattach without losing the agents, check who is active, send a message to a specific pane from the command line, and stop the whole group. Agents can also find their peers and send short messages to each other, which land directly in the other agent's terminal with no queue.

It suits developers on Linux or WSL2 who already run Codex, Claude, Copilot or similar CLIs across multiple repositories and want them organized in one place. Usage-limit handling, manual pane switching and context compaction are also covered in the README.

## Features

- **Multi-agent tmux layout:** Starts a group of coding agent CLIs from one TOML file, each in its own folder and tmux pane.
- **Session resume:** Codex, Copilot and Claude resume prior conversations by default, with an option to start fresh.
- **Agent-to-agent messaging:** Agents look up peers and send short messages to each other's panes from the command line.
- **Switch CLI on usage limit:** Swaps the agent CLI in a single pane or all panes, passing role, terminal history and Git state along.
- **Automatic CLI selection:** Tries a list of candidate CLIs in order with a small model call and uses the first that responds.
- **Context compaction requests:** Asks a pane's CLI to compact its own context, with an optional auto-compact instruction for agents.

## Good for

- Coordinating separate Android, iOS and server agents across sibling project folders
- Resuming multi-agent coding sessions after detaching from a terminal
- Switching a stalled agent to another CLI when a usage limit is hit
- Sending a review request or blocker from one agent pane to another

## FAQ

### What operating systems does it support?

The README lists Linux or WSL2 as requirements, along with Python 3.11+, tmux and the agent CLIs installed and signed in.

### Which agent CLIs does it support?

The README lists Codex, Claude, Copilot, Antigravity (agy), Devin, Kiro (kiro-cli), Cursor (agent) and Grok, and says other CLIs can use custom commands.

### Does xcontrol make model calls on its own?

Some features do. Choosing an agent with auto candidates, switching without a CLI, and the access check commands make small model calls that count toward usage. Plain status, send and stop commands do not.

### What is the license?

The README says the project is MIT licensed.

### Is XControl free?

Yes. XControl is open source, so you can use and self-host it for free.

### What are the best alternatives to XControl?

The closest alternatives to XControl are timon, munder-difflin, Autonomous-Company, loopx and Codewhale.

## Where this comes from

- Description: written from the project's README.

## Alternatives

- [timon](https://ai-powered.com/agents/timon): timon is a freemium open-source agent for multi-agent frameworks.
- [munder-difflin](https://ai-powered.com/agents/munder-difflin): munder-difflin is an open-source agent for multi-agent frameworks.
- [Autonomous-Company](https://ai-powered.com/agents/autonomous-company): Autonomous-Company is an open-source agent for multi-agent frameworks.
- [loopx](https://ai-powered.com/agents/loopx): loopx is an open-source agent for developer tools.
- [Codewhale](https://ai-powered.com/agents/codewhale): Codewhale is an open-source agent for coding.
- [Codeium](https://ai-powered.com/agents/codeium): Codeium is a freemium hosted agent for generative code.
- [agent-orchestrator](https://ai-powered.com/agents/agent-orchestrator): agent-orchestrator is an open-source agent for coding.
- [qwen-code](https://ai-powered.com/agents/qwen-code): qwen-code is an open-source agent for coding.

---
Source: https://ai-powered.com/agents/xcontrol
