claudius: Instructions file for Codex

AGENTS.md

claudius AGENTS.md is an instructions file for Codex, OpenCode from crisogray/claudius. It costs 2,209 tokens per session, scanned A, original, Apache-2.0.

A set of coding instructions for ADE, a desktop app development environment built around a Tauri desktop shell, a SolidJS interface, and an agent server.

In plain words
What is it for?
It helps with work on the desktop shell, frontend, agent server, shared UI, API client, and supporting utilities.
Why use it?
It gives an agent the project’s architecture and package roles, reducing the chance of changes being made in the wrong part of the application.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions OpenCode.

This is crisogray/claudius's own configuration. It tells Codex and OpenCode how to work on claudius itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything claudius configures →

Reuse

Borrowing it

Nothing to install: this file belongs to crisogray/claudius. 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/crisogray/claudius/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/crisogray/claudius

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

README.md
[![agentmods](https://agentmods.dev/badge/instructions/crisogray/claudius/agents-md/github.svg)](https://agentmods.dev/instructions/crisogray/claudius/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/crisogray/claudius/agents-md"><img src="https://agentmods.dev/badge/instructions/crisogray/claudius/agents-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.

agentmods 80×15 button for claudius AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/crisogray/claudius/agents-md"><img src="https://agentmods.dev/badge/instructions/crisogray/claudius/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,209 This file is loaded in full into every session.
When invoked 2,209 The same file — it is already loaded in full.
Security scan A 0 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.02209 $0.02209
Opus 5.5 $0.00884 $0.00884
Sonnet 5.5 $0.00442 $0.00442
Haiku 4.5 $0.00221 $0.00221

Measured 1mo ago against content hash ecb9de15990e, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

claudius 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 1mo 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 · 284 lines

How it starts

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

ADE: Agent Development Environment

Fork of OpenCode focused on desktop app development.

Architecture

Package Structure

packages/
  desktop/     # Tauri v2 shell, sidecar management
  app/         # SolidJS frontend, context providers, pages
  opencode/    # Agent server, tools, snapshots (runs as sidecar)
  ui/          # Shared components, themes, @pierre/diffs integration
  sdk/         # Auto-generated API client, SSE events
  util/        # Helpers (encoding, binary search, retry)

Desktop App (packages/desktop)

Tauri v2 app that wraps the frontend and manages the opencode CLI as a sidecar:

  • src-tauri/src/lib.rs - Main app logic, sidecar spawning, window creation
  • src-tauri/src/cli.rs - CLI installation/sync to ~/.opencode/bin/opencode
  • src/index.tsx - Entry point, renders app inside ServerGate

Sidecar flow:

Tauri app starts
  -> spawn_sidecar("opencode serve --port={port}")
  -> inject port via window.__OPENCODE__
  -> frontend connects via HTTP/SSE to localhost:{port}

Tauri commands: kill_sidecar, install_cli, ensure_server_started

App Package (packages/app)

SolidJS frontend with nested context providers:

PlatformProvider (web vs desktop abstraction)
  ServerProvider (connection management)
    GlobalSDKProvider (SDK client + global events)
      GlobalSyncProvider (projects, providers state)
        Router
          Layout (sidebar, navigation)
            DirectoryLayout (per-directory scope)
              SDKProvider, SyncProvider (directory-scoped)
                LocalProvider (model, agent, files)
                  TerminalProvider, FileProvider, PromptProvider
                    Session page

Key files:

  • src/pages/layout.tsx - Sidebar with projects/sessions, drag-drop reordering
  • src/pages/session.tsx - Main work surface: messages, prompt input, review tabs
  • src/context/sync.tsx - State management, SSE event handling

Read the full file on GitHub · 284 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. 1mo ago First seen · 284 lines · 2,209 tokens per session scan A ecb9de15990e

Subscribe to this mod's changes

claudius AGENTS.md is an instructions file published in the GitHub repository crisogray/claudius (91 stars, last pushed 8mo ago), licensed Apache-2.0. It adds 2,209 tokens to every session, about $0.0088 per session on Opus 5.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