# okf-runner

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.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 105 repo stars
- Author: wmahfoudh
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/wmahfoudh/okf/tree/HEAD/skills-pi/okf-answer/agents/okf-runner.md
- Updated: 2026-10-31
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/okf-runner

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/okf-runner.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/okf-runner.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/okf-runner.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/wmahfoudh/okf/tree/HEAD/skills-pi/okf-answer/agents/okf-runner.md

## When to use it
- 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
- 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.

## Similar
- [okf-knowledge-base](https://affpapa.org/en/nevibecode/skills/okf-knowledge-base.md) — skill · 9400 installs
- [okf](https://affpapa.org/en/nevibecode/skills/okf.md) — skill · 1200 installs
- [memory-okf](https://affpapa.org/en/nevibecode/skills/memory-okf.md) — skill · 305 installs
- [test-runner](https://affpapa.org/en/nevibecode/agents/test-runner.md) — subagent · 846 installs
- [netlify-agent-runner](https://affpapa.org/en/nevibecode/skills/netlify-agent-runner.md) — skill · 2800 installs
- [okf-open-knowledge-format](https://affpapa.org/en/nevibecode/skills/okf-open-knowledge-format.md) — skill · ★ 141 repo stars

From the same set: [wmahfoudh/okf](https://affpapa.org/en/nevibecode/by/wmahfoudh/okf.md) — 8 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
