Skill and CLI
The recommended way. One line gives any agent with a shell the supe command and the instructions to use it.
Set up supe using https://oex.sh/SKILL.mdPaste that into your agent. SKILL.md is a short guide written for agents: how to install supe, find and run tools, follow your money rules, and sign in. Your agent reads it, sets itself up, and keeps the guide where it loads skills.
This works with any agent that can run commands: Claude Code, Codex, Cursor's agent, Gemini CLI, your own scripts.
Why the CLI
- It never waits for input. Every command finishes on its own and says what happened with an exit code, so an agent can't get stuck on a prompt.
- Big results go to files.
-o out.jsonkeeps a large answer out of the agent's context. - Local files just work. A tool that wants a link to an image also takes
./photo.png; supe uploads it first. - It reads like a person would type it.
supe frankfurter#rate --path from=EUR --path to=USD.
Install by hand
npm i -g @supe-sh/cli # Node 18 or later
supe skill --save ~/.claude/skillssupe skill --save <dir> writes <dir>/supe/SKILL.md. Point it at the folder your agent loads skills from. To try it without installing, put npx @supe-sh/cli in front of any command.
Sign in
Sign-in takes two commands, so it never blocks:
supe login --email you@example.com --name "Codex on build-server"
supe login --code 123456The first prints a link. You open it, sign in and approve, and the page shows a code for the second command. --name is how you'll see this agent on the Agents page.
Check it:
supe whoami # the workspace, this agent, and what it spent today
supe balance # the wallet, in creditsSeveral agents on one machine
Each supe login adds an agent. supe agents lists them; --agent <name> (or SUPE_AGENT) picks one for a command. supe logout revokes the current one.
In CI or a server
Skip the sign-in and use a key from the dashboard (Agents → Get an API key):
export SUPE_API_KEY=oex_live_...
supe run frankfurter#rate --path from=EUR --path to=USD| Variable | What it does |
|---|---|
SUPE_API_KEY | A dashboard key, used instead of a signed-in agent |
SUPE_RUN | Bill every call to this run (Runs and budgets) |
SUPE_AGENT | Act as this signed-in agent |
SUPE_BASE_URL | Another server |
SUPE_CONFIG_DIR | Where sign-ins are kept |
Every command is in the CLI reference.