okf-runner — Claude Code subagent: tasks and installation
The okf-runner Claude Code subagent runs one computation or read-only check from a brief. It returns a run record with the tool output and any error.
no license ★ 105 updated 2026-10-31
.claude/agents/okf-runner.mdWhat okf-runner does
okf-runner executes code from a brief with the named tool, or performs a check that only reads data. It does not edit the code or write a replacement. Its receipt records what ran, when it ran, the tool’s raw output, and any failure.
It reports install, download, and write commands instead of running them. A check that would alter data is also stopped. Environment variable values stay private. If a required tool is missing, okf-runner names it and gives the system’s install command, but does not install it.
What it helps with
- run specified code with bound parameters
- check data without changing it
- capture raw output and a run failure
- identify an install or download command in a brief
Example prompts for the agent
- Run the computation in this brief and return its receipt.
- Check this directory using the read-only rule in the brief.
- Run the specified code and report if a required tool is missing.
How to install okf-runner
Manually: put the files in place
.claude/agents/okf-runner.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/okf-runner.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/okf-runner.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 okf-runner
How do I install okf-runner in Claude Code?
Place the agent file at .claude/agents/okf-runner.md.
What does okf-runner do?
It carries out one computation or read-only check from a brief. The receipt includes the run details, raw tool output, and any error.
What happens if a required tool is missing?
okf-runner reports the tool and the system-specific install command. It does not install the tool.