Multiplex: Instructions file for Codex

AGENTS.md

Multiplex AGENTS.md is an instructions file for Codex, OpenCode from multiplex-term/Multiplex. It costs 1,642 tokens per session, scanned A, original, Apache-2.0.

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

Written for Codex and OpenCode: the file is AGENTS.md.

This is multiplex-term/Multiplex's own configuration. It tells Codex and OpenCode how to work on Multiplex itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything Multiplex configures →

Reuse

Borrowing it

Nothing to install: this file belongs to multiplex-term/Multiplex. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/multiplex-term/Multiplex/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/multiplex-term/Multiplex

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for Multiplex AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/multiplex-term/multiplex/agents-md/github.svg)](https://agentmods.dev/instructions/multiplex-term/multiplex/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/multiplex-term/multiplex/agents-md"><img src="https://agentmods.dev/badge/instructions/multiplex-term/multiplex/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for Multiplex AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/multiplex-term/multiplex/agents-md"><img src="https://agentmods.dev/badge/instructions/multiplex-term/multiplex/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,642 This file is loaded in full into every session.
When invoked 1,642 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.01642 $0.01642
Opus 5.5 $0.00657 $0.00657
Sonnet 5.5 $0.00328 $0.00328
Haiku 4.5 $0.00164 $0.00164

Measured today against content hash 8324278adcba, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, 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 today.

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, the xcode-27 runner) runs three parallel jobs: Tools/build.sh lint, and one runner each for visionOS and iPad doing gen, build, test — separate runners, so the DerivedData lock above does not apply. 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. today Changed · +4 tokens per session 8324278adcba
  2. 13d ago Changed · +6 tokens per session 4abed6f7e84f
  3. 29d ago Changed · +2 lines · +37 tokens per session 11ea14b088cc
  4. 1mo ago Changed · -2 lines · -35 tokens per session e4c86182d703
  5. 2mo ago 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 (15 stars, last pushed today), licensed Apache-2.0. It adds 1,642 tokens to every session, about $0.0066 per session on Opus 5.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.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,461 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,750 tokens

deno copilot-instructions.md

Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.

denoland/deno · 3,077 tokens