# Superset Settings

Read and update the Paradev desktop app's user settings (theme, fonts, terminal, git...

- Repository: https://github.com/ParadevAI/Paradev (15823 stars)
- Category: Design
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ParadevAI/Paradev --skill superset-settings -g -a claude-code -y`
Codex: `npx skills add ParadevAI/Paradev --skill superset-settings -g -a codex -y`
Cursor: `npx skills add ParadevAI/Paradev --skill superset-settings -g -a cursor -y`
Gemini CLI: `npx skills add ParadevAI/Paradev --skill superset-settings -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ParadevAI/Paradev`

## Description

Read and update the Paradev desktop app's user settings (theme, fonts, terminal, git, notifications, behavior) via the superset CLI, including creating and installing custom themes from JSON. Use when asked to change app settings, switch or create a theme, adjust fonts, or configure desktop preferences without opening the settings UI.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Paradev settings via CLI

Change the desktop app's user settings from the command line with
`superset settings`. Works offline, no login required; everything is local
to this machine.

## Commands

```bash
superset settings list                 # every key: value, default, allowed values
superset settings get <key>            # effective value (default if unset)
superset settings set <key> <value>    # validated write
superset settings reset <key>          # back to the app default

superset settings theme list           # system + built-ins + imported custom themes
superset settings theme get
superset settings theme set <id>       # e.g. dark | light | monokai | system | <custom id>
superset settings theme set system --system-light light --system-dark monokai

superset settings theme export <id> [--out <file>]  # dump full theme JSON (starter)
superset settings theme import <file>               # add/replace custom themes (validated)
superset settings theme remove <id>                 # delete a custom theme
```

Prefer `--json` (auto-on in agent environments; parse it rather than
matching the human sentences) and `superset settings list` to discover keys
and allowed values instead of guessing. In Paradev terminals `superset` is
already on PATH. `SUPERSET_HOME_DIR` overrides the target profile
(`~/.superset` by default); useful for testing against a sandbox copy.

## Creating custom themes

Two paths; both end with import → set (a running app restyles live).

**From scratch**: a minimal file is enough. Every color you omit is filled
in from the built-in base theme for your declared `type`, so start small and
override only what you care about:

```json
{
  "name": "Midnight Ocean",
  "type": "dark",
  "ui": {
    "background": "#071A2E",
    "sidebar": "#061426",
    "primary": "#38BDF8"
  },
  "terminal": { "background": "#071A2E", "cursor": "#38BDF8" }
}
```

The rest: https://github.com/ParadevAI/Paradev/blob/HEAD/.agents/skills/superset-settings/SKILL.md