# tui-migrate-setup

tui-migrate-setup is a Warp Agent CLI skill that moves eligible settings and global MCP definitions from Warp GUI. It also identifies data already shared between the two environments.

- 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/tui-migrate-setup/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/tui-migrate-setup

## What it does

The skill checks which Warp GUI settings can be brought into Warp Agent CLI and prepares a merge of global file-based MCP definitions. Settings are checked against the schema, so only keys shared by the GUI and CLI qualify. It presents proposed additions and conflicts, then asks for separate approval before changing settings or MCP configuration.

A helper processes MCP files and returns counts plus a configuration fingerprint without exposing their contents. Credentials, OAuth state, and gallery-installed MCP servers are not transferred; those require fresh authentication or installation. Local file inspection requires Python 3.11 or newer. Existing CLI values remain in place unless their conflicts receive explicit approval.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dominikmartn/harp resources/bundled/skills/tui-migrate-setup
```

2. **Manually: put the files in place**
- File: `.github/skills/tui-migrate-setup/SKILL.md`

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

## When to use it
- bring shared Warp GUI settings into Warp Agent CLI
- merge global file-based MCP definitions
- identify data already shared between Warp environments
- keep existing CLI values for unapproved conflicts

## Example prompts
- Move the shared settings from Warp GUI into Warp Agent CLI.
- Check which global MCP definitions can be merged.
- Show which Warp data is already shared between the GUI and CLI.

## Similar
- [nemo-relay-migrate-from-flow](https://affpapa.org/en/nevibecode/skills/nemo-relay-migrate-from-flow.md) — skill · 171 installs
- [code-migrate](https://affpapa.org/en/nevibecode/commands/code-migrate.md) — command · ★ 42780 repo stars
- [migrate-webapi-selectall](https://affpapa.org/en/nevibecode/skills/migrate-webapi-selectall.md) — skill · ★ 1167 repo stars
- [convex-migrate](https://affpapa.org/en/nevibecode/skills/convex-migrate.md) — skill · 44100 installs
- [migrate-mstest-v3-to-v4](https://affpapa.org/en/nevibecode/skills/migrate-mstest-v3-to-v4.md) — skill · 4200 installs
- [migrate-to-parallel](https://affpapa.org/en/nevibecode/skills/migrate-to-parallel.md) — skill · 3800 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
