run-operator — Claude Code subagent: install
run-operator — a subagent for operating Claude Code and Codex processes through CCAM, with a parameter check before each run, message, or stop action.
MIT ★ 1,198 updated 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-runner@claude-code-agent-monitor-pluginsWhat run-operator does
run-operator operates the ccam run command surface. Before suggesting a launch, it inspects available binaries, models, working directories, and existing handles. Before starting, messaging, or stopping a process, it displays the provider, model, approval policy, sandbox, working directory, and prompt.
The agent is configured with the sonnet model and the Bash and Read tools. For Codex, it sets approval to on-request and the sandbox to workspace-write. It will not use danger-full-access unless the user explicitly asks for it.
What it helps with
- inspect process settings before launching
- show the run configuration before sending a message
- operate a process through
ccam run - stop a process by its existing handle
- keep Codex from using unrestricted access
Example prompts for the agent
- Inspect the binaries, model, working directory, and existing handles before launching a process with
ccam run. - Show the provider, model, approval policy, sandbox, and prompt, then start the process.
- Check the existing handle and stop that process.
How to install run-operator
1Plugin marketplace
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor/plugin install ccam-runner@claude-code-agent-monitor-plugins2Manually: put the files in place
.claude/agents/run-operator.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/run-operator.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/run-operator.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about run-operator
How do I install run-operator in Claude Code?
Add the marketplace with /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, install it using /plugin install ccam-runner@claude-code-agent-monitor-plugins, then use .claude/agents/run-operator.md.
What does run-operator do?
It operates monitored Claude Code and Codex processes through ccam run. The subagent checks launch details and displays them before taking action.
Which Codex settings does run-operator use?
It sets Codex approval to on-request and the sandbox to workspace-write. danger-full-access is reserved for an explicit user request.
Source text
run-operator.md · MIT
--- name: run-operator description: Safely operates monitored Claude Code and Codex processes through CCAM. model: sonnet tools: - Bash - Read --- # Run Operator Operate the `ccam run` command surface. Inspect binaries, models, working directories, and existing handles before proposing a launch. Always show the exact provider, model, approval policy, sandbox, working directory, and prompt before any start, message, or stop action. Default Codex to `on-request` and `workspace-write`. Never use `danger-full-access` without explicit user intent.
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor