recondo AGENTS.md

Repository instructions for Recondo, a project with a Rust gateway, a TypeScript API, and a React dashboard.

In plain words
What is it for?
Use them when modifying Recondo code, running its builds or tests, starting local services, or deciding where new files belong.
Why use it?
They give coding agents the project's expected file layout, commands, style, and testing practices so changes fit the 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/recondodev/recondo/agents-md
Clone the repo
git clone --depth 1 https://github.com/recondodev/recondo

Made for: Codex, OpenCode.

Per session 652 This file is loaded in full into every session.
When invoked 652 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.00652 $0.00652
Opus 5 $0.00326 $0.00326
Sonnet 5 $0.00130 $0.00130
Haiku 4.5 $0.00065 $0.00065

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

Security

Grade A, and why

recondo 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 · 30 lines

How it starts

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

Repository Guidelines

Project Structure & Module Organization

gateway/ contains the Rust proxy and CLI; core modules live in gateway/src/* and suites live in gateway/tests/*_tests.rs. api/ is a Fastify + GraphQL TypeScript service with runtime code in api/src, SQL migrations in api/migrations, generated schema types in api/src/generated, and Vitest coverage in api/tests. dashboard/ is a Vite + React frontend with UI code in dashboard/src and browser tests in dashboard/tests. Deployment assets live under deploy/ (helm, terraform, local-dev), and design notes live in docs/.

Build, Test, and Development Commands

Prefer just from the repo root:

  • just build: format, lint, and build the Rust gateway.
  • just test: run the gateway suite with cargo nextest.
  • just ci: run the same gateway checks used in CI.
  • just dev-setup: start PostgreSQL + MiniStack and apply API migrations.
  • just api-dev / just dashboard-dev: start the API on :4000 and dashboard on :5173.
  • just api-test: boot the API against recondo_test and run Vitest.
  • just test-pg: run PostgreSQL-backed gateway tests.

For package-local work, use cd api && npm run build, cd api && npm run codegen, and cd dashboard && npm run build.

Coding Style & Naming Conventions

Rust uses standard rustfmt formatting and must pass cargo clippy -- -D warnings; keep modules grouped by domain under gateway/src/<area>/mod.rs. TypeScript is strict in both api and dashboard; follow the existing style: 2-space indentation, double quotes, semicolons, PascalCase.tsx for React components/pages, and descriptive lower-case file names for API modules and tests. Do not hand-edit generated GraphQL types in api/src/generated/graphql.ts; regenerate from api/codegen.ts.

Testing Guidelines

Name TS tests *.test.ts or *.test.tsx; gateway suites use *_tests.rs. API tests share a database and run sequentially, so keep fixtures isolated and deterministic. Run the narrowest relevant suite before opening a PR, then re-run the package-level command (just test, just api-test, or cd dashboard && npm test).

Read the full file on GitHub · 30 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 · 30 lines · 652 tokens per session scan A b09afc6f097f

Subscribe to this mod's changes

recondo AGENTS.md is an instructions file published in the GitHub repository recondodev/recondo (5 stars, last pushed 3mo ago), licensed Apache-2.0. It adds 652 tokens to every session, about $0.0033 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.

Related

Other instructions, from other repositories

CPA-Manager-Plus AGENTS.md

AGENTS.md instructions for seakee/CPA-Manager-Plus, covering repository rules, operation, layout, commands and architecture.

seakee/CPA-Manager-Plus · 1,925 tokens

openllmetry CLAUDE.md

Instructions for traceloop/openllmetry, covering openllmetry repository guide, repository structure, nx workspace commands, run tests across all packages and run linting across all packages.

traceloop/openllmetry · 636 tokens

openlit AGENTS.md

AGENTS.md instructions for openlit/openlit, covering openlit agent rules, ce/oss boundary, extension points, project hierarchy and ui and security.

openlit/openlit · 817 tokens

openlit CLAUDE.md

Claude Code instructions for openlit/openlit, a project described as: Open source platform for AI Engineering: OpenTelemetry-native LLM Observability, GPU Monitoring, Guardrails, Evaluations, Prompt Management, Vault, Playground. 🚀💻 Integrates with 50+ LLM Providers, VectorDBs, Agent Frameworks and GPUs.

openlit/openlit · 12 tokens

ai-gateway AGENTS.md

Instructions for ferro-labs/ai-gateway, covering agents.md, project overview, current development snapshot, public-facing wording and build, test, and run commands.

ferro-labs/ai-gateway · 20,242 tokens

litellm AGENTS.md

AGENTS.md instructions for BerriAI/litellm, a project described as: The fastest, litest AI Gateway. Rust core with Python SDK. Call 100+ LLM APIs in OpenAI (or native) format with cost tracking, guardrails, load balancing, and logging [Bedrock, Azure, OpenAI, Anthropic, OpenAI, VertexAI, vLLM, Nvidia NIM].

BerriAI/litellm · 10 tokens