setup
/setup
Make a repository Paradev (formerly Superset)-ready by writing .paradev/config.toml (install, setup, terminals, archive, ports) so every new workspace, local or cloud, comes up configured, converting an old config.json, then verifying with a real workspace. Use when the user wants to set up a project or repo for Paradev, configure workspace setup scripts, convert config.json to config.toml, or fix a failing workspace setup ("new workspaces don't have node_modules", "my .env is missing in workspaces", "setup script isn't running").
- Author
- superset-sh ↗
- Repository
- superset ↗
- Licence
- MIT
- Last repository change
- 13.11.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Make a repository Paradev (formerly Superset)-ready by writing .paradev/config.toml (install, setup, terminals, archive, ports) so every new workspace, local or cloud, comes up configured, converting an old config.json, then verifying with a real workspace. Use when the user wants to set up a project or repo for Paradev, configure workspace setup scripts, convert config.json to config.toml, or fix a failing workspace setup ("new workspaces don't have node_modules", "my .env is missing in workspaces", "setup script isn't running").
Triggers from the description
Arguments
/setup optional notes about the project's setup needs
Original author description
Make a repository Paradev (formerly Superset)-ready by writing .paradev/config.toml (install, setup, terminals, archive, ports) so every new workspace, local or cloud, comes up configured, converting an old config.json, then verifying with a real workspace. Use when the user wants to set up a project or repo for Paradev, configure workspace setup scripts, convert config.json to config.toml, or fix a failing workspace setup ("new workspaces don't have node_modules", "my .env is missing in workspaces", "setup script isn't running").
How it works
- 1. Inspect the repo
- 2. Write config.toml
- 3. Ship it
- 4. Verify for real
SKILL.md preview
---
name: setup
description: Make a repository Paradev (formerly Superset)-ready by writing .paradev/config.toml (install, setup, terminals, archive, ports) so every new workspace, local or cloud, comes up configured, converting an old config.json, then verifying with a real workspace. Use when the user wants to set up a project or repo for Paradev, configure workspace setup scripts, convert config.json to config.toml, or fix a failing workspace setup ("new workspaces don't have node_modules", "my .env is missing in workspaces", "setup script isn't running").
argument-hint: optional notes about the project's setup needs
allowed-tools: Bash(superset:*) Bash(paradev:*)
---
# Paradev Project Setup
`paradev` is an alias for the `superset` CLI: every `superset` command here also runs as `paradev`.
Goal: every new workspace for this repo, a local worktree or a cloud box, comes up ready, with dependencies installed, env present and services reachable, without manual steps.
## 1. Inspect the repo
Work out what a fresh workspace needs, and ask about anything ambiguous:
- Package manager and install command (lockfiles decide: bun/pnpm/yarn/npm, cargo, uv, ...)
- Env files: `.env` is usually gitignored, so a new worktree needs it copied from the main checkout or generated from `.env.example`
- Services (docker-compose, databases), the dev command and its ports
- Monorepo layout (does a step need a `cwd`?)
- Where the config lives. New repos use `.paradev/`. A repo set up before the rename has it in `.superset/`, which Paradev still reads: keep editing it there (a `.paradev/` folder holding only pdev's `settings.json`, `agents/` or `prompts/` does not count). Note what is already there: `config.toml`, or the old `config.json`, `config.local.json` and `ports.json`
## 2. Write `config.toml`
In the folder from step 1 (`.paradev/` for a new repo; for a repo still on `.superset/`, read `.superset/` wherever the examples below say `.paradev/`). Moving an existing `.superset/` to `.paradev/` is optional; do it only if the user asks, in one commit: move its files into `.paradev/` (keep pdev's files already there; `git mv .superset .paradev` is only right when `.paradev/` doesn't exist), and change `./.superset/` paths in the config's commands and in scripts to `./.paradev/`.
**If the repo still has `config.json`, convert it.** `config.json` is the old format: Paradev reads `config.toml` first and ignores `config.json` when both exist. Tell the user, translate it, and delete `config.json` and `ports.json` in the same change.
| `config.json` | `config.toml` |
|---|---|
| `setup` | `[setup]` |
| `teardown` | `[archive]` (outside cleanup only, see below) |
| `run` | `[terminals.dev]` with `default = true` |
| `cwd` | `cwd` on each table |
| `<key>.sh` in the config folder, found by name | written out in `run` |
| `config.local.json` with `before`/`after` | `config.local.toml` with full `run` lists |
The format:
```toml
[install] # cacheable prep, no per-workspace state
run = ["bun install"]
[setup] # get this workspace ready
run = ["./.paradev/setup.sh"]
[setup.cloud] # replaces keys of [setup] in the cloud
run = ["./.paradev/setup.cloud.sh"]
[terminals.dev] # long-running
run = "bun dev"
default = true
[archive] # outside cleanup only
run = ["docker compose down"]
[ports.web]
default = 3000
label = "Web"
preview = true # cloud: gets a preview URL
```
When each table runs:
| Table | Local | Cloud |
|---|---|---|
| `[install]` | before `setup`, at creation | when the environment's image is built |
| `[setup]` | once, at creation | on every boot and resume, so it must be safe to run again |
| `[terminals.<name>]` | from the Run button; `default` ones start with it | `default` ones start on boot |
| `[archive]` | before the worktree is removed | at archive, before the box stops; never blocks the archive |
| `[ports.<name>]` | | `default` is the port; `preview = true` publishes it (at most 13) |
Rules:
- `run` is a string or an array of commands, each in its own shell. `setup` and `install` stop at the first failure. `run = []` turns a table off.
- `[x.cloud]` and `[x.local]` are merged key by key over `[x]` in that environment.
- Names match `^[a-z][a-z0-9_]*$`. Unknown keys are errors.
- Every step gets `SUPERSET_ENV` (`local` or `cloud`), `SUPERSET_WORKSPACE_NAME` and, locally, `SUPERSET_ROOT_PATH` (the main checkout). Per-port variables are not set yet: do not rely on `SUPERSET_PORT_<NAME>`.
- Keep `setup` idempotent and fast; put workspace-independent installs in `[install]`.
- `[archive]` is for outside resources (a database branch, `docker compose down`). Paradev already stops processes and deletes the worktree.
- Copy secrets and `.env` from the main checkout (`$SUPERSET_ROOT_PATH`) at setup time; never commit them.
- Personal tweaks go in `config.local.toml`, next to `config.toml` in the main checkout. It is gitignored, applies to every worktree, is merged over the shared file, and the cloud never reads it.
Show the user the proposed files and get explicit approval before writing.
## 3. Ship it
Commit the change on a branch. If there is no open pull request for it, offer to open one, and ask before pushing. New workspaces read `config.toml` from their own branch, so it applies to the whole team once it is on the base branch.
## 4. Verify for real
Create a throwaway workspace with `superset workspaces create --local --project <id> --name "setup-test" --branch setup-test --base-branch <the branch from step 3>` and watch the "Workspace Setup" terminal output. Fix and repeat until it completes cleanly, then delete the test workspace with `superset workspaces archive --local <id>` and its branch with `git branch -D setup-test`. Setup is not done until a real workspace boots green.
Files in this package (2)
- SKILL.md 6 KB
- agents/openai.yaml 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · superset-sh/superset | 100 | MIT |
| HwangSlater/harness-fit | 100 | MIT |
| nesquikm/dev-process-toolkit | 100 | MIT |
| userKael/rastro | 100 | MIT |
| als-apg/osprey | 100 | BSD-3-Clause |
| dedujeong/gemba | 100 | Apache-2.0 |
| eigenwise/eigenwise-toolshed | 100 | MIT |
| awrshift/agent-memory-kit | 100 | MIT |
| lifecycle-innovations-limited/claude-ops | 100 | MIT |
Database snapshot: 13.11.2026 · package version 2a6f75beab02 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100contribute
Set up a Paradev (formerly Superset) open-source contribution, from forking and cloning paradevai/paradev through local dev setup and the repo's rules to a merge-ready PR. Use when the user wants to contribute to Paradev, fix a Paradev bug themselves, add a feature to Paradev,… - 90doctor
Diagnose and fix Paradev (formerly Superset) problems such as connection failures, offline hosts, terminals not attaching, auth or update issues. Use when the user reports something broken or misbehaving in Paradev itself ("Paradev won't connect", "my host shows offline",… - 100supervising-paradev-workspaces
Use when asked to dispatch Paradev workspaces for a list of issues and then watch them until their PRs merge - "dispatch workspaces for issues 310-315 and monitor them", "keep the open PRs up to date with main", "tell green PRs to merge", "archive workspaces once their PR… - 100setting-up-worktree-hooks
Gives a repository one idempotent, repo-local worktree setup script (local env files, dependency install, build steps) that worktrunk's `.config/wt.toml` pre-start hook and Orca's `orca.yaml` scripts.setup both call, so every new git worktree is usable at once. Use when adding… - 100clippy-configuration
Use when configuring Clippy for Rust projects with TOML config, lint groups, attributes, and workspace setup. - 100workspace-setup
Set up a development workspace for working with a coding agent - code repo, a wiki the agent maintains as its second brain (Karpathy's LLM Wiki pattern), raw-sources folder, run/debug config and agent instructions - on Azure DevOps, GitHub or local only, for any stack, and warns…