Imported from gabrielmoreira/agent-skills-mirror (
mirrors/repos/manaflow-ai@cmux/cmux-tui/AGENTS.md). Install upstream withnpx skills add gabrielmoreira/agent-skills-mirror --skill cmux-tui. Copyright stays with the author.
cmux-tui agent instructions
Do not run cargo, rustc, or Zig on Lawrence's Mac. Do not use a local build as a fallback. Commit and push the exact branch head, then use the hosted entry point from the repository root:
./scripts/verify-cmux-tui-hosted.sh --filter <rust-test-name>
./scripts/verify-cmux-tui-hosted.sh --full
Use --filter during focused development. It accepts one Rust test-name substring and verifies that the filter selects at least one test on hosted Linux and macOS. The reserved chatmux_relay (or chatmux-relay) selector runs the complete chatmux-relay package because Cargo test names do not include package names. Use --full for the merge gate. Full mode runs the complete Linux and macOS suites, package builds, and a Windows-hosted binary execution check.
The script rejects dirty or unpushed work, verifies the exact commit in every hosted job, waits for completion, prints failed logs, and downloads the macOS arm64 TUI and userland agent detector to cmux-tui/target/hosted/<commit>/cmux-tui and cmux-tui/target/hosted/<commit>/cmux-agent-screen-detection. Running those downloaded binaries on the Mac is allowed.
rust-toolchain.toml is the single Rust toolchain source for hosted TUI tests, package builds, and live conformance. Change that file instead of adding a workflow-specific Rust version.
Blacksmith Testbox
Blacksmith Testbox (remote Linux builds for cmux-tui): warm your own box before any cmux-tui Rust or Zig
build, and never compile cmux-tui on the Mac. The skill lives in cmuxterm-hq at
skills/infra/blacksmith-testbox/SKILL.md; the workflows, scripts/blacksmith-*.sh, and the
tests/test_testbox_* guards stay here. Quickest path: ./scripts/blacksmith-testbox-demo.sh.
