AGENTS.md in ultraworkers/claw-code runs 488 words across 12 headings.
An agent-managed museum exhibit, built in Rust with Gajae-Code / LazyCodex — developed and maintained with no human intervention.
RustCovers
7 of the 20 section tags
In the order a file is read inHeadings
12 headings, in the order the file writes them
01AGENTS.md — rust/ workspace
02OVERVIEW
03STRUCTURE
04WHERE TO LOOK
05CONVENTIONS
06ANTI-PATTERNS
07COMMANDS
08Format (check only)
09Format (apply)
10Lint (strict, matches what you should pass before pushing)
11Test
12Build specific binary
Commands
7 commands this file writes down
Extracted from the file, verbatimcargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo build -p rusty-claude-cli
cargo build -p claw-analog
cargo build -p claw-rag-service
cargo build -p mock-anthropic-service
cargo fmt --manifest-path rust/Cargo.toml
The file
rust/AGENTS.md
81 lines1# AGENTS.md — rust/ workspace
2
3## OVERVIEW
4
5Virtual Cargo workspace (resolver 2, edition 2021) housing 11 crates that compose the `claw` CLI and supporting services.
6
7## STRUCTURE
8
9| Crate | Kind | Purpose |
10|---|---|---|
11| `rusty-claude-cli` | bin (`claw`) | Main CLI binary. Package name ≠ binary name. |
12| `claw-analog` | lib+bin | Alternate entry point; depends on api + runtime only. |
13| `claw-rag-service` | bin | RAG service. Only crate with `[features]` (`qdrant-index`). |
14| `mock-anthropic-service` | lib+bin | Mock Anthropic Messages API. Prints `MOCK_ANTHROPIC_BASE_URL`. Dev-dep for CLI and analog tests. |
15| `runtime` | lib | Core: sessions, permissions, MCP, conversation loop. ~47 modules. |
16| `api` | lib | Provider clients: Anthropic, OpenAI-compat (xAI, OpenAI, DashScope, Ollama). |
17| `tools` | lib | 55-tool surface area. Depends on `commands` (not vice versa). |
18| `commands` | lib | 120+ slash commands. |
19| `plugins` | lib | Plugin manifest and lifecycle. |
20| `telemetry` | lib | Request identity + analytics sinks. |
21| `compat-harness` | lib | Extracts upstream TS claude-code manifest/commands/tools for parity comparison. |
22
23Dependency direction: `rusty-claude-cli` → tools/commands/runtime/api/plugins. `tools` → `commands`.
24
25## WHERE TO LOOK
26
27- **Parity testing**: `mock_parity_scenarios.json` at workspace root, loaded via `CARGO_MANIFEST_DIR/../../mock_parity_scenarios.json`. Scripts in `scripts/` (`run_mock_parity_harness.sh`, `run_mock_parity_diff.py`).
28- **CI**: `.github/workflows/rust-ci.yml` (fmt, clippy, test, docs, Windows smoke) and `release.yml` (v* tag builds for linux-x64/macos-arm64/windows-x64).
29- **Committed test fixtures**: `.clawd-agents/`, `.omc/`, `.sandbox-home/` are checked-in harness dotdirs.
30- **Docs**: `PARITY.md`, `TUI-ENHANCEMENT-PLAN.md`, `README.md` alongside this file.
31
32## CONVENTIONS
33
34Workspace lints (all crates opt in via `[lints] workspace = true`):
35- `unsafe_code` = **forbid**. No exceptions.
36- clippy `all` = warn, `pedantic` = allow. Explicitly allowed: `module_name_repetitions`, `missing_panics_doc`, `missing_errors_doc`.
37
38No `rustfmt.toml` or `clippy.toml`. Stock defaults only.
39
40TUI rule: formatting fns take `&mut impl Write`, never stdout directly. Never mix raw ANSI escapes with crossterm.
41
42Library crates don't carry the `claw-` prefix. Binary crates do (except legacy `rusty-claude-cli`).
43
44Workspace version is `0.1.3`, `publish = false`, MIT license.
45
46No rust-toolchain file, no MSRV. CI pins `dtolnay/rust-toolchain@stable`.
47
48## ANTI-PATTERNS
49
50- Don't run `cargo fmt --manifest-path rust/Cargo.toml` from the repo root. Use `../scripts/fmt.sh` instead.
51- Don't add `unsafe` code. The lint is set to `forbid`, not `deny`. You can't `#[allow]` it.
52- Don't create dependencies from `commands` → `tools`. The arrow goes `tools` → `commands`.
53- Don't write TUI output directly to stdout or use raw ANSI escape sequences.
54- Don't add features to crates other than `claw-rag-service` without good reason; the workspace is feature-lean by design.
55
56## COMMANDS
57
58All run from `rust/`:
59
60```sh
61# Format (check only)
62../scripts/fmt.sh --check
63
64# Format (apply)
65../scripts/fmt.sh
66
67# Lint (strict, matches what you should pass before pushing)
68cargo clippy --workspace --all-targets -- -D warnings
69
70# Test
71cargo test --workspace
72
73# Build specific binary
74cargo build -p rusty-claude-cli
75cargo build -p claw-analog
76cargo build -p claw-rag-service
77cargo build -p mock-anthropic-service
78```
79
80Note: CI clippy runs without `-D warnings`, so the local check above is stricter than the gate.
81
The rest of the repository
ultraworkers/claw-code ships 10 other instruction files
This listing
Whoever runs ultraworkers/claw-code can claim it
This is yours? Claim this config and we will write to you when the measurement moves. The check is one token placed where only you can place it, and there is no account and no password.