dragoman-ai 0.6.2

A small CLI that lets Claude Code reach non-Anthropic models — Ollama, Perplexity, OpenAI, Gemini — through a subagent that knows how to call it.

🐉 Dragoman

Give Claude Code access to every other AI model you pay for.

You use Claude Code. You also pay for Perplexity, OpenAI, Gemini, or run Ollama locally. Right now Claude can't reach any of them. Dragoman fixes that — it plugs into Claude Code's sub-agent system and lets it route questions to the right model, automatically.

What does that look like?

You're in Claude Code and ask: "What happened in the news today about the OpenAI acquisition?"

Instead of "I don't have web access," Claude recognizes this is a search question, hands it to Dragoman, and Dragoman routes it to Perplexity — which was built for exactly that. The answer comes back into your Claude session with sources.

More things you can do:

• 🔍 Search the web — "Find me sources on X," "what's the latest on Y" → routes to Perplexity
• 🧠 Ask another model — "What would GPT-5 say?" or "Try Gemini on this" → routes to that provider
• 🏠 Stay local — "Run this through Llama on my machine" → routes to Ollama, nothing leaves your network
• 🔀 Fan out — Send the same question to four models and have Claude synthesize the best answer
• 🎯 Upgrade selectively — Coding in Sonnet, but need Opus + GPT-5 for a deep research question? Just ask

Example — multi-model editing pipeline in one prompt:

"Take my draft. Send it to Opus for a deep prose edit. Then send the result to o3 for structural consistency. Then send that to Perplexity for citations and prior art. Apply fixes after each step."

Claude chains three sub-agents in sequence — each calls the right model via Dragoman, applies the feedback, and passes the improved draft to the next. One prompt, three models, fully automated.

Install

# Homebrew (macOS)
brew install asakin/tap/dragoman

# uv (fastest)
uv tool install dragoman-ai

# pipx
pipx install dragoman-ai

Then run the setup wizard:

dragoman init

It walks you through connecting your providers — API keys, Ollama hosts, whatever you use — and installs the sub-agent persona into Claude Code. Open a fresh Claude Code session and try: "What's the latest news on [topic]?"

Your keys never leave your machine

Dragoman resolves API keys at call time from wherever you already keep them, uses each key for one request, and throws it away. The key never enters Claude's context window.

# ~/.config/dragoman/config.toml

[providers.perplexity]
type = "openai_compat"
host = "https://api.perplexity.ai"
api_key = "op://Personal/Perplexity/credential"   # 1Password CLI

[providers.openai]
type = "openai_compat"
host = "https://api.openai.com/v1"
api_key = "keychain://openai/apikey"               # macOS Keychain

[providers.ollama]
type = "openai_compat"
host = "http://localhost:11434/v1"                  # no key needed

Supported secret backends: 1Password CLI (op://), macOS Keychain (keychain://), and environment variables (env:).

This isn't a hack — it's how sub-agents are supposed to work

Anthropic built a genuinely good sub-agent architecture into Claude Code. Sub-agents get their own context, their own persona, and their own mission — completely separated from the parent. Dragoman is just one example of what that architecture makes possible with very little code.

You don't need a plugin system that doesn't exist yet. You don't need to reverse-engineer anything. And when Anthropic improves their sub-agent runtime — better fan-out, richer permissions, longer context — Dragoman gets better for free.

What it writes

What	Where	Created by	Removed by
Provider config	~/.config/dragoman/config.toml	dragoman init	dragoman uninstall --purge-config
Sub-agent files	~/.claude/agents/dragoman/	dragoman init	dragoman uninstall
Persona block	~/.claude/CLAUDE.md (inline, between <!-- BEGIN DRAGOMAN --> markers)	dragoman init	dragoman uninstall

Clean removal: dragoman uninstall reverses everything. Add --purge-config to also delete your provider config.

Platform support

	Status
macOS	✅ Fully supported
Linux	✅ Works — keychain:// is macOS-only, but op:// and env: work everywhere
Windows	❓ Untested — PRs welcome

Telemetry

None. Dragoman makes no outbound calls of its own — only to the provider endpoints you configured.

Contributing

See CONTRIBUTING.md. Small PRs welcome; commits need DCO sign-off (git commit -s). Contributor Covenant applies.

License

Apache 2.0 — see LICENSE.

---

Dragoman was the translator-fixer at Ottoman, Levantine, and European courts. The English word and the Hebrew meturgeman share an Akkadian root and have nothing to do with reptiles. The 🐉 emoji is a typo I refuse to fix. There is also no evidence that dragons were actually reptiles.