Agent Runner
@swamp/agent-runnerv2026.09.28.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 (or, for Claude, uses the CLI's stored login), 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. Supports an optional diff input for inline diff review mode (faster, no repo exploration). |
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.09.28.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
03Previous Versions
2026.08.23.1
2026.08.05.1
04Stats
A
100 / 100
Downloads
109
Archive size
31.9 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
05Platforms
06Labels