Skip to Content
supedocs

Quickstart

From nothing to your agent's first tool call in about two minutes.

Give your agent the skill

Paste this into Claude Code, Codex, Cursor or any agent that can run commands:

Paste into your agentRecommended
Set up supe using https://oex.sh/SKILL.md

The agent installs the CLI and saves the instructions where it keeps skills, for example:

npm i -g @supe-sh/cli
supe skill --save ~/.claude/skills

No shell, as in the Claude or ChatGPT app? Use MCP instead and skip to step 3.

Approve the sign-in

The agent asks for your email and starts a sign-in:

supe login --email you@example.com --name "Claude Code on my laptop"

Open the link it prints, sign in, and approve. The page shows a code: read it back to your agent, which finishes with supe login --code <code>. The agent now appears on your dashboard's Agents page under the name it gave.

Add credits

Open Wallet on the dashboard and add credits. 1,000 credits are $1. Many tools are free; you only need credits for paid ones.

Ask for something

Ask your agent for anything a tool can do, such as "what's the euro to dollar rate today?". It finds a tool, reads it, and runs it:

supe find "exchange rates"
supe inspect frankfurter#rate
supe run frankfurter#rate --path from=EUR --path to=USD

The last command prints the provider's answer, then the tool, the cost and a link to the receipt:

{
  "date": "2026-11-17",
  "base": "EUR",
  "quote": "USD",
  "rate": 1.1033
}
frankfurter#rate · 0 credits · https://app.oex.sh/activity/run_58f5f2fbc4f0

The call is on the dashboard's Activity page too.

Next

  • Set limits before an agent runs anything expensive.
  • Read how it works: tools, runs, credits and confirmations in one page.

On this page