reachy_mini AGENTS.md

reachy_mini AGENTS.md is an instructions file for Codex, OpenCode from pollen-robotics/reachy_mini. It costs 4,706 tokens per session, scanned A, original, Apache-2.0.

Project instructions for building Reachy Mini applications, including rules for AI coding assistants and guidance on JavaScript and Python app types.

In plain words
What is it for?
Use them when starting work on a Reachy Mini project, checking local instructions, choosing JavaScript or Python, or explaining development steps to a user.
Why use it?
They give an assistant the project’s expected workflow, local setup checks, teaching style, and default choice of app technology.

Instructions file for CodexOpenCode

About the project

pollen-robotics/reachy_mini is the SDK and development project for Reachy Mini, an open-source expressive robot for hackers and AI builders. It supports building robot behaviors and applications with Python or JavaScript, including simulated robots and integrations with language models. The catalogue add-ons provide coding guidance for the Reachy Mini SDK.

pollen-robotics/reachy_mini · 1,486 stars · on GitHub

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

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

README.md
[![agentmods](https://agentmods.dev/badge/instructions/pollen-robotics/reachy_mini/agents-md.svg)](https://agentmods.dev/instructions/pollen-robotics/reachy_mini/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/pollen-robotics/reachy_mini/agents-md"><img src="https://agentmods.dev/badge/instructions/pollen-robotics/reachy_mini/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 4,706 This file is loaded in full into every session.
When invoked 4,706 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.04706 $0.04706
Opus 5 $0.02353 $0.02353
Sonnet 5 $0.00941 $0.00941
Haiku 4.5 $0.00471 $0.00471

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

Security

Grade A, and why

reachy_mini 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 5d 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 · 315 lines

How it starts

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

Reachy Mini Development Guide for AI Agents

This guide helps AI agents assist users in developing Reachy Mini applications.


Agent Behavior

FIRST: Check for agents.local.md

Before doing anything else, search for agents.local.md in the current directory:

IF agents.local.md exists:
    Read it immediately
    It contains user configuration and session context
ELSE:
    → Run skills/setup-environment.md to set up the environment

This file stores the user's robot type, preferences, and setup status. Always check it first.

Be a Teacher

Unless the user explicitly requests otherwise:

  • Explain concepts as you go
  • Encourage questions ("Let me know if you'd like more detail on any of this")
  • Guide non-technical users through each step
  • Don't assume prior knowledge

Two App Flavours — Default to JS, Python for developers

Reachy Mini supports two app types. Default to a JS (Live/Web) app unless the user explicitly wants on-robot Python, or has a need that only Python can cover (heavy on-robot compute, rich hardware access, deterministic real-time control loops, or bundled offline LAN tooling).

Flavour Default for Where it runs
JS app (recommended) End-users, shareable-by-URL experiences, anyone who wants "open a link, use the robot". Remote launch, zero-install, streaming A/V UIs. Static HF Space; reaches the robot over WebRTC via the central signaling server.
Python app Developer tools, on-robot control loops, heavy motion sequencing, offline/LAN. Robot owner's machine (laptop / CM4), optionally with a bundled web UI.

Both coexist — a Python app can bundle a browser UI, and a JS app can call the Python daemon's REST API.

When unsure, start JS. If the user later discovers they need on-robot compute they can graduate to a Python app; the reverse migration is rarely needed.

Confirm the choice with the user up front, then jump to the corresponding section:

Read the full file on GitHub · 315 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. 5d ago First seen · 315 lines · 4,706 tokens per session scan A da3752c5447c

Subscribe to this mod's changes

reachy_mini AGENTS.md is an instructions file published in the GitHub repository pollen-robotics/reachy_mini (1,486 stars, last pushed 2d ago), licensed Apache-2.0. It adds 4,706 tokens to every session, about $0.0235 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.