Multiplex AGENTS.md

A repository guide for Multiplex, a spatial SSH terminal that monitors remote computers through tmux, a tool for managing terminal sessions. It describes the app's architecture and how its visionOS and iPadOS builds are organized.

In plain words
What is it for?
Use it when changing Multiplex, its generated Xcode project setup, architecture, or tests. It covers building and running unit tests in an Apple Vision Pro simulator without device input/output.
Why use it?
It helps agents find the right project files and follow the required build and test process. It also identifies the design and architecture documents to read before changing an area.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/multiplex-term/multiplex/agents-md
Clone the repo
git clone --depth 1 https://github.com/multiplex-term/Multiplex

Made for: Codex, OpenCode.

Per session 1,630 This file is loaded in full into every session.
When invoked 1,630 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01630 $0.01630
Opus 5 $0.00815 $0.00815
Sonnet 5 $0.00326 $0.00326
Haiku 4.5 $0.00163 $0.00163

Measured yesterday against content hash 0ab72c226985, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

Multiplex AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 122 lines

How it starts

The opening of the file, as written. The whole thing — 122 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Multiplex — a spatial SSH terminal built around remote tmux (with herdr as an optional second backend); visionOS-first, iPadOS alongside. The deck is a fleet-wide monitor wall: every host probes concurrently, every session renders as a live capture-pane tile, and each attach opens its own terminal window (a scene on visionOS / Stage Manager on iPad). Product tour: README.md; visual system + rationale: DESIGN.md (the TALLY identity; bake-off record in docs/design-bakeoff.md).

Build & test

The Xcode project is generated by XcodeGen — edit project.yml, never the .xcodeproj (git-ignored). After changing project.yml, adding/removing sources, or touching a vendored package's manifest: xcodegen generate.

Build / test / run use Tools/build.sh (see the build-and-verify skill for the full workflow). Quick reference:

# Build
xcodebuild -project Multiplex.xcodeproj -scheme Multiplex \
  -destination 'platform=visionOS Simulator,name=Apple Vision Pro' \
  -derivedDataPath DerivedData build

# Unit tests — fast, no device I/O
xcodebuild -project Multiplex.xcodeproj -scheme MultiplexTests \
  -destination 'platform=visionOS Simulator,name=Apple Vision Pro' test

# iPad target: -destination 'platform=iOS Simulator,name=iPad Pro 13-inch (M5)'

Always keep -derivedDataPath DerivedData, and never run iPad and visionOS builds concurrently against it (the build DB locks).

Lint: ./Tools/build.sh lint (brew install swiftlint; --fix applies correctable rules). Runs --strict: the tree stays at zero violations. Deliberately not an Xcode build phase (script sandboxing would demand a regenerated input-file list, and contributors without SwiftLint must still build). .swiftlint.yml deviates from the defaults only with an in-file reason — keep it that way (size metrics, trailing_comma, and optional_data_string_conversion are off by design, reasons in the file). Where one line genuinely can't comply, use a scoped // swiftlint:disable:next <rule> with the reason above it; prefer fixing the code.

CI is split by platform and filters out unrelated paths. The macOS workflow (.github/workflows/ci-macos.yml, macos-26 — Xcode 26 and the visionOS 26 simulator runtime) is Tools/build.sh gen, lint, then build + test for visionOS and iPad in sequence, sequential because of the DerivedData lock above. The Linux workflow (.github/workflows/ci-linux.yml) runs only when its metadata inputs change. It executes ruby Tools/check-metadata.rb, which needs neither Xcode nor gems and so answers in seconds: it holds the TestFlight changelog and the App Store listing files to the App Store Connect caps and the vetted glyph set in Tools/metadata_limits.rb (shared with fastlane/Fastfile, so a lane and a pull request can never disagree about them). Run it locally before committing metadata.

Read the full file on GitHub · 122 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 122 lines · 1,630 tokens per session scan A 0ab72c226985

Subscribe to this mod's changes

Multiplex AGENTS.md is an instructions file published in the GitHub repository multiplex-term/Multiplex (10 stars, last pushed 5d ago), licensed Apache-2.0. It adds 1,630 tokens to every session, about $0.0081 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.