amx

agent
Security Audit
Warn
Health Warn
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 7 GitHub stars
Code Warn
  • process.env — Environment variable access in assets/opencode/tui.js
  • process.env — Environment variable access in assets/pi/amx-subagent.ts
  • process.env — Environment variable access in assets/pi/amx.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Run coding agents as tmux panes

README.md

amx

amx

website · install · quick start · docs

latest release CI status MIT or Apache-2.0


https://github.com/user-attachments/assets/a4dac175-5291-4f8e-b8fe-1f94594e24ab

Run coding agents as tmux panes.

  • Ordinary panes, no daemon. Every agent is the real claude, codex, pi or opencode in a tmux session of its own. amx starts it and watches from the outside. Attaching is plain tmux, and killing amx stops nothing.
  • One view for all of them. Run amx to see every agent grouped by project, marked working, waiting or done, with what it is doing right now. The view →
  • Answer without switching. Permission prompts and questions open as cards. Press y, pick a number or type a reply, from the view or from a script with amx answer.
  • A worktree each. In a git repository every agent gets its own worktree and branch, with its pull request number on the row. amx diff shows what it changed and amx sweep clears what landed. Worktrees →
  • Scriptable, by you or by an agent. amx result waits and prints the answer, and the exit code says done, failed, blocked on a question or timed out. An agent can fan work out with amx sub and collect it. Scripting →
  • Pick up where it stopped. amx resume restarts a stopped agent on its recorded session, and amx fork copies a conversation into a second agent.
  • One small binary. Prebuilt for Linux and macOS, under 6 MB. State is plain JSON under ~/.local/state/amx.

Install

curl -fsSL https://saifulapm.github.io/amx/install.sh | sh

or cargo install --git https://github.com/saifulapm/amx · binaries

amx needs tmux 3.2 or newer. Wire up the agents you use, then check the machine:

amx setup claude    # or pi, codex, opencode
amx doctor

Use

amx new "fix the flaky login test"
amx new "add pagination to /api/orders"
amx                 # open the view

In the view, space opens an agent's card, enter attaches to its pane and ? lists every key. Quick start →

Docs

Everything is at saifulapm.github.io/amx/docs: quick start · the view · commands · scripting · worktrees · agents · configuration · how it works

Development

git clone https://github.com/saifulapm/amx
cd amx
cargo build --release
cargo test          # the end-to-end suites drive real tmux servers

License

amx is licensed under either of MIT or Apache-2.0, at your option.

Reviews (0)

No results found