docs · for agents

CLI & skill

@oetzi/cli is a zero-dependency Node 20 client over the REST API. Same capability names, same envelope, exit codes that map to error codes, so a coding agent can shell out and branch on the result.

Install and log in

terminal

npx @oetzi/cli login            # paste a workspace API key from Settings
oetzi whoami                    # the workspace and the key's scopes

The key lands in ~/.config/oetzi/config.json. OETZI_API_KEY and OETZI_BASE_URL override it, handy in CI.

Commands

terminal

oetzi capabilities "people who liked"       # search
oetzi schema pull_engagers                  # exact input
oetzi run get_leads --status=new --band=hot --limit=10
oetzi run run_signal_now --signal-id=<id>                          # dry run
oetzi run run_signal_now --signal-id=<id> --approved --max-credits 2 --wait
oetzi run record_outreach --json '{"person_id":"…","channel":"x_reply","outcome":"sent","agent":"claude-code"}'
oetzi jobs wait <job id>
oetzi events tail --types lead.hot,person.discovered
oetzi skill                                  # SKILL.md into ~/.claude/skills/oetzi

Flags become input fields (--signal-id is signal_id), numbers and booleans are coerced, and --json takes a whole object. Every command prints the envelope as JSON.

Exit codes

code	meaning
0	ok
1	internal
2	usage or invalid_input
3	approval_required
4	budget_exceeded or insufficient_credits
5	scope_denied (or no key)
6	not_found
7	rate_limited
8	the job failed (with --wait or jobs wait)
9 · 10	conflict · unsupported

The skill file

https://www.oetzi.ai/skill serves a SKILL.md in the Agent Skills format Claude Code and OpenClaw both load: what Oetzi is, the rules, the loop, and the full capability reference, rendered from the same registry as the API. oetzi skill writes it to ~/.claude/skills/oetzi/SKILL.md. Point Claude Code at the MCP server and load the skill, and it knows how to work the workspace without further prompting.

Claude Code

claude mcp add --transport http oetzi https://www.oetzi.ai/api/mcp --header "Authorization: Bearer oetzi_YOUR_KEY"
npx @oetzi/cli skill

See the agent overview for scopes, the spending gate, jobs, and events.