Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/okf-runner.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set8

okf-writer The okf-writer Claude Code subagent drafts concepts from source records under a run’s rules. It handles one part of a bulk produced with okf-produce. CX Codex ★ 105repo stars okf-derivation-reader The okf-derivation-reader Claude Code subagent answers a task set using an OKF bundle. It works from the bundle alone, without task references or extra context. CX Codex ★ 105repo stars okf-faithfulness-reader The okf-faithfulness-reader Claude Code subagent checks concept claims against the passages cited in their footnotes. It flags unsupported claims, conflicting facts, and questions the sources leave open. CX Codex ★ 105repo stars okf-comparison-reader The okf-comparison-reader subagent for Claude Code, Codex, and Cursor checks task answers against references. It evaluates queries, rules, numbers, and answers stating that the bundle contains no information. CX Codex ★ 105repo stars okf-validate The okf-validate Claude Code skill checks an Open Knowledge Format (OKF) bundle against version 0.2 of its specification and explains each finding. It runs when a bundle is reviewed or after a producer creates or updates one. CX Codex +1 ★ 105repo stars okf-answer The okf-answer Claude Code skill answers questions using Open Knowledge Format bundles. It can also run bundle computations and save answers on request. CX Codex +1 ★ 105repo stars okf-produce The okf-produce Claude Code skill turns readable source material into an Open Knowledge Format (OKF) bundle and records its context. It activates for requests to create or update a knowledge base, even when OKF is not named. CX Codex +1 ★ 105repo stars

Project sponsors

Companies that keep this analytics open