Loading...
Loading...
Discover, create, and validate headless adapters for agent integration. Includes scaffolding tools and schema-driven compliance testing.
npx skill4agent add youdotcom-oss/agent-skills headless-adapters| Use Case | Tool |
|---|---|
| Wrap headless CLI agent | |
| Create new schemas | Schema Creation Guide |
ANTHROPIC_API_KEY=... bunx @plaited/agent-eval-harness headless --schema .claude/skills/headless-adapters/schemas/claude-headless.jsonbunx @plaited/agent-eval-harness headless --schema <path>| Flag | Description | Required |
|---|---|---|
| Path to adapter schema (JSON) | Yes |
{
"version": 1,
"name": "my-agent",
"command": ["my-agent-cli"],
"sessionMode": "stream",
"prompt": { "flag": "-p" },
"output": { "flag": "--output-format", "value": "stream-json" },
"autoApprove": ["--allow-all"],
"outputEvents": [
{
"match": { "path": "$.type", "value": "message" },
"emitAs": "message",
"extract": { "content": "$.text" }
}
],
"result": {
"matchPath": "$.type",
"matchValue": "result",
"contentPath": "$.content"
}
}| Mode | Description | Use When |
|---|---|---|
| Keep process alive, multi-turn via stdin | CLI supports session resume |
| New process per turn, accumulate history | CLI is stateless |
| Schema | Agent | Mode | Auth Env Var | Status |
|---|---|---|---|---|
| Claude Code | stream | | Tested |
| Gemini CLI | iterative | | Tested |
# Claude Code
ANTHROPIC_API_KEY=... bunx @plaited/agent-eval-harness headless --schema .claude/skills/headless-adapters/schemas/claude-headless.json
# Gemini CLI
GEMINI_API_KEY=... bunx @plaited/agent-eval-harness headless --schema .claude/skills/headless-adapters/schemas/gemini-headless.json--helpheadless| Issue | Likely Cause | Solution |
|---|---|---|
| Tool calls not captured | JSONPath not iterating arrays | Use |
| "unexpected argument" error | Stdin mode misconfigured | Use |
| 401 Authentication errors | API key not properly configured | Set the correct API key environment variable (see Pre-built Schemas table) |
| Timeout on prompt | JSONPath not matching | Capture raw CLI output, verify paths - see guide |
| Empty responses | Content extraction failing | Check extract paths - see guide |