synapse: Instructions file for Codex

AGENTS.md

synapse AGENTS.md is an instructions file for Codex, OpenCode from RedberryProducts/synapse. It costs 5,309 tokens per session, scanned B, original, MIT.

A set of instructions for contributors to Synapse, a Laravel package, which is reusable software built for the Laravel PHP framework.

In plain words
What is it for?
Use it when changing Synapse code, frontend files, chat or streaming features, build artifacts, tests, or release-related work.
Why use it?
It sets the project sources of truth, planning expectations, and checks required before reporting a change as complete.

Instructions file for CodexOpenCode

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

This is RedberryProducts/synapse's own configuration. It tells Codex and OpenCode how to work on synapse 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 synapse configures →

Reuse

Borrowing it

Nothing to install: this file belongs to RedberryProducts/synapse. 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/RedberryProducts/synapse/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/RedberryProducts/synapse

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

README.md
[![agentmods](https://agentmods.dev/badge/instructions/redberryproducts/synapse/agents-md/github.svg)](https://agentmods.dev/instructions/redberryproducts/synapse/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/redberryproducts/synapse/agents-md"><img src="https://agentmods.dev/badge/instructions/redberryproducts/synapse/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 synapse AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/redberryproducts/synapse/agents-md"><img src="https://agentmods.dev/badge/instructions/redberryproducts/synapse/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 5,309 This file is loaded in full into every session.
When invoked 5,309 The same file — it is already loaded in full.
Security scan B 2 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.05309 $0.05309
Opus 5.5 $0.02124 $0.02124
Sonnet 5.5 $0.01062 $0.01062
Haiku 4.5 $0.00531 $0.00531

Measured 7d ago against content hash 5e11c1132cf4, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

synapse AGENTS.md scanned grade B with 2 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 7d 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.

Sends data to an external URLmediumData exfiltration

A POST to an outside endpoint may be telemetry or may be exfiltration; either way the mod talks to somewhere, and you should know where.

curl -sN -o /dev/null -X POST http://127.0.0.1:8000/synapse/api/chat/app.agents.slow-tool-agent/send -b cookies.txt -H "X-XSRF-TOKEN: $TOKEN" -H 'Content-Type: application/json' -d '{"message":"Query the analytics servic

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -sN -o /dev/null -X POST http://127.0.0.1:8000/synapse/api/chat/app.agents.slow-tool-agent/send -b cookies.txt -H "X-XSRF-TOKEN: $TOKEN" -H 'Content-Type: application/json' -d '{"message":"Query the analytics servic
AGENTS.md · 288 lines

How it starts

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

Working on Synapse

Guidance for any agent or contributor writing code in this repository. Read this first, then DEV.md for exact commands. For how Laravel packages work, invoke the laravel-package skill. Use the current user's request and the active GitHub issue's goal and acceptance criteria for scope. README.md and UPGRADE.md describe supported behavior; inspect implementation and tests for technical details.

Important notes

  • Plan before coding. For a non-trivial task, state a short plan (steps → how you'll verify each) and work through it.
  • Run the gates before reporting done: composer check (lint + analyse + test). All green, every time. A pre-commit hook enforces this — enable it once with composer hooks.
  • Run composer test:e2e when you touch the frontend or the chat/stream surface. It's excluded from composer check and from CI (needs Playwright + built assets); it is a required gate before a release.
  • Sequence feature and browser runs within a checkout. Installation tests publish/remove Testbench's temporary migrations; simultaneous suites can race. Use separate copies for concurrent compatibility checks.
  • Rebuild dist/ (npm run build) whenever resources/js changes — it's committed, and the hook checks it.
  • Never git commit without being asked.
  • Resolve scope conflicts explicitly. If the requested acceptance criteria, maintained docs, and implementation disagree, identify the discrepancy before changing behavior.

What this is

Synapse (redberry/synapse, namespace Redberry\Synapse\) is a Laravel package: a development dashboard for AI agents built with the Laravel AI SDK (laravel/ai). A React SPA served by a Laravel service provider — think Telescope/Horizon, but for AI agents. The package ships discovery, chat, recording, approvals, sources, completion explanations, and model-step inspection, with Pest, Pint, and PHPStan gates.

Repository map

Read the full file on GitHub · 288 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. 7d ago Changed · +2 lines · +135 tokens per session 5e11c1132cf4
  2. 10d ago Changed · +2 lines · +124 tokens per session 46b52a7dd06e
  3. 2mo ago First seen · 284 lines · 5,050 tokens per session scan B 652d955014e8

Subscribe to this mod's changes

synapse AGENTS.md is an instructions file published in the GitHub repository RedberryProducts/synapse (65 stars, last pushed 2d ago), licensed MIT. It adds 5,309 tokens to every session, about $0.0212 per session on Opus 5.5. A static security scan graded it B with 2 findings (sends data to an external url, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

synapse AGENTS.md compared with instructions from other repositories

synapse AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
synapse AGENTS.mdRedberryProducts/synapseInstructions file652d agoMITB5,309Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode