The Code Editor for AI Agents — Linux Fork

Orchestrate swarms of Claude Code, Codex, and more in parallel.
Works with any CLI agent. Built for local worktree-based development.

Linux Port: This fork brings first-class Linux support (Ubuntu 22.04/24.04, Arch Linux) to Superset Desktop with AppImage, .deb, and AUR packages.

Download for Linux  •  Download for macOS  •  Documentation  •  Changelog  •  Discord

Code 10x Faster With No Switching Cost

Superset orchestrates CLI-based coding agents across isolated git worktrees, with built-in terminal, review, and open-in-editor workflows.

• Run multiple agents simultaneously without context switching overhead
• Isolate each task in its own git worktree so agents don't interfere with each other
• Monitor all your agents from one place and get notified when they need attention
• Review and edit changes quickly with the built-in diff viewer and editor
• Open any workspace where you need it with one-click handoff to your editor or terminal

Wait less, ship more.

Features

Feature	Description
Parallel Execution	Run 10+ coding agents simultaneously on your machine
Worktree Isolation	Each task gets its own branch and working directory
Agent Monitoring	Track agent status and get notified when changes are ready
Built-in Diff Viewer	Inspect and edit agent changes without leaving the app
Workspace Presets	Automate env setup, dependency installation, and more
Universal Compatibility	Works with any CLI agent that runs in a terminal
Quick Context Switching	Jump between tasks as they need your attention
IDE Integration	Open any workspace in your favorite editor with one click

Supported Agents

Superset works with any CLI-based coding agent, including:

Agent	Status
Claude Code	Fully supported
OpenAI Codex CLI	Fully supported
Cursor Agent	Fully supported
Gemini CLI	Fully supported
GitHub Copilot	Fully supported
OpenCode	Fully supported
Pi	Fully supported
Any CLI agent	Will work

If it runs in a terminal, it runs on Superset

Requirements

Requirement	Details
OS	Linux: Ubuntu 22.04/24.04, Arch Linux  |  macOS
Runtime	Bun v1.0+
Version Control	Git 2.20+
GitHub CLI	gh
Caddy	caddy (for dev server)

Linux Installation

Choose your preferred distribution:

Distribution	Package	Install Command
Ubuntu/Debian	.deb	Download from Releases and run sudo dpkg -i superset-*.deb
Any Linux	AppImage	Download from Releases, chmod +x superset-*.AppImage, then run
Arch Linux	AUR	yay -S superset-bin or paru -S superset-bin

Note: This fork maintains Linux as a first-class platform with CI smoke gates for Ubuntu and Arch Linux.

Getting Started

Quick Start (Pre-built)

Download for Linux  •  Download for macOS

Build from Source

Click to expand build instructions

1. Clone the repository

git clone https://github.com/superset-sh/superset.git
cd superset

For this Linux fork: Use your own fork URL if you've forked the repository for Linux development.

2. Set up environment variables (choose one):

Option A: Full setup

cp .env.example .env
# Edit .env and fill in the values

Option B: Skip env validation (for quick local testing)

cp .env.example .env
echo 'SKIP_ENV_VALIDATION=1' >> .env

3. Set up Caddy (reverse proxy for Electric SQL streams):

# Install caddy:
# macOS: brew install caddy
# Ubuntu/Debian: sudo apt install caddy
# Arch: sudo pacman -S caddy
# Or see https://caddyserver.com/docs/install
cp Caddyfile.example Caddyfile

4. Install dependencies and run

bun install
bun run dev

5. Build the desktop app

# Build for current platform
bun run build

# Build specifically for Linux (generates AppImage + .deb)
bun run build:linux

# Open release folder
# macOS: open apps/desktop/release
# Linux: xdg-open apps/desktop/release

Linux Build Artifacts:

• apps/desktop/release/*.AppImage — Portable AppImage for any Linux distribution
• apps/desktop/release/*.deb — Debian package for Ubuntu/Debian

Note: Linux builds require native dependencies (node-pty, better-sqlite3, libsql) to be compiled for the target platform. The build process handles this automatically.

Keyboard Shortcuts

All shortcuts are customizable via Settings > Keyboard Shortcuts (⌘/). See full documentation.

Workspace Navigation

Shortcut	Action
⌘1-9	Switch to workspace 1-9
⌘⌥↑/↓	Previous/next workspace
⌘N	New workspace
⌘⇧N	Quick create workspace
⌘⇧O	Open project

Terminal

Shortcut	Action
⌘T	New tab
⌘W	Close pane/terminal
⌘D	Split right
⌘⇧D	Split down
⌘K	Clear terminal
⌘F	Find in terminal
⌘⌥←/→	Previous/next tab
Ctrl+1-9	Open preset 1-9

Layout

Shortcut	Action
⌘B	Toggle workspaces sidebar
⌘L	Toggle changes panel
⌘O	Open in external app
⌘⇧C	Copy path

Configuration

Configure workspace setup and teardown in .superset/config.json. See full documentation.

{
  "setup": ["./.superset/setup.sh"],
  "teardown": ["./.superset/teardown.sh"]
}

Option	Type	Description
setup	string[]	Commands to run when creating a workspace
teardown	string[]	Commands to run when deleting a workspace

Example setup script

#!/bin/bash
# .superset/setup.sh

# Copy environment variables
cp ../.env .env

# Install dependencies
bun install

# Run any other setup tasks
echo "Workspace ready!"

Scripts have access to environment variables:

• SUPERSET_WORKSPACE_NAME — Name of the workspace
• SUPERSET_ROOT_PATH — Path to the main repository

Internal Dependency Overrides

For the internal mastracode fork/bundle workflow used by this repo, see docs/mastracode-fork-workflow.md.

Tech Stack

Private by Default

• Source Available — Full source is available on GitHub under Elastic License 2.0 (ELv2).
• Explicit Connections — You choose which agents, providers, and integrations to connect.

Linux Support

This fork maintains Linux as a first-class platform, alongside macOS:

Feature	Status	Details
Ubuntu 22.04/24.04	✅ Supported	.deb packages and AppImage
Arch Linux	✅ Supported	AUR package superset-bin and AppImage
CI Smoke Tests	✅ Active	Automated Linux smoke gate in GitHub Actions
Build Artifacts	✅ Automated	AppImage + .deb generated on release
Process Metrics	⚠️ In Progress	Feature parity with macOS in development

Linux-Specific Development

# Run Linux smoke tests locally
bun run smoke:linux -- --profile ubuntu

# Run smoke tests for Arch
bun run smoke:linux -- --profile arch

# Full release build for Linux
bun run build:linux

See docs/architecture/SDD.md for detailed Linux architecture decisions and packaging/aur/ for Arch Linux packaging.

Contributing

We welcome contributions! If you have a suggestion that would make Superset better:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

You can also open issues for bugs or feature requests.

See CONTRIBUTING.md for detailed instructions and code of conduct.

Community

Join the Superset community to get help, share feedback, and connect with other users:

• Discord — Chat with the team and community
• Twitter — Follow for updates and announcements
• GitHub Issues — Report bugs and request features
• GitHub Discussions — Ask questions and share ideas

Team

License

Distributed under the Elastic License 2.0 (ELv2). See LICENSE.md for more information.