What is autonomOS CLAUDE.md?

Project instructions for autonomOS, a terminal dashboard for starting Claude Code sessions, monitoring them, and coordinating multiple coding agents. A monorepo is one repository containing several related parts of a project.

Working on the dashboard, session management, hook-based status reporting, messaging gateway, and other systems in the autonomOS repository.

They point the agent to the project’s overview, feature plans, decisions, research, and roadmap before it changes code.

How aterrylu/autonomOS configures Claude Code and Codex

Reuse

Borrowing it

Nothing to install: this file belongs to aterrylu/autonomOS. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/aterrylu/autonomOS/main/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/aterrylu/autonomOS

Made for: Claude Code, Codex.

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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/aterrylu/autonomos/claude-md/github.svg)](https://agentmods.dev/instructions/aterrylu/autonomos/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/aterrylu/autonomos/claude-md"><img src="https://agentmods.dev/badge/instructions/aterrylu/autonomos/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/aterrylu/autonomos/claude-md"><img src="https://agentmods.dev/badge/instructions/aterrylu/autonomos/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 12,378 This file is loaded in full into every session.

When invoked 12,378 The same file — it is already loaded in full.

Security scan C 3 findings. A grade says what 26 rules found in the file — not that it is safe.

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.

Model	Per session	Once invoked
Fable 5.1	$0.12378	$0.12378
Opus 5.5	$0.04951	$0.04951
Sonnet 5.5	$0.02476	$0.02476
Haiku 4.5	$0.01238	$0.01238

Measured 20d ago against content hash 3e4895b7b6ae, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade C, and why

autonomOS CLAUDE.md scanned grade C with 3 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 20d 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.

Sends data to an external URLmediumData exfiltration

A POST to an outside endpoint may be telemetry or may be exfiltration; either way the mod talks to somewhere, and you should know where.

Every spawned session gets `--settings` with inline hook entries for all 13 Claude Code events. Each hook runs `curl -d @- $AUTONOMOS_SERVER/api/hooks/$SESSION_ID`. The server processes events for agent status tracking (

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

**The `isolated` mode was REMOVED** (spawned a headless `claude -p`). It was the one execution path in the product outside `PermissionMode`, and it was fail-open in three places at once: the executor's `autonomous !== fa

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

### Hook Relay (`--settings` inline curl)

CLAUDE.md · 243 lines

How it starts

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

autonomOS — Agent Development Guide

Start Here

Read README.md — project overview, monorepo structure
Read docs/FEATURES.md — feature specifications and design intent
Browse docs/decisions/ — all architectural decisions (one file per ADR, with an index) with context and rationale
Read docs/ROADMAP.md — current priorities and what to work on
Read docs/RESEARCH.md — research findings, competitor analysis, learnings

Project Vision

autonomOS is a mission control platform for autonomous agents — a terminal dashboard that spawns Claude Code sessions, tracks their status via hook telemetry, and enables multi-agent coordination through a messaging gateway.

Current state: Terminal dashboard + session management + hook relay + multi-agent gateway + MCP tools. The orchestrator/projects/workspaces model described below is the long-term vision, not yet implemented.

Core concepts (future):

Orchestrator — PM agent, the main interface. Understands project goals, delegates to workspace agents, tracks progress.
Projects — Logical goals with roadmaps. Can span multiple workspaces. Multiple projects per workspace.
Workspaces — Physical repositories, auto-discovered. Each has active agent sessions.

Two paths that share a common core:

Dev Path — control plane for agent tools (Claude Code, etc.)
Robot Path — persistent agent platform for robotics (aspirational, future)

Monorepo Structure

autonomOS/
├── packages/
│   ├── dashboard/          # Web UI — observability & control
│   │   └── src/layout/         # dockview tabs + split panes (ADR-047, the only layout engine)
│   ├── server/             # Hono + node-pty — API, WebSocket, PTY management
│   │   ├── src/gateway/        # URI-based message router + platform adapters
│   │   ├── src/channel-server/ # Standalone MCP subprocess (server:autonomos)
│   │   └── src/mcp/            # Shared MCP tool definitions (used by both servers)
│   └── core/               # Shared agent abstractions & types
├── docs/
│   ├── decisions/          # Architectural Decision Records, one file per ADR (append-only)
│   ├── FEATURES.md         # Feature specifications (F-001 through F-016)
│   ├── ROADMAP.md          # Current priorities
│   ├── RESEARCH.md         # Research findings & competitor analysis
│   ├── VISION.md           # Project vision
│   └── research/           # Deep-dive research topics
├── CLAUDE.md               # This file — agent development guide
└── README.md               # Project overview

Read the full file on GitHub · 243 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.

20d ago Changed · +253 tokens per session 3e4895b7b6ae
25d ago Changed · +128 tokens per session b0ba83142834
26d ago Changed · +2 lines · +447 tokens per session 80317b36fce3
27d ago Changed · +3 lines · +689 tokens per session ffcc602255cd
28d ago Changed · +3 lines · +787 tokens per session b285f189f458
1mo ago Changed · +7 lines · +588 tokens per session 19c183f4c38f
1mo ago Changed · +4 lines · +675 tokens per session f4d512598bbd
1mo ago Changed · +8 lines · +1,385 tokens per session a4d836ec2e50
1mo ago Changed · +2 lines · +91 tokens per session 879750688e06
1mo ago First seen · 214 lines · 7,335 tokens per session scan C 1347635317e1

Subscribe to this mod's changes

autonomOS CLAUDE.md is an instructions file published in the GitHub repository aterrylu/autonomOS (10 stars, last pushed yesterday), licensed MIT. It adds 12,378 tokens to every session, about $0.0495 per session on Opus 5.5. A static security scan graded it C with 3 findings (sends data to an external url, reads agent configuration directories, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Claude Code agent-orchestration ai-agents claude developer-tools mcp

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

autonomOS: Instructions file for Claude Code