# tab-configs

tab-configs is a Claude Code skill that documents Warp tab config schemas and checks. It activates while creating or editing tab-config TOML files.

- 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/tab-configs/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/tab-configs

## What it does

tab-configs documents how Warp tab config TOML files are structured. It covers display fields, the flat `[[panes]]` collection, leaf and split nodes, commands, working directories, shells, focus, and pane types.

The skill lists tree checks for unique IDs, valid `children` references, acyclic layouts, and a single focused pane at most. It also explains parameter tables, `{{name}}` templates, and the reserved `{{autogenerated_branch_name}}` variable. Standard Warp builds read configs from `~/.warp/tab_configs/`; channel builds such as Preview use a path like `~/.warp-<channel>/tab_configs/`.

The config directory must match the active Warp build. tab-configs also supplies shared context for `create-tab-config` and `update-tab-config`, and can be invoked directly for creating or editing a file.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

## When to use it
- create a Warp tab layout in TOML
- validate pane references and unique node IDs
- assign commands, directories, shells, and initial focus
- define project or branch parameters for a tab
- locate the config directory for a Warp channel

## Example prompts
- Create a Warp tab config for `~/code/my-app` with editor and server panes.
- Check this Warp TOML file for invalid `children` links, pane types, and focus settings.
- Update the tab config with a branch parameter and use `{{branch}}` in a startup command.

## Similar
- [bmad-customize](https://affpapa.org/en/nevibecode/skills/bmad-code-org-bmad-customize.md) — skill · 17000 installs
- [configs-update](https://affpapa.org/en/nevibecode/skills/configs-update.md) — skill · 1900 installs
- [configs-variations](https://affpapa.org/en/nevibecode/skills/configs-variations.md) — skill · 1900 installs
- [platform-custom-tab-generate](https://affpapa.org/en/nevibecode/skills/platform-custom-tab-generate.md) — skill · 6000 installs
- [tab-accordion](https://affpapa.org/en/nevibecode/skills/tab-accordion.md) — skill · 1100 installs
- [nemo-mbridge-perf-moe-hardware-configs](https://affpapa.org/en/nevibecode/skills/nemo-mbridge-perf-moe-hardware-configs.md) — skill · 1800 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
