Superset

Vytvořeno: 16.5.2026 | Aktualizováno: 16.05.2026 06:43

Superset od superset-sh je open-source platforma pro práci s AI coding agenty. Není to primárně self-hostovaná webová aplikace typu „spustím server a otevřu ho v prohlížeči“, ale hlavně desktopové IDE a CLI nástroj pro orchestraci agentů nad izolovanými git worktrees.

Z průzkumu repozitáře a dokumentace vyplývá:

• Superset je primárně desktopová aplikace / IDE pro AI agenty.
• Existuje také CLI a lokální host server, který se dá spustit headless přes superset start –daemon.
• Host server není plnohodnotné webové UI pro prohlížeč. Je to lokální HTTP daemon, se kterým komunikuje desktop aplikace nebo CLI.
• Pro „serverové“ použití dává největší smysl režim CLI host server + remote workspaces.
• Repo obsahuje i web/API části a dev stack, ale ten je určený hlavně pro vývoj Supersetu, ne jako jednoduchý self-host deployment.

Podle oficiálního přehledu dokumentace je Superset dostupný jako desktop IDE, command-line interface a MCP server. Hlavní myšlenka je spouštět více AI coding agentů paralelně, každý v samostatném git worktree.

Prakticky to znamená:

• více agentů může pracovat na různých úkolech současně,
• každý úkol má vlastní branch a pracovní adresář,
• není potřeba neustále přepínat větve přes git checkout,
• změny se dají kontrolovat přes vestavěný diff viewer,
• workspaces lze otevírat v editoru nebo terminálu,
• podporované jsou CLI agenti jako Claude Code, Codex, Cursor Agent, Gemini CLI, OpenCode a další.

Nejvíce podporovaný způsob použití je desktop aplikace. README odkazuje na aktuální GitHub release, odkud se stahují hotové buildy.

Dokumentace uvádí jako požadavky hlavně macOS, Git a přihlášené GitHub CLI. V releasech se objevuje i Linux AppImage, ale dokumentace k produktu pořád popisuje macOS jako hlavní podporované prostředí.

Nejdůležitější zjištění pro serverové použití je Host Server v CLI dokumentaci. Příkaz superset start spouští headless HTTP server, se kterým komunikuje desktop aplikace nebo CLI.

Instalace CLI podle CLI Getting Started:

curl -fsSL https://superset.sh/cli/install.sh | sh

Přihlášení:

superset auth login

Spuštění host serveru na pozadí:

superset start --daemon

Kontrola stavu:

superset status

Zastavení:

superset stop

Host server spravuje na daném stroji:

• projekty,
• workspaces,
• git worktrees,
• porty,
• terminály,
• běhy agentů.

Důležité omezení: podle dokumentace binduje pouze na 127.0.0.1. Není to tedy webová služba určená k přímému vystavení do sítě.

Lokální stav se ukládá do:

~/.superset/config.json
~/.superset/host/<organizationId>/manifest.json
~/.superset/host/<organizationId>/host.db

Remote Workspaces jsou praktická varianta, pokud má Superset běžet na jiném stroji než klient. Workspace zůstává na hostitelském stroji, kde jsou soubory, terminály a porty, ale desktop klient k němu přistupuje přes Superset Relay.

Typický scénář:

• na dedikovaném stroji běží Superset host server,
• do stejné organizace je přihlášen desktop klient,
• workspace se otevírá vzdáleně přes relay,
• agenti běží na hostitelském stroji.

Spuštění hostu pro remote workspaces:

superset auth login
superset start --daemon
superset status

Tohle je nejbližší režim představě „agentí server“, ale nejde o běžný webový server s lokálním web UI. Přístup se řeší přes Superset klienta a relay.

Superset má také MCP server pro připojení AI agentů. Dokumentace uvádí vzdálený endpoint:

https://api.superset.sh/api/v2/agent/mcp

Příklad pro Claude Code:

claude mcp add superset --transport http https://api.superset.sh/api/v2/agent/mcp

MCP server umožňuje agentům pracovat s:

• tasks,
• workspaces,
• projekty,
• hosty,
• automations,
• spouštěním agentů ve workspaces.

Autentizace je přes OAuth 2.1 nebo API key. To je vhodné pro integraci agentů, ale nejde o lokálně self-hostovaný MCP server z repozitáře.

Repozitář jde spustit i ze zdrojáků jako vývojový stack. README uvádí postup:

git clone https://github.com/superset-sh/superset.git
cd superset
cp .env.example .env
echo 'SKIP_ENV_VALIDATION=1' >> .env
cp Caddyfile.example Caddyfile
caddy trust
bun install
bun run dev

Root package.json spouští přes Turbo hlavně tyto části:

• @superset/api – Next.js API na portu 3001,
• @superset/web – Next.js web na portu 3000,
• @superset/desktop – Electron desktop aplikace,
• electric-proxy,
• Caddy proxy pro Electric SQL streamy.

V .env.example jsou ale proměnné pro více externích služeb: Neon, Better Auth, GitHub OAuth/App, Vercel Blob, PostHog, Resend, Stripe, Upstash Redis/QStash, Superset MCP API key a relay URL. To naznačuje, že bun run dev je primárně vývojové prostředí pro autory Supersetu, ne jednoduchý self-host deployment.

Superset dává smysl hlavně tehdy, když se aktivně používají coding agenti a je potřeba je koordinovat nad více branchi najednou.

Vhodné scénáře:

• paralelní práce více AI agentů na jednom repozitáři,
• rychlé zakládání izolovaných workspaces přes git worktrees,
• review změn od agentů před mergem,
• dedikovaný stroj pro agentní běhy,
• vzdálené workspaces přes relay,
• automatizace úkolů a agentních běhů přes CLI, MCP nebo SDK.

Méně vhodné scénáře:

• běžná webová aplikace pro prohlížeč bez desktop klienta,
• jednoduchý Docker deployment na vlastní server,
• lokální náhrada za GitHub/GitLab,
• self-hostovaný orchestrátor bez napojení na Superset cloud/organizaci.

Pokud cílem je vyzkoušet Superset prakticky, nejrozumnější postup je:

1. nainstalovat desktop aplikaci nebo CLI,
2. přihlásit se přes superset auth login,
3. ověřit superset status,
4. zaregistrovat projekt,
5. vytvořit workspace,
6. zkusit spustit agenta v izolovaném worktree.

Pokud cílem je „server pro agenty“, vhodnější je:

1. použít dedikovaný stroj,
2. nainstalovat CLI,
3. spustit superset start –daemon,
4. zapnout remote workspaces / relay,
5. přistupovat k němu z desktop aplikace.

• superset-sh/superset – GitHub repozitář
• Superset Docs – Overview
• Superset Docs – CLI Getting Started
• Superset Docs – Host Server
• Superset Docs – Remote Workspaces
• Superset Docs – MCP Server
• Superset – latest GitHub release