# gui-settings-ui

gui-settings-ui is a Claude Code skill for editing Warp GUI settings pages. It keeps widget visibility and settings search aligned with the page structure.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 720 repo stars
- Author: dominikmartn
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dominikmartn/harp/tree/HEAD/.agents/skills/gui-settings-ui/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/gui-settings-ui

## What it does

gui-settings-ui guides changes to Warp’s settings view. It covers `PageType`, `SettingsWidget`, page-level headings, and the search terms attached to each widget, so a settings page can be split and filtered consistently.

Search works at widget level: every word in a query must match the widget’s search string. The skill also separates checks made while constructing a page from `should_render`, which is evaluated again as the app runs. Fixed feature or platform conditions belong in page construction; values that can change during a session belong in the widget check.

The scope is limited to the GUI desktop app under `app/src/settings_view/`; it does not cover the headless TUI in `crates/warp_tui`. It applies when adding or editing a settings page, a `SettingsWidget`, or settings-search behavior.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill gui-settings-ui -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/gui-settings-ui/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/gui-settings-ui/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill gui-settings-ui -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/gui-settings-ui/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill gui-settings-ui -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/gui-settings-ui/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dominikmartn/harp .agents/skills/gui-settings-ui
```

2. **Manually: put the files in place**
- File: `.github/skills/gui-settings-ui/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill gui-settings-ui -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dominikmartn/harp --path .agents/skills/gui-settings-ui
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/gui-settings-ui/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dominikmartn/harp/tree/HEAD/.agents/skills/gui-settings-ui/SKILL.md

## When to use it
- create a Warp settings page with the right `PageType`
- place a heading in the page title slot or inside a widget
- scope search terms to the widget that owns the setting
- choose between build-time gating and `should_render`
- keep filtered settings pages from showing empty widget content

## Example prompts
- Add a settings page for a new Warp section and choose the right `PageType`.
- Check where the heading belongs and define `search_terms` for each `SettingsWidget`.
- Gate this widget with `should_render` when its availability can change during the session.

## Similar
- [roblox-gui](https://affpapa.org/en/nevibecode/skills/roblox-gui.md) — skill · 3700 installs
- [gova-declarative-gui](https://affpapa.org/en/nevibecode/skills/gova-declarative-gui.md) — skill · 290 installs
- [writing-settings-forms](https://affpapa.org/en/nevibecode/skills/writing-settings-forms.md) — skill · 1300 installs
- [macos-settings-ui](https://affpapa.org/en/nevibecode/skills/macos-settings-ui.md) — skill · 774 installs
- [verify-pi-gui](https://affpapa.org/en/nevibecode/skills/verify-pi-gui.md) — skill · ★ 364 repo stars
- [settings-pages](https://affpapa.org/en/nevibecode/skills/settings-pages.md) — skill · ★ 88 repo stars

From the same set: [dominikmartn/harp](https://affpapa.org/en/nevibecode/by/dominikmartn/harp.md) — 62 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
