operator-oss CLAUDE.md

operator-oss CLAUDE.md is an instructions file for coding agents from iishyfishyy/operator-oss. It costs 3,595 tokens per session, scanned A, original, Apache-2.0.

Project instructions for Orchestrator, a local web app that runs multiple Claude Code sessions across projects. They describe its commands, architecture, session flow, and important modules.

In plain words
What is it for?
Use them when changing Orchestrator, especially for running the app, building it, executing unit or end-to-end tests, and understanding how projects and tasks are managed.
Why use it?
They give a coding agent the project context needed to work safely and use the correct development and testing commands.

Instructions file

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/iishyfishyy/operator-oss/claude-md
Clone the repo
git clone --depth 1 https://github.com/iishyfishyy/operator-oss

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 operator-oss CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/iishyfishyy/operator-oss/claude-md.svg)](https://agentmods.dev/instructions/iishyfishyy/operator-oss/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/iishyfishyy/operator-oss/claude-md"><img src="https://agentmods.dev/badge/instructions/iishyfishyy/operator-oss/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,595 This file is loaded in full into every session.
When invoked 3,595 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.03595 $0.03595
Opus 5 $0.01798 $0.01798
Sonnet 5 $0.00719 $0.00719
Haiku 4.5 $0.00360 $0.00360

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

Security

Grade A, and why

operator-oss 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 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.

CLAUDE.md · 78 lines

How it starts

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

CLAUDE.md

Orchestrator — a local-first web app that runs many Claude Code sessions in parallel across multiple projects from one screen. Each project carries reusable context + a working directory; each task is its own Claude Code session in its own git worktree, driven by @anthropic-ai/claude-agent-sdk against the user's local Claude login (no API key). (A hosted version, getoperator.dev, lives in a separate private repo that overlays this one — see "Repo split" below.)

Commands

  • npm run dev — app (:3000, server.js) + pty sidecar (:3001, pty-server.js) via concurrently. npm run dev:next / npm run pty run them separately.
  • npm run build (turbopack) then npm start for production.
  • npm test — vitest, serial on purpose (tests spawn many real git subprocesses). Single file: npx vitest run tests/merge.test.ts.
  • npm run test:e2e — Playwright end-to-end suite: builds, then boots the real prod server against a hermetic temp instance with the deterministic mock agent (lib/agents/mock/, registered only when ORCH_E2E_MOCK_AGENT=1) and drives onboarding → project → task → turn → diff → merge through the UI. npm run preflight = unit + e2e, the pre-push gate. See e2e/README.md (mock-turn directives, selector conventions, staleness gotcha: the server runs the built bundle).
  • No lint script; TypeScript is strict, path alias @/* → repo root (mirrored in vitest.config.ts).

Architecture

Three processes/entrypoints, one origin:

  • server.js — custom Next.js server (plain Node, CommonJS). Fronts Next on one port, proxies /pty WebSocket upgrades to the sidecar, forwards dev HMR upgrades to Next, enforces origin auth on WebSocket upgrades (middleware never sees upgrades — this file is the auth boundary for the terminal), and dispatches public service hostnames (<slug>--<appHost>) through lib/service-router.mjs.
  • pty-server.js — node-pty sidecar, bound to 127.0.0.1 only; never exposed directly.
  • Next app — UI in app/, REST under app/api/, server logic in lib/.

Read the full file on GitHub · 78 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 · 78 lines · 3,595 tokens per session scan A e7da8d9fef43

Subscribe to this mod's changes

operator-oss CLAUDE.md is an instructions file published in the GitHub repository iishyfishyy/operator-oss (201 stars, last pushed 15d ago), licensed Apache-2.0. It adds 3,595 tokens to every session, about $0.0180 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.

Related

Other instructions, from other repositories

git-worktree-runner copilot-instructions.md

Instructions for coderabbitai/git-worktree-runner, covering copilot instructions, architecture & flow, key concepts, adapter contract and manual testing (essential subset).

coderabbitai/git-worktree-runner · 1,250 tokens

git-worktree-runner completions.instructions.md

Instructions for coderabbitai/git-worktree-runner, covering completions instructions, when to update completions, file responsibilities, implementation pattern and testing completions.

coderabbitai/git-worktree-runner · 1,366 tokens

git-worktree-runner testing.instructions.md

Instructions for coderabbitai/git-worktree-runner, covering testing instructions, basic create/remove, branch sanitization, remote branch (if exists) and local existing branch.

coderabbitai/git-worktree-runner · 766 tokens

git-worktree-runner ai.instructions.md

Instructions for coderabbitai/git-worktree-runner, covering ai adapter instructions, when to use a file vs registry, adding a standard ai tool (registry), adding a custom ai tool (file override) and toolname adapter.

coderabbitai/git-worktree-runner · 491 tokens

git-worktree-runner editor.instructions.md

Instructions for coderabbitai/git-worktree-runner, covering editor adapter instructions, when to use a file vs registry, adding a standard editor (registry), adding a custom editor (file override) and editorname adapter.

coderabbitai/git-worktree-runner · 533 tokens

mulmoterminal CLAUDE.md

Claude Code instructions for receptron/mulmoterminal, covering claude.md — mulmoterminal, stack & package manager, run after changes, import a component at module scope, never inside a test and no emojis.

receptron/mulmoterminal · 5,467 tokens