# modify-settings

modify-settings is a Claude Code skill that inspects and edits Warp terminal preferences using JSON Schema. It updates the user TOML configuration without breaking nested sections.

- 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/resources/bundled/skills/modify-settings/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/modify-settings

## What it does

The skill navigates the Warp terminal configuration schema to discover valid keys and update settings in the TOML file. It spots candidate properties with `grep`, then resolves the exact dotted path via `find_setting.py`. That script outlines parameter types, defaults, and permitted values.

Each schema level maps directly into dotted TOML section headers. The target file is generated automatically when missing. Warp applies new values instantly through hot-reloading.

Running the bundled path helper requires `python3`. Precise hierarchy tracing prevents misplaced keys in complex nested sections.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dominikmartn/harp resources/bundled/skills/modify-settings
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/skills/modify-settings
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/modify-settings/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/resources/bundled/skills/modify-settings/SKILL.md

## When to use it
- locate setting keys inside the Warp JSON schema
- update appearance and input parameters in the Warp TOML file
- verify accepted types and enum values for Warp options
- generate missing Warp configuration files with valid section nesting

## Example prompts
- Set the font size to 14 in my Warp configuration
- Check what input modes are supported in Warp settings
- Switch the Warp theme to light mode in the TOML file

## Similar
- [iterm2-layout](https://affpapa.org/en/nevibecode/skills/iterm2-layout.md) — skill · 126 installs
- [vtex-io-app-settings](https://affpapa.org/en/nevibecode/skills/vtex-io-app-settings.md) — skill · 1300 installs
- [codex-1m-context-window-setup](https://affpapa.org/en/nevibecode/skills/codex-1m-context-window-setup.md) — skill · 211 installs
- [mcp-server-architect](https://affpapa.org/en/nevibecode/agents/mcp-server-architect.md) — subagent · 1649 installs
- [cli-anything-iterm2](https://affpapa.org/en/nevibecode/skills/cli-anything-iterm2.md) — skill · 559 installs
- [workflows-modify](https://affpapa.org/en/nevibecode/skills/workflows-modify.md) — skill · 495 installs

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
