Back to search
amux
MarketplaceWorks with Claude CodeGitHub
amux for Claude Code: delegate work to background agents and check on them.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/mixpeek--amux-plugins)HTML
<a href="/listings/mixpeek--amux-plugins"><img src="/api/listings/mixpeek--amux-plugins/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**Claude Code**
/plugin install amux --marketplace mixpeek/amux-plugins
On Claude Code older than 2.1.275, run `/plugin marketplace add mixpeek/amux-plugins`, then `/plugin install amux@amux`.
**Codex**
codex plugin marketplace add mixpeek/amux-plugins codex plugin add amux@amux
**Gemini CLI**
gemini extensions install https://github.com/mixpeek/amux-plugins
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 17 lines
- {
- "name": "amux",
- "description": "amux for Claude Code: delegate work to background agents and check on them.",
- "owner": {
- "name": "Mixpeek",
- "url": "https://amux.io"
- },
- "plugins": [
- {
- "name": "amux",
- "source": "./plugins/amux",
- "description": "Hand tasks to background Claude Code, Codex and Gemini CLI workers that keep running after your session ends, check on them, and set up amux, the self-hosted control plane for running an AI engineering team from one board or your phone.",
- "category": "productivity",
- "homepage": "https://amux.io"
- }
- ]
- }
README.md · README · 86 lines · 1 finding marked
- # amux plugins for Claude Code, Codex and Gemini CLI
- Hand a task to a background agent that keeps working after your session ends,
- check on your agents, and set up [amux](https://amux.io) from inside the coding
- agent you already use.
- amux is a self-hosted control plane for running an AI engineering team from one
- board or your phone. It runs Claude Code, Codex and Gemini CLI agents in
- parallel as named workers, with a shared task board, a scheduler, and an iPhone
- app. Self-host it free, or use [amux Cloud](https://amux.io/start/?source=amux-plugins-readme)
- for a dedicated server that stays on when your laptop sleeps.
- ## Install
- **Claude Code**
- ```text
- /plugin install amux --marketplace mixpeek/amux-plugins
- ```
- On Claude Code older than 2.1.275, run `/plugin marketplace add mixpeek/amux-plugins`, then `/plugin install amux@amux`.
- **Codex**
- ```bash
- codex plugin marketplace add mixpeek/amux-plugins
- codex plugin add amux@amux
- ```
- **Gemini CLI**
- ```bash
- gemini extensions install https://github.com/mixpeek/amux-plugins
- ```
- ## What you get
- | Skill | Claude Code | Codex | Gemini CLI | What it does |
- |---|---|---|---|---|
- | setup | `/amux:setup` | `$amux:setup` | `/amux:setup` | Checks for amux, offers the free self-hosted install or amux Cloud, prints the dashboard address |
- | delegate | `/amux:delegate` | `$amux:delegate` | `/amux:delegate` | Starts a background Claude Code, Codex or Gemini CLI worker on your repo and sends it the task, or files it on the amux board |
- | status | `/amux:status` | `$amux:status` | `/amux:status` | Lists which workers are waiting on you, which look stuck, and what is on the board |
- The agent can also pick these up on its own when you ask for work "in the
- background", "overnight" or "in parallel".
- Every skill runs the `amux` command line against the amux server on your own
- machine; Mixpeek receives nothing. Where data goes:
- - `status` reads your workers' state and your board cards, which can contain
- names or email addresses you put there. It stores nothing.
- - `delegate` sends the task text to your local amux server, which types it into
- the worker you chose. That worker is Claude Code, Codex or Gemini CLI running
- under your own account, so the task reaches that agent's model provider
- (Anthropic, OpenAI or Google) the same way it would if you typed it there.
- - `setup` downloads the amux installer from amux.io and github.com, and only
- after you say yes.
- The plugin asks before it installs software or starts a worker.
- ## Requirements
- - macOS or Linux.
- - amux itself: `curl -fsSL https://amux.io/install.sh | bash` (needs git, tmux
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 64 on GitHub
- and a Rust toolchain), or `/amux:setup` walks you through it.
- - For a Codex or Gemini CLI worker, that CLI installed and signed in.
- ## Layout
- ```text
- .claude-plugin/marketplace.json Claude Code marketplace
- .agents/plugins/marketplace.json Codex marketplace
- gemini-extension.json, GEMINI.md Gemini CLI extension
- commands/amux/*.toml Gemini commands, generated from the skills
- plugins/amux/ the plugin: skills/ plus Claude and Codex manifests
- ```
- The three skills in `plugins/amux/skills/` are the only source. After editing
- one, run `python3 scripts/sync-gemini.py` to regenerate the Gemini commands;
- CI fails when they are out of date.
- ## License
- MIT + Commons Clause, the same as [amux](https://github.com/mixpeek/amux).
- Source-available: free to use and modify, including at work; you may not sell
- it.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.