====== Superset ======

//Vytvořeno: **16.5.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://github.com/superset-sh/superset|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.

===== Rychlý závěr =====

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.

===== Co Superset řeší =====

Podle [[https://docs.superset.sh/overview|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ší.

===== Možnosti spuštění =====

==== Desktop aplikace ====

Nejvíce podporovaný způsob použití je desktop aplikace. README odkazuje na [[https://github.com/superset-sh/superset/releases/latest|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í.

==== CLI a lokální host server ====

Nejdůležitější zjištění pro serverové použití je [[https://docs.superset.sh/cli/host-server|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 [[https://docs.superset.sh/cli/getting-started|CLI Getting Started]]:

<code bash>
curl -fsSL https://superset.sh/cli/install.sh | sh
</code>

Přihlášení:

<code bash>
superset auth login
</code>

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

<code bash>
superset start --daemon
</code>

Kontrola stavu:

<code bash>
superset status
</code>

Zastavení:

<code bash>
superset stop
</code>

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:

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

==== Remote workspaces ====

[[https://docs.superset.sh/remote-workspaces|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:

<code bash>
superset auth login
superset start --daemon
superset status
</code>

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.

==== MCP server ====

Superset má také [[https://docs.superset.sh/mcp|MCP server]] pro připojení AI agentů. Dokumentace uvádí vzdálený endpoint:

<code>
https://api.superset.sh/api/v2/agent/mcp
</code>

Příklad pro Claude Code:

<code bash>
claude mcp add superset --transport http https://api.superset.sh/api/v2/agent/mcp
</code>

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.

==== Dev server ze zdrojáků ====

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

<code bash>
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
</code>

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.

===== Praktické využití =====

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.

===== Doporučení =====

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

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

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

  - použít dedikovaný stroj,
  - nainstalovat CLI,
  - spustit ''superset start --daemon'',
  - zapnout remote workspaces / relay,
  - přistupovat k němu z desktop aplikace.

===== Zdroje =====

  * [[https://github.com/superset-sh/superset|superset-sh/superset – GitHub repozitář]]
  * [[https://docs.superset.sh/overview|Superset Docs – Overview]]
  * [[https://docs.superset.sh/cli/getting-started|Superset Docs – CLI Getting Started]]
  * [[https://docs.superset.sh/cli/host-server|Superset Docs – Host Server]]
  * [[https://docs.superset.sh/remote-workspaces|Superset Docs – Remote Workspaces]]
  * [[https://docs.superset.sh/mcp|Superset Docs – MCP Server]]
  * [[https://github.com/superset-sh/superset/releases/latest|Superset – latest GitHub release]]