Paradev (formerly Superset)
Run Claude Code, Codex, or another CLI agent with terminals, code review, and browser previews in one workspace.
Download for macOS • Documentation • Changelog • Discord
What is Paradev?
Paradev is a desktop app for running CLI coding agents in parallel. Each task gets its own Git worktree, branch, and terminals, so Claude Code, Codex, OpenCode, Gemini CLI, Cursor Agent, or any other CLI agent can work on several tasks in one repository at the same time.
Paradev is for developers who already use a coding agent in the terminal and want to run more than one task at once, without juggling terminal tabs and branches by hand.
A single agent CLI runs one session in one terminal, and an editor is built around one checkout. Paradev adds the workspace around the agents:
- One worktree per task: agents work in separate copies of the repository, on separate branches
- Review in the app: a Changes pane to review, commit, push, and open pull requests, and a pull request pane with checks, review threads, and merge
- In-app browser: preview each workspace's dev server, with ports detected per workspace
- Agent status: the sidebar shows which agent is working, done, or waiting on you
- Beyond one machine: remote hosts, an iPhone and iPad app, and automations that start agents on a schedule or from an event (Pro plan)
Paradev is not a coding agent itself. You bring your own agent subscriptions and API keys, and Paradev does not proxy model calls.
Platforms: macOS (Apple Silicon and Intel). Linux as an experimental x64 AppImage. Windows is not yet available.
Formerly Superset: Paradev was previously named Superset, and the CLI command is still superset. It is unrelated to Apache Superset, the business intelligence tool.
Paradev vs. alternatives: Cursor · Codex app · Conductor
Documentation for agents
The docs are available as a Markdown index linking to individual pages, or one full-text file.
Install
Download the desktop app:
All you need installed is Git. gh is optional and enables the PR workflows; Paradev offers to install it for you.
Start with one task
- Install Paradev and add a repository from your computer or clone one.
- Create a workspace, choose your CLI agent, and describe a small change you want to make.
- Inspect its patch in Changes, run the relevant tests, and preview your app in the browser pane before committing.
For a walkthrough of workspace creation and review, see Your First Parallel Session.
Review and revise
- Change your app's UI. Use Design in the browser pane to select an element and send your requested change to an agent with element context. Walkthrough · Design Mode docs
- Ask an agent to fix a PR. Open Pull requests → Code, select diff lines, and send feedback to a running or new agent session. Posting to GitHub is optional. Walkthrough · PR docs
- Review a report with your team. Ask an agent to publish a Page. Teammates pin comments, and a watching agent can revise it at the same link. Keep its host and session running for feedback delivery. Walkthrough · Pages docs
Built-in Diff Viewer
Inspect, comment on, and edit agent changes without leaving the app, then commit and push when it's ready.
Docs →
In-App Browser & Ports
Preview running dev servers in a browser pane. Ports are detected per workspace, so every worktree gets its own preview.
Docs →
Run independent tasks
Give each task a Git worktree with its own branch and terminals. Worktrees separate working files; they do not sandbox processes or prevent merge conflicts.
Workspace docs · Terminal docs · Agent status
Parallel Workspaces
Review each result before merging, or try two approaches to the same problem and keep the one you prefer.
Docs →
Agent Monitoring
Track every agent from the sidebar, with working indicators, completion chimes, and dock badges when one needs your attention.
Docs →
Built-in Terminal
Tabs, infinite splits, presets, and persistent sessions that survive restarts. Press ⌘I for a rich prompt editor with multiline editing and @-file mentions.
Docs →
Command Palette
Jump to any workspace, action, or setting from one search box.
Docs →
This is the beginning of the README. Read the rest at the original. Read the full README ↗
