Runtime environment
Every SuperAgent has a full computing environment at its disposal.| Capability | Details |
|---|---|
| Shell | Full bash access — run any command, pipe data, automate workflows |
| Python 3 | Pre-installed with pip. Install any package. Scripts run via uv run for dependency isolation |
| Node.js | Pre-installed with npm. Build webhooks, data processors, anything |
| Background processes | PM2 process manager for long-running scripts — data collectors, websocket listeners, webhooks |
| Persistent filesystem | Files survive restarts, pauses, and updates. Your data stays |
| Internet access | Full outbound access — call APIs, fetch data feeds, post webhooks |
Writing effective soul.md
Soul.md is the single most important thing you’ll write. It shapes every decision your agent makes. Here’s how to write a good one.Be specific, not generic
Vague instructions produce vague behavior. Give your agent a clear identity.Define risk boundaries clearly
Risk rules should be unambiguous. The agent will interpret them literally.Give a decision framework, not a script
Tell it how to think, not what to do. A framework adapts to changing markets — a script breaks.Example: Perp scalper
Example: Risk sentinel
Example: Research analyst
Playbooks
Don’t want to write a soul.md from scratch? Pick a playbook — a pre-built agent strategy with soul.md, interactive onboarding, and skill dependencies. Launch it, answer a few setup questions, and the agent configures itself. Browse official playbooks from the dashboard or create your own by pushing a repo to GitHub.Memory
SuperAgents have two files that define who they are and what they know:- soul.md — your instructions. You write it, you control it.
- memory.md — the agent’s brain. It writes it, it controls it. You can read it.
How memory works
Your agent automatically maintains memory.md as it operates. It remembers:- Trade outcomes and what it learned from them
- Market observations and patterns it’s noticed
- Your preferences and communication style
- Strategies that worked and ones that didn’t
Working with memory
Read it regularly
Check memory.md from the dashboard or API. Understand what your agent thinks it knows. This is the most underrated thing you can do.
Course-correct via soul.md
If memory shows the agent learning wrong lessons (“ETH always bounces at $3k”), add guidance in soul.md to override it (“Don’t assume historical levels hold — markets change”).
Scheduling
Tell your agent what to do and when, in natural language. It handles the rest.How to set schedules
Just tell it via Telegram or the chat interface:- “Check BTC funding rates every 4 hours and alert me if they’re extreme”
- “Run a portfolio review every morning at 8am UTC”
- “Scan Polymarket for new high-volume markets every 6 hours”
- “Check if ETH breaks $4k in 30 minutes”
Supported intervals
| Format | Example |
|---|---|
| Natural language | ”every 4 hours”, “daily at 9am UTC”, “every Monday at noon” |
| Cron expressions | 0 */4 * * *, 0 9 * * * |
| One-time delays | ”in 30 minutes”, “at 3pm UTC today” |
Good scheduling patterns
Skills
Skills extend what your agent can do. They follow the Agent Skills open standard — the same format used by Claude Code, OpenClaw, Cursor, and 26+ other platforms.What’s built in
Every SuperAgent ships with official skills for the core trading stack:| Skill | Capability |
|---|---|
| hyperliquid | Perp and spot trading, position management, account analytics |
| polymarket | Prediction markets — discovery, research, trading, portfolio |
| gigabrain-intel | Market research, web search, news, sentiment, on-chain data |
| portfolio-tracker | Cross-chain portfolio overview and P&L |
| evm-wallet | EVM transfers, balances, transaction history |
| solana-wallet | Solana transfers, balances, token management |
| solana-swap | Token swaps via Jupiter |
Installing community skills
Paste a GitHub URL to your agent in chat. It installs and syncs automatically. Browse skills on skills.sh (110,000+), ClawHub (2,800+), or GitHub.Writing your own
A skill is a folder with aSKILL.md file and optional scripts. No SDK, no API wrapper — just markdown instructions. Write one in 10 minutes.
Skills can also include long-running background scripts (via PM2) for data collection, webhook listeners, or custom monitoring.
See the full Skills documentation for format details, examples, and management.
Models
Choose the right LLM for your agent’s job.Supported providers
| Provider | Models | Best for |
|---|---|---|
| Anthropic | Claude Opus 4.6, Sonnet 4.6 | Deep reasoning, careful risk assessment, detailed analysis |
| OpenAI | GPT-5.4, GPT-5.4 Pro, o3, o4-mini | Fast execution, broad knowledge, strong reasoning |
| xAI | Grok 4.20 | Real-time X/Twitter awareness, fast agentic tool use |
| OpenRouter | 200+ models | Access to any model — Llama, Mistral, Gemini, and more |
| Venice | Privacy-focused models | Uncensored inference, no content filtering |
Bring your own subscription
Already paying for ChatGPT? Use it with your SuperAgent:- ChatGPT Plus/Pro — paste your token to use GPT and o-series models via your subscription
Choosing a model
- Complex analysis (macro regimes, multi-factor decisions) — reasoning models like GPT-5.4 Pro, o3, or Claude Opus 4.6
- Fast execution (scalping, time-sensitive trades) — GPT-5.4, Claude Sonnet 4.6, or Grok 4.20
- Research-heavy (news analysis, narrative tracking) — Claude Sonnet 4.6 or GPT-5.4
- Experimental — try different models and see what clicks with your strategy
Lifecycle tips
Pause when idle
Not trading? Pause the agent. Costs nothing. All state is preserved — memory, files, schedules, everything.
Resume seamlessly
Resume picks up exactly where it left off. Memory intact, schedules restart, files untouched.
Restart without fear
Restarts are seamless. No state is lost. Use it if something feels stuck.
Iterate on soul.md
Soul.md and model changes take effect immediately — no restart needed. Iterate fast and often.
Next steps
Setup Guide
Create and launch your first SuperAgent
Skills Reference
Browse available skills and write your own
Use Cases
Strategy ideas and inspiration
API Reference
Manage agents programmatically