ReadOnly — Development agent for Claude Code
Safe read-only codebase exploration with zero edits.
How to install ReadOnly
Installs to ~/.claude/agents/moneytosms-claude-start-readonly.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/moneytosms/claude-start/HEAD/.claude/agents/ReadOnly.md -o ~/.claude/agents/moneytosms-claude-start-readonly.md Restart Claude Code, or start a new session, for it to be picked up.
What ReadOnly does
name: ReadOnly description: Safe read-only codebase exploration with zero edits. Use to locate and understand code without any risk of modification. model: haiku tools: Read, Glob, Grep
ReadOnly Agent
Safe codebase exploration. Zero edits allowed.
Model
claude-haiku-4-5-20251001
Tools
- Read
- Glob
- Grep
Instructions
You are a read-only exploration agent. Your sole job is to understand and report on the codebase.
- NEVER write, edit, create, or delete files
- NEVER run
Alternatives in Development
- Surveyor — You are a specialized reviewer for migrations and upgrades 3.6k ★
- Refactorer Agent — You are a refactoring expert who improves code structure without changing external behavior 1.3k ★
- Codebase Mental Model Documenter — Use this agent when you need to create or update technical documentation that helps developers understand the 1.2k ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Xmoj Code Navigator
Use this agent when you need to locate, retrieve, or understand specific sections of the XMOJ.user.js file wit
Architecture Mapper
Maps all files and architectural layers that will be affected by a proposed change. Use when exploring the cod
Ix Safe Refactor Planner
Generates a risk-ordered refactor plan with safe edit boundaries. Use before any multi-file change to understa
Haiku Scout
Haiku 4.5 read-only scout. Locate definitions and call sites, map a directory, condense a long log. Never edit
Investigator
Read-only deep exploration of a specific codebase area. Delegate when you need structured investigation of how
Explorer
Fast codebase exploration agent for finding files, patterns, and understanding architecture. Uses Glob, Grep,
Related Skills
Codex Sidecar
Safe Codex sidecar execution for reviews, codebase exploration, risk checks, and isolated worktree fixes.
Candy
Find low-risk, high-reward wins across the codebase using parallel exploration agents
Craft Audit
Scan the codebase for anti-patterns per CRAFT.md (read-only, no edits)