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/cscoderr/simpod/claude-mdgit clone --depth 1 https://github.com/cscoderr/simpodWhat 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.01119 | $0.01119 |
| Opus 5 | $0.00560 | $0.00560 |
| Sonnet 5 | $0.00224 | $0.00224 |
| Haiku 4.5 | $0.00112 | $0.00112 |
Grade A, and why
simpod 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 3d 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.
How it starts
The opening of the file, as written. The whole thing — 66 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
What this is
Simpod streams and remotely controls booted iOS Simulators from a browser, terminal, or AI agent. A Dart CLI spawns one native Swift helper per simulator; the helper captures the framebuffer, streams H.264 (MJPEG fallback), injects touch/keyboard input, and exposes the accessibility tree. Requires macOS 14+, Xcode CLT (xcrun simctl), and a booted simulator.
Commands
flutter pub get # resolve the Dart workspace (run from repo root)
# Tests (run inside the package directory)
cd packages/simpod && dart test # CLI tests
cd packages/simpod_core && dart test # shared-model tests
dart test test/services/helper_manager_test.dart # single file
dart test -N "name substring" # single test by name
dart analyze packages/simpod packages/simpod_core # lint (what CI runs)
# Native Swift helper
swift build --package-path packages/native # build
swift test --package-path packages/native # tests
# Flutter web dashboard
cd packages/simpod_client && flutter build web --wasm --release
./build.sh # full standalone binary -> build/simpod
For development you usually don't need ./build.sh: run dart run bin/simpod.dart from packages/simpod. When embedded assets are absent it falls back to source paths — the helper binary at packages/simpod/lib/bin/simpod-helper-bin (produced by swift build -c release + copy, see build.sh steps 1–2) and the dashboard at packages/simpod_client/build/web.
Architecture
Dart workspace (pubspec.yaml at root) with three Dart packages plus a SwiftPM package:
packages/simpod— the CLI (bin/simpod.dart, commands inlib/src/commands/) and the preview HTTP server (lib/src/server/simpod_http_server.dart, shelf_router). Device discovery and control shell out toxcrun simctl(lib/src/devices/).SimpodHelperManager(lib/src/services/helper_manager.dart) spawns/kills helper processes;SimpodSessionManagerpersists per-udid session files (pid, port, urls, access token) so short-lived CLI commands can find running helpers.packages/native— Swift 6 executablesimpod-helper-bin(Hummingbird HTTP/WS server, one process per simulator). Framebuffer capture via IOSurface, H.264 via VideoToolbox, JPEG encode, HID injection through private CoreSimulator/SimulatorKit interfaces, accessibility bridge, and device-bezel/chrome rendering.packages/simpod_client— Flutter web dashboard. Decodes H.264 with WebCodecsVideoDecoder(lib/core/utils/avcc_stream_renderer.dart), falls back to MJPEG.packages/simpod_core— models and protocol enums shared by CLI and client (DeviceInfo,SimpodSession,AXNode, orientation/touch-edge/key-event types).
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.
- 3d ago First seen · 66 lines · 1,119 tokens per session scan A c435cfa355ef
simpod CLAUDE.md is an instructions file published in the GitHub repository cscoderr/simpod (24 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 1,119 tokens to every session, about $0.0056 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
edge AGENTS.md
Instructions for OpenStrap/edge, covering agents.md — openstrap edge, 1. what this is, 3. hard invariants — violating these is a p0 regression, 4. recurring bug patterns — what actually ships broken here and 4.3 sticky boolean latches never reset on the failure path.
mobile CLAUDE.md
Claude Code instructions for lichess-org/mobile, covering claude.md, project overview, development setup, initial setup and install dependencies.
wind dynamic.instructions.md
Instructions for fluttersdk/wind, covering dynamic json renderer (lib/src/dynamic/), json schema, security model (whitelist first), state binding (id-keyed widgets) and action dispatch.
wind example-pages.instructions.md
Instructions for fluttersdk/wind, covering example page conventions (example/lib/pages/), naming, shape, rules and dark mode pairs.
wind widgets.instructions.md
Instructions for fluttersdk/wind, covering widget conventions (lib/src/widgets/), canonical shape (stateless composition widgets), statefulwidget exceptions (only when warranted), debug logger (mandatory in stateless widgets) and wanchor auto-wrapping.
dart-expert-skills copilot-instructions.md
Instructions for Poorgramer-Zack/dart-expert-skills, covering flutter skills repository - copilot instructions, repository overview, architecture, directory structure and skill structure.