A community-driven registry for Claude, Cursor, Windsurf, Cline & more. Not affiliated with Anthropic.
Are you the author? Sign in to claim
CLI, SDK, and IDE plugins for Duel Agents
Use, extend, and ship with Duel Agents: the IDE-native routing layer that runs prompts against multiple models and picks the cheapest answer that still wins.
This repo is the official integration package for duelagents.com.
$DUEL is the tokenized equity of Duel Agents on Base (launched on Clanker launchpad) buy it by swapping ETH for the token on any Base DEX like Uniswap.
CA: 0x734636e5d8885f50df75edbd766184b733174b07
Every tool in this repo routes LLM traffic through https://duelagents.com/v1 with a Duel API key (duel_<prefix>_<secret>).
You cannot use raw Anthropic or OpenAI keys with these integrations. Get a key from the dashboard:
https://duelagents.com/dashboard/settings (subscribe → create API key)
# 1. Get your key from the dashboard, then:
export DUEL_API_KEY=duel_yourprefix_yoursecret
# 2. Install for your tools
npx @duel-agents/install all
# 3. Verify
npx @duel-agents/install doctor
| Tool | Command |
|---|---|
| Claude Code | npx @duel-agents/install claude-code |
| Cursor | npx @duel-agents/install cursor |
| Codex CLI | npx @duel-agents/install codex |
| OpenClaw | npx @duel-agents/install openclaw |
| All | npx @duel-agents/install all |
git clone https://github.com/2aronS/Duel-Agents.git
cd duel-agents
claude plugin install ./integrations/claude-plugin
npx @duel-agents/install claude-code
Use /duel-agents:setup in Claude Code for guided setup.
The installer copies a skill to .cursor/skills/duel-agents/ and writes DUEL_API_KEY to your project .env.
You still need to set Settings → Models → Override OpenAI Base URL to https://duelagents.com/v1 with your Duel key. See templates/cursor-models.override.md.
Writes OPENAI_BASE_URL and OPENAI_API_KEY (your Duel key) to .env. Restart Codex after install.
Patches ~/.openclaw/openclaw.json with a duel provider and sets default model to duel/duel-auto. Telegram/Discord channels are unchanged. Only the model backend switches to Duel.
npx @duel-agents/install openclaw
openclaw config validate
Reference config: templates/openclaw.duel.json5
Use @duel-agents/sdk in your apps, agents, and scripts. apiKey is required.
npm install @duel-agents/sdk
import { DuelClient } from "@duel-agents/sdk";
const duel = new DuelClient({
apiKey: process.env.DUEL_API_KEY!, // required (from dashboard)
});
// OpenAI-compatible
const chat = await duel.chat.completions.create({
model: "duel-auto",
messages: [{ role: "user", content: "Explain concurrent agents briefly." }],
});
// Anthropic-compatible
const msg = await duel.messages.create({
model: "duel-auto",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello" }],
});
Hermes Agent, Venice, and any OpenAI-compatible client can use the same pattern:
OPENAI_BASE_URL=https://duelagents.com/v1
OPENAI_API_KEY=duel_yourprefix_yoursecret
Duel is OpenAI wire compatible, so it works with the major Python frameworks.
pip install langchain-duel # LangChain
pip install llama-index-llms-duel # LlamaIndex
from langchain_duel import ChatDuel
llm = ChatDuel(model="duel-auto") # reads DUEL_API_KEY
llm.invoke("Explain concurrent agents in one sentence.")
from llama_index.llms.duel import DuelLLM
llm = DuelLLM(model="duel-auto") # reads DUEL_API_KEY
llm.complete("Explain concurrent agents in one sentence.")
Source for both lives in python/. They default to duel-auto
routing and the https://duelagents.com/v1 proxy.
Any LangChain or LlamaIndex OpenAI client works by pointing at the proxy:
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="duel-auto",
base_url="https://duelagents.com/v1",
api_key="duel_yourprefix_yoursecret",
)
| Variable | Purpose |
|---|---|
DUEL_API_KEY | Your Duel API key (required) |
DUEL_AGENTS_API_KEY | Alias accepted by the installer |
DUEL_PROXY_URL | Override proxy URL (staging only) |
OPENCLAW_CONFIG_PATH | Custom OpenClaw config path |
| Symptom | Fix |
|---|---|
Invalid API key format | Key must be duel_ + 8 chars + _ + 32 chars. Create one at the dashboard. |
401 from doctor | Key revoked or subscription inactive. Create a new key on billing/settings. |
Could not reach Duel API | The proxy at duelagents.com/v1 must be running. Key format can still be valid; retry later. |
| OpenClaw won't start | Run openclaw config validate after install; restore from openclaw.json.bak if needed. |
| Cursor still uses OpenAI | Confirm model override URL and that the API key field is your duel_* key. |
| Skill copy failed after npm install | Re-run npm run build in the repo, or reinstall @duel-agents/install. Skills ship inside the package. |
packages/core @duel-agents/core validation, env maps, connectivity
packages/cli @duel-agents/install installer CLI
packages/sdk @duel-agents/sdk TypeScript API client
integrations/ Claude plugin, Cursor skill, OpenClaw skill
python/ langchain-duel, llama-index-llms-duel
templates/ Example env and config files
npm install
npm run build
npm test
See CONTRIBUTING.md.
MIT. See LICENSE.
npx CLI installing 100+ agents, commands, hooks, and integrations in one command
Native macOS app to monitor Claude AI usage limits and watch your coding sessions live
干净、强大、属于你的 AI Agent 平台 --AI agents, without the clutter.
Pocket Flow: Codebase to Tutorial