Agent Runner
@swamp/agent-runnerv2026.08.05.1
01README
Run AI coding agents (Claude, Codex) with structured output for CI integration. Manages agent CLI binaries, resolves API tokens from environment variables or vaults, and returns machine-readable verdicts that CI pipelines can gate on.
Provider-agnostic: each agent backend (Claude Code CLI, OpenAI Codex CLI) is a pluggable provider with its own binary management and CLI flag translation. The common interface is prompt in, structured result out.
Methods
| Method | What it does |
|---|---|
review |
Run a coding agent review against a set of files and return a structured verdict (pass/fail) with findings. |
run |
Run an arbitrary prompt through a coding agent and return the output. |
Providers
| Provider | CLI | API key env var |
|---|---|---|
claude |
Claude Code | ANTHROPIC_API_KEY |
codex |
OpenAI Codex | CODEX_API_KEY |
Usage
swamp extension pull @swamp/agent-runner
swamp model create @swamp/agent-runner reviewer
swamp model edit reviewer
swamp model method run reviewer review \
--input promptFile=.forgejo/prompts/review.md \
--input 'files:json=["src/main.ts","src/lib.ts"]' \
--json02Models
@swamp/agent-runnerv2026.08.05.1agent_runner.ts
fn review()
Run a coding agent review against a set of files and return a structured verdict
fn run()
Run an arbitrary prompt through a coding agent and return the output
Resources
reviewProfile(infinite)— A review profile — prompt template path, default model, tool permissions
reviewResult(infinite)— Structured output from a review run — verdict, findings, and formatted body
runResult(infinite)— Output from an arbitrary agent prompt execution
03Stats
A
100 / 100
Downloads
10
Archive size
36.1 KB
Verified by Swamp
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
04Platforms
05Labels