README

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:

- macOS: Apple Silicon (.dmg) · Intel (.dmg)
- Linux: x64 AppImage (experimental; macOS is the primary target)
- Windows: not yet available
- All builds

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

1. Install Paradev and add a repository from your computer or clone one.
2. Create a workspace, choose your CLI agent, and describe a small change you want to make.
3. 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 ru

Top issues

Latest release

What's Changed
 docs: Bring Your Own Cloud guide and the MIT license blog post by @Kitenite in https://github.com/ParadevAI/Paradev/pull/9382
 chore(desktop): bump version to 2.0.5 by @Kitenite in https://github.com/ParadevAI/Paradev/pull/9380
 fix(desktop): keep host data cached when a host looks unreachable by @Kitenite in https://github.com/ParadevAI/Paradev/pull/9373
 fix(desktop): report an offline cloud API on plugins.sync as unavailable by @superset-home in https://github.com/ParadevAI/Paradev/pull/9385
 fix(chat): keep a chat's permission mode across resume, fork and recovery by @harsh