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.
npx agentmods add instructions/ranvier-technologies/pixir/claude-mdgit clone --depth 1 https://github.com/Ranvier-Technologies/pixirWhat 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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00246 | $0.00246 |
| Opus 5 | $0.00123 | $0.00123 |
| Sonnet 5 | $0.00049 | $0.00049 |
| Haiku 4.5 | $0.00025 | $0.00025 |
Grade A, and why
pixir CLAUDE.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 yesterday.
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.
What it actually says
Pixir Harness - legacy agent guide
AGENTS.md is the canonical instruction file for coding agents in this repo. Start
there, then read CONTEXT.md for vocabulary and the relevant ADR in docs/adr/.
This file remains only as a compatibility pointer for harnesses that still look for
CLAUDE.md.
Current map
- Runtime spine:
Session -> Turn -> Provider -> Tools. - Source of truth: append-only local Log under
.pixir/sessions/. - Presenters: terminal CLI and ACP over stdio.
- Provider path: OpenAI Responses,
store: false, provider usage as durable evidence, WebSocket-preferred transport with HTTP/SSE fallback. - Growth surfaces: Skills, Subagents, Workflows, Session Resources/Image Attachments, Provider-hosted Web Search, and future Skill Context Hydration.
Commands
mix deps.get
mix check
mix test
mix format --check-formatted
mix compile --warnings-as-errors
mix escript.build
./pixir doctor --json
Run Python helpers, if any, with:
uv run python file_name.py
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.
- yesterday First seen · 36 lines · 246 tokens per session scan A e27989abbc37
pixir CLAUDE.md is an instructions file published in the GitHub repository Ranvier-Technologies/pixir (23 stars, last pushed 4d ago), licensed MIT. It adds 246 tokens to every session, about $0.0012 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.
Other instructions, from other repositories
raxol CLAUDE.md
Instructions for DROOdotFOO/raxol, covering claude.md, essential commands, initial setup, building & compilation and testing.
RepoResident AGENTS.md
Instructions for ychamel/RepoResident: Agent entry point: read CLAUDE.md in full — it is the operating manual — then follow its Session protocol. Everything else (state, workflows, project knowledge) is routed from there via the .agent/ directory.
agent-harness-skills AGENTS.md
Instructions for yfge/agent-harness-skills, covering agent harness skills - repository instructions, purpose, rules, validation and commit discipline.
agent-harness-skills GEMINI.md
Instructions for yfge/agent-harness-skills: This extension provides reusable skills for repository harness design.
pi-dsh AGENTS.md
AGENTS.md instructions for abhishekgahlot2/pi-dsh, covering pi-dsh, the contract (read before changing anything), layout, commands and vendoring policy ("maintain both forks").
pi-dsh CLAUDE.md
Claude Code instructions for abhishekgahlot2/pi-dsh: All project instructions live in AGENTS.md — read it first and follow it exactly.