SuperAgent Logo

SuperAgent

One sentence. Full team. Auto delivery.

AI-Native orchestrator with persistent agent identity, shared team learning, retry/circuit-breaker resilience, atomic operations, scheduled 24/7 execution, code verification, and OpenAPI tool bridge. From any goal to a working solution.

$ Get Started →
73 Commands 178 Roles 13 LLM Providers Chat REPL + SUPERAGENT.md 296 Tests

Watch It Work

Smart Orchestrator analyzes your goal, builds the perfect team, executes in parallel, then synthesizes results.

superagent

Real-Time Agent Visualization

Agents move between zones as they plan, code, debug, and test -- all visible in a pixel-art virtual office.

star-office dashboardLIVE
Rest
Work
Bug Fix
Strategist
Sales-Eng
Marketer
Creator
Idle
0%

Run superagent auto "goal" --command builtin --dashboard to see it live

Star Office -- Pixel Monitoring

A full pixel-art virtual office -- agents move between zones as they work.

star-office -- pixel office recording GIF
Star Office pixel-art dashboard recording

Idle → Writing → Executing → Bug Fix → Syncing → Complete -- all in a cozy pixel office

Interactive Knowledge Graph

Ingest documents into an LLM Wiki. Explore connections with an interactive vis.js graph.

Source Entity Concept Comparison Synthesis

superagent wiki ingest docs/ then superagent wiki graph --format html

By the Numbers

Scale meets simplicity.

73
CLI Commands
18
Integrated Projects
178
Agent Roles
14
Departments
296
Automated Tests
13
LLM Providers
78
Source Modules
90%+
Parallel Speedup

What Can SuperAgent Do?

Any goal. Smart team. Parallel execution. Real results.

🧠

Smart Orchestrator

LLM analyzes your goal and dynamically picks the best roles from 178 templates across 14 departments.

superagent auto "Make $100" --smart

Parallel Execution

Mythos pattern: workers run concurrently via asyncio.gather. 90%+ speedup on multi-agent tasks.

superagent auto "Build an app" --parallel
👤

Agent Profiles

Persistent agent identity with experience tracking, domain expertise, and correction learning. Agents grow smarter over time. (Moxt pattern)

superagent auto "goal" --command builtin
🔄

Shared Corrections

Fix one agent, all agents learn. Corrections propagate across the entire team via shared memory injection. (Moxt pattern)

superagent corrections add "Use TypeScript"

24/7 Scheduled Execution

Cron-style agent task automation. Schedule nightly monitoring, weekly reports, hourly analysis. (Moxt pattern)

superagent schedule add "Monitor" --cron "0 2 * * *"
📨

Async Injection

Send new requirements to running teams mid-execution. Leaders re-evaluate and incorporate directives at synthesis checkpoints.

superagent inject send team "Add dark mode"
🛡

Resilient LLM Calls

Exponential backoff retry (3x), per-provider circuit breaker, atomic file writes, thread-safe SQLite, transaction batching.

Auto retry on 429/5xx + circuit breaker
💻

Code Execution

Verify agent-generated code locally with timeout, output capture, file detection, and guardrail safety checks. (OpenAgents pattern)

superagent exec "print(42)"
🔌

OpenAPI Tool Bridge

Import any tool from ai-plugin.json + OpenAPI specs. ChatGPT/OpenAgents plugin standard compatible. (OpenAgents pattern)

Standard plugin manifest support
📚

LLM Wiki

Karpathy-style knowledge base: ingest docs, extract entities, cross-reference with wiki-links, query with LLM.

superagent wiki ingest paper.pdf
🌐

Browse the Web

A real browser agent that navigates, clicks, extracts data from any website.

superagent browser run "Find trending AI"
🔒

Safety Guardrails

Input + output safety checks, blocks destructive commands, scans imported skills, sandboxed execution via E2B.

superagent guardrail list
🔄

Auto-Learn Skills

Records outcomes, learns from failures, auto-evolves. Skill packs for community sharing.

superagent skill auto-evolve
🎮

Live Dashboard

Pixel-art office + Hermes HUD Web UI. Agents move between zones in real-time as they work.

superagent auto "goal" --dashboard
🌐

Gateway & Mobile Web UI

Persistent HTTP server with REST API + mobile-friendly Web UI. Monitor and control teams from your phone. (CodeBuddy/OpenClaw pattern)

superagent serve --port 7890
🔄

Checkpoint / Rewind

Auto-snapshots before each agent edit. Revert unwanted changes with one click. Your safety net for autonomous execution. (CodeBuddy pattern)

superagent checkpoint list --session s1
📨

Channel Bridge

Bidirectional messaging with WeCom, DingTalk, Feishu, and webhooks. DM pairing auth, inbound queue, and reply routing. (CodeBuddy/OpenClaw pattern)

POST /api/v1/channels/webhook/wecom

Background Workers

Run tasks in background with ps/logs/kill. Daemon mode for persistent service. PID file registry with auto-cleanup. (CodeBuddy pattern)

superagent worker bg "Refactor auth"
💰

Zero-Cost Local Mode

Run everything with Ollama/LocalAI/llama.cpp. No API keys, no costs.

superagent auto "goal" --command local
🚀

Publish Anywhere

Multi-platform content publishing: Medium, Dev.to, WordPress, Zhihu, Juejin.

superagent publish article.md
💬

Chat REPL

Interactive AI coding assistant with streaming responses, tool execution, slash commands, and session persistence. Like CodeBuddy Code in your terminal.

superagent chat
📄

SUPERAGENT.md

Project-level instruction cascade. Like CLAUDE.md and CODEBUDDY.md — deeper files take priority, section-aware merge across directories.

SUPERAGENT.md
🎯

Strategy Presets

Shared endpoint presets and reusable agent runtime profiles. Configure once, deploy across teams and projects.

superagent preset list / superagent profile list
🤖

Auto Model Selection

13 built-in LLM provider presets with auto-discovery. LLM Gateway picks the best model per task based on category and complexity.

superagent llm list / superagent auto "goal"
📝

Self PR / Auto Issue

Create pull requests from uncommitted changes with one command. Auto-report persistent failures as GitHub Issues.

superagent pr "Fix auth" / superagent issue report

Integrated Projects

Standing on the shoulders of 577k+ stars.

Firecrawl 91k Browser-use 86k RAGFlow 75k DeerFlow 60k Mem0 52k Hermes 47k LocalAI 45k Aider 25k GPT-Researcher 18k Composio 12k Star-Office 7k E2B 7k ClawTeam 5k Langfuse LiteLLM Graphify OpenAgents patterns Moxt patterns

Architecture

From any goal to delivery in one pipeline.

superagent auto "goal" --smart --command builtin --dashboard
    |
    +-- Smart Orchestrator (LLM-powered goal analysis)
    |     +-- Complexity detection (simple/moderate/complex)
    |     +-- Dynamic role matching from 178 templates
    |     +-- Team composition with permission levels
    |
    +-- Execution Engine (3-phase Mythos pattern)
    |     +-- Phase 1: Leader planning
    |     +-- Phase 2: Workers parallel execution (asyncio.gather)
    |     +-- Phase 3: Synthesis review (quality + completeness)
    |
    +-- Knowledge Layer
    |     +-- LLM Wiki (Karpathy: raw -> wiki -> index)
    |     +-- 3-layer memory (conversation/persistent/skill)
    |     +-- Interactive knowledge graph (vis.js)
    |     +-- SHA256 incremental cache
    |
    +-- Safety Layer
    |     +-- Guardrails (block rm -rf, drop table)
    |     +-- E2B Sandbox (isolated execution)
    |     +-- Skill threat scanning
    |
    +-- Visualization
          +-- Dashboard (pixel-art virtual office)
          +-- Knowledge graph (HTML interactive)
          +-- Rich terminal output

Quick Start

From zero to autonomous agents in 3 steps.

1

Install

pip install superagent-cli
2

Run a Task

superagent auto "Build a REST API" --smart --command builtin
3

Watch & Learn

# Open dashboard: superagent auto "goal" --dashboard # Build knowledge: superagent wiki ingest docs/ superagent wiki graph --format html