Skip to content
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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mixpeek--amux-plugins/badge.svg)](/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
  1. {
  2. "name": "amux",
  3. "description": "amux for Claude Code: delegate work to background agents and check on them.",
  4. "owner": {
  5. "name": "Mixpeek",
  6. "url": "https://amux.io"
  7. },
  8. "plugins": [
  9. {
  10. "name": "amux",
  11. "source": "./plugins/amux",
  12. "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.",
  13. "category": "productivity",
  14. "homepage": "https://amux.io"
  15. }
  16. ]
  17. }
README.md · README · 86 lines · 1 finding marked
  1. # amux plugins for Claude Code, Codex and Gemini CLI
  2. Hand a task to a background agent that keeps working after your session ends,
  3. check on your agents, and set up [amux](https://amux.io) from inside the coding
  4. agent you already use.
  5. amux is a self-hosted control plane for running an AI engineering team from one
  6. board or your phone. It runs Claude Code, Codex and Gemini CLI agents in
  7. parallel as named workers, with a shared task board, a scheduler, and an iPhone
  8. app. Self-host it free, or use [amux Cloud](https://amux.io/start/?source=amux-plugins-readme)
  9. for a dedicated server that stays on when your laptop sleeps.
  10. ## Install
  11. **Claude Code**
  12. ```text
  13. /plugin install amux --marketplace mixpeek/amux-plugins
  14. ```
  15. On Claude Code older than 2.1.275, run `/plugin marketplace add mixpeek/amux-plugins`, then `/plugin install amux@amux`.
  16. **Codex**
  17. ```bash
  18. codex plugin marketplace add mixpeek/amux-plugins
  19. codex plugin add amux@amux
  20. ```
  21. **Gemini CLI**
  22. ```bash
  23. gemini extensions install https://github.com/mixpeek/amux-plugins
  24. ```
  25. ## What you get
  26. | Skill | Claude Code | Codex | Gemini CLI | What it does |
  27. |---|---|---|---|---|
  28. | setup | `/amux:setup` | `$amux:setup` | `/amux:setup` | Checks for amux, offers the free self-hosted install or amux Cloud, prints the dashboard address |
  29. | 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 |
  30. | status | `/amux:status` | `$amux:status` | `/amux:status` | Lists which workers are waiting on you, which look stuck, and what is on the board |
  31. The agent can also pick these up on its own when you ask for work "in the
  32. background", "overnight" or "in parallel".
  33. Every skill runs the `amux` command line against the amux server on your own
  34. machine; Mixpeek receives nothing. Where data goes:
  35. - `status` reads your workers' state and your board cards, which can contain
  36. names or email addresses you put there. It stores nothing.
  37. - `delegate` sends the task text to your local amux server, which types it into
  38. the worker you chose. That worker is Claude Code, Codex or Gemini CLI running
  39. under your own account, so the task reaches that agent's model provider
  40. (Anthropic, OpenAI or Google) the same way it would if you typed it there.
  41. - `setup` downloads the amux installer from amux.io and github.com, and only
  42. after you say yes.
  43. The plugin asks before it installs software or starts a worker.
  44. ## Requirements
  45. - macOS or Linux.
  46. - 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
  47. and a Rust toolchain), or `/amux:setup` walks you through it.
  48. - For a Codex or Gemini CLI worker, that CLI installed and signed in.
  49. ## Layout
  50. ```text
  51. .claude-plugin/marketplace.json Claude Code marketplace
  52. .agents/plugins/marketplace.json Codex marketplace
  53. gemini-extension.json, GEMINI.md Gemini CLI extension
  54. commands/amux/*.toml Gemini commands, generated from the skills
  55. plugins/amux/ the plugin: skills/ plus Claude and Codex manifests
  56. ```
  57. The three skills in `plugins/amux/skills/` are the only source. After editing
  58. one, run `python3 scripts/sync-gemini.py` to regenerate the Gemini commands;
  59. CI fails when they are out of date.
  60. ## License
  61. MIT + Commons Clause, the same as [amux](https://github.com/mixpeek/amux).
  62. Source-available: free to use and modify, including at work; you may not sell
  63. it.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.