relaybridge AGENTS.md

relaybridge AGENTS.md is an instructions file for Codex, OpenCode from maximyz3d/relaybridge. It costs 538 tokens per session, scanned B, original, MIT.

A set of AGENTS.md instructions for using the RelayBridge project, a local service that routes requests to AI command-line tools.

In plain words
What is it for?
It guides agents through context retrieval, provider checks, safe routing, terminal sessions, and receipt or run tracking.
Why use it?
It gives agents a defined workflow for checking readiness, previewing requests, routing work, and tracking results.

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/maximyz3d/relaybridge/agents-md
Clone the repo
git clone --depth 1 https://github.com/maximyz3d/relaybridge

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 relaybridge AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/maximyz3d/relaybridge/agents-md.svg)](https://agentmods.dev/instructions/maximyz3d/relaybridge/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/maximyz3d/relaybridge/agents-md"><img src="https://agentmods.dev/badge/instructions/maximyz3d/relaybridge/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 538 This file is loaded in full into every session.
When invoked 538 The same file — it is already loaded in full.
Security scan B 1 finding. 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.00538 $0.00538
Opus 5 $0.00269 $0.00269
Sonnet 5 $0.00108 $0.00108
Haiku 4.5 $0.00054 $0.00054

Measured 3d ago against content hash 2d3634a0e82a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

relaybridge AGENTS.md scanned grade B with 1 finding 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 3d ago.

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.

Unrestricted tool accessmediumExcessive agency

A wildcard tool grant or "run any command" leaves no least-privilege boundary at all.

`start_safe_session(kind:"powershell")` opens a real host PowerShell process. `send_session_input` can execute arbitrary commands under the user's account after host approval. RelayBridge is not a filesystem sandbox.
AGENTS.md · 68 lines

How it starts

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

RelayBridge Agent Guide

This repository contains RelayBridge, a local Windows PowerShell and AI CLI control plane with browser, REST, and MCP interfaces.

First Call

When connected through MCP, call get_context_bundle first. It returns the bounded handoff packet: health, provider readiness, active work, terminal tails, collaborations, projects, runs, receipts, registry fingerprints, and exact follow-up tools for omitted detail.

Safe Workflow

  1. Use bridge_status and list_providers when you need current readiness.
  2. Use route_preview before spending a hosted provider call.
  3. Use route_and_ask for one bounded routed provider response.
  4. Use run_committee for independent advisory responses from multiple providers.
  5. Use list_runs, get_run, list_receipts, and get_receipt for provenance.

For concurrent raw REST calls, generate a unique requestId per call and keep the direct requestId/invocationId/receiptId tuple together. Never assign a detached response by selecting the newest receipt.

Terminal Control

start_safe_session(kind:"powershell") opens a real host PowerShell process. send_session_input can execute arbitrary commands under the user's account after host approval. RelayBridge is not a filesystem sandbox.

Use terminal tools only when the user has authorized host execution or when the current task clearly requires it. Prefer read-only discovery and provider routing for analysis.

Environment

Preferred variables:

  • RELAYBRIDGE_URL
  • RELAYBRIDGE_TOKEN
  • RELAYBRIDGE_TOKEN_FILE
  • RELAYBRIDGE_CONFIG_FILE
  • RELAYBRIDGE_DATA_DIR
  • RELAYBRIDGE_ALLOWED_ROOTS

Legacy PS_BRIDGE_* variables remain supported for older installations.

Security Boundary

RelayBridge binds to 127.0.0.1. The capability token controls REST, WebSocket, and MCP access. Do not print the token in logs, chat, issues, pull requests, or documentation.

Do not commit runtime files:

  • .bridge-token
  • .state.json
  • .mcp-start.lock
  • data/
  • node_modules/
  • *.log

Read the full file on GitHub · 68 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. 3d ago First seen · 68 lines · 538 tokens per session scan B 2d3634a0e82a

Subscribe to this mod's changes

relaybridge AGENTS.md is an instructions file published in the GitHub repository maximyz3d/relaybridge (0 stars, last pushed 3d ago), licensed MIT. It adds 538 tokens to every session, about $0.0027 per session on Opus 5. A static security scan graded it B with 1 finding (unrestricted tool access). 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 · 6,785 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,182 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,345 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, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

next.js 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,296 tokens