edgee AGENTS.md

A set of instructions for working on Edgee, an agent gateway written in Rust that sits between coding agents and language-model providers. It describes Edgee’s product goals, audience, major features, and rules for user-facing writing.

In plain words
What is it for?
Use it when editing Edgee’s code or documentation, explaining its request-routing and usage-management role, or checking that product copy follows its positioning rules.
Why use it?
It prevents contributors from describing the product inaccurately or inconsistently. It also gives coding agents the technical and business context needed when changing this repository.

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

Made for: Codex, OpenCode.

Per session 3,206 This file is loaded in full into every session.
When invoked 3,206 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.03206 $0.03206
Opus 5 $0.01603 $0.01603
Sonnet 5 $0.00641 $0.00641
Haiku 4.5 $0.00321 $0.00321

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

Security

Grade A, and why

edgee 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 2d 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.

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 · 238 lines

How it starts

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

AGENTS.md

Context for coding agents working in this repository. CLAUDE.md is a symlink to this file.

What Edgee is

Edgee is an Agent Gateway, built in Rust by Edgee Cloud SAS (Paris) with a US subsidiary, Edgee Corporation (Delaware).

Edgee sits between AI agents and LLM providers as a transparent gateway. It intercepts, routes, compresses, meters, and secures every LLM request, with no code change on the agent side. It works with all major coding agents (Claude Code, Codex, Cursor, GitHub Copilot, OpenCode, CodeBuddy, Crush) and all provider plans, including consumer subscriptions — not just API credits.

Who it's for: engineering organisations (typically 150+ developers) whose coding-agent bills are growing fast and whose leadership lacks visibility and control over token spend. Buyers are VPs of Engineering, CTOs, and platform teams.

Core value: cut token costs by up to 70% while giving engineering leaders full control and visibility over agent usage.

Product pillars, in order of strategic importance

  1. Smart routing and budget management — the moat. The routing engine can redirect requests to open-weight models mid-task without quality loss. The upcoming Strategies system lets customers define routing policies scoped to a person, a squad, or the whole organisation (e.g. a $100 weekly Claude budget: at 75% consumption Opus requests reroute to Kimi K3, at 85% Sonnet goes to GLM 5.2, at 100% everything routes to DeepSeek).
  2. Team observability — cost and usage per developer, repo, PR, model, and environment.
  3. Token compression — input trimming and output brevity, semantically lossless for coding tasks. A strong acquisition hook, but expected to become a commodity.

Positioning guardrails (apply to all user-facing copy)

  • The category is Agent Gateway. Keep it. Lead with token cost reduction through routing and control — that's what converts and what wins POCs. Compression is a supporting feature, never the headline.
  • Never write "Agent Engineering Platform" (or equivalents) in product copy. It reads as a platform for building agents — LangChain/CrewAI territory — whereas Edgee governs agents. The category label only broadens once the desktop app, Strategies, and skills/MCP management have shipped and been adopted.
  • There is an expansion narrative — enter through cost reduction, become the control plane through which every AI agent in the company operates (routing, budgets, observability, skills, MCP, governance), the way Datadog expanded from infrastructure monitoring. It is reserved for the Series A deck, the vision page, and founder talks. It does not belong in the README, the CLI, the docs, or any copy you write here.
  • Roadmap items may be named as roadmap items (see README) without implying a category change.
  • Against OpenRouter and LiteLLM (the competitors seen in POCs): OpenRouter is a gateway for apps that consume LLMs; Edgee is specialised for agents, wrapping the agent itself with zero code change. Differentiators: agent-specialised, token compression, observability per developer/repo/PR rather than per API key, native 500-developer onboarding (seats, budgets, per-squad policies), and budget-driven Strategies with mid-task rerouting.
  • Compliance facts that may be stated: SOC 2 and GDPR compliant, on-premise deployment available, BYOK supported.

Read the full file on GitHub · 238 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. 2d ago First seen · 238 lines · 3,206 tokens per session scan A 647a6287e7ae

Subscribe to this mod's changes

edgee AGENTS.md is an instructions file published in the GitHub repository edgee-ai/edgee (127 stars, last pushed 5d ago), licensed Apache-2.0. It adds 3,206 tokens to every session, about $0.0160 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-30.