superset-sh / superset
IDE for the AI Agents Era - Run an army of Claude Code, Codex, etc. on your machine
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing superset-sh/superset in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Embed this Badge
Showcase RepoMind's analysis directly in your repository's README.
Repository Overview (README excerpt)
Crawler viewThe Terminal for Coding Agents **Download for macOS** • Documentation • Changelog • Discord Why Superset? Superset is a turbocharged terminal that allows you to run any CLI coding agents along with the tools to 10x your development workflow. • **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 changes quickly** with built-in diff viewer and editor 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 | | Any CLI agent | Will work | If it runs in a terminal, it runs on Superset Requirements | Requirement | Details | |:------------|:--------| | **OS** | macOS (Windows/Linux untested) | | **Runtime** | Bun v1.0+ | | **Version Control** | Git 2.20+ | | **GitHub CLI** | gh | | **Caddy** | caddy (for dev server) | Getting Started Quick Start (Pre-built) **Download Superset for macOS** Build from Source Click to expand build instructions **1. Clone the repository** **2. Set up environment variables** (choose one): Option A: Full setup Option B: Skip env validation (for quick local testing) **3. Set up Caddy** (reverse proxy for Electric SQL streams): **4. Install dependencies and run** **5. Build the desktop app** Keyboard Shortcuts All shortcuts are customizable via **Settings > Keyboard Shortcuts** ( ). See full documentation. Workspace Navigation | Shortcut | Action | |:---------|:-------| | | Switch to workspace 1-9 | | | Previous/next workspace | | | New workspace | | | Quick create workspace | | | Open project | Terminal | Shortcut | Action | |:---------|:-------| | | New tab | | | Close pane/terminal | | | Split right | | | Split down | | | Clear terminal | | | Find in terminal | | | Previous/next tab | | | Open preset 1-9 | Layout | Shortcut | Action | |:---------|:-------| | | Toggle workspaces sidebar | | | Toggle changes panel | | | Open in external app | | | Copy path | Configuration Configure workspace setup and teardown in . See full documentation. | Option | Type | Description | |:-------|:-----|:------------| | | | Commands to run when creating a workspace | | | | Commands to run when deleting a workspace | Example setup script Scripts have access to environment variables: • — Name of the workspace • — Path to the main repository Internal Dependency Overrides For the internal fork/bundle workflow used by this repo, see docs/mastracode-fork-workflow.md. Tech Stack Contributing We welcome contributions! If you have a suggestion that would make Superset better: • Fork the repository • Create your feature branch ( ) • Commit your changes ( ) • Push to the branch ( ) • 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 Apache 2.0 License. See LICENSE.md for more information.