tui-migrate-setup — Warp Agent CLI skill for setup migration
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.
AGPL-3.0 ★ 720 updated 2026-11-10
npx skills add dominikmartn/harp --skill tui-migrate-setup -a claude-codeWhat tui-migrate-setup 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.
What it helps with
- 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 for the agent
- 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.
How to install tui-migrate-setup
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tui-migrate-setup -a claude-code2Manually: put the files in place
~/.claude/skills/tui-migrate-setup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tui-migrate-setup/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tui-migrate-setup -a codex2Manually: put the files in place
.agents/skills/tui-migrate-setup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tui-migrate-setup -a cursor2Manually: put the files in place
.cursor/skills/tui-migrate-setup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp resources/bundled/skills/tui-migrate-setup2Manually: put the files in place
.github/skills/tui-migrate-setup/SKILL.md1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tui-migrate-setup -a gemini-cli2Platform CLI
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/skills/tui-migrate-setupManually: put the files in place
.devin/skills/tui-migrate-setup/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tui-migrate-setup
How do I install tui-migrate-setup in Claude Code?
Run npx skills add dominikmartn/harp --skill tui-migrate-setup -a claude-code. The skill file is installed at ~/.claude/skills/tui-migrate-setup/SKILL.md.
What does tui-migrate-setup do?
It checks Warp GUI settings and global file-based MCP definitions for transfer into Warp Agent CLI. The skill presents proposed changes and requests approval before applying them.
What does tui-migrate-setup need to run?
Local file inspection requires Python 3.11 or newer. Credentials and OAuth state are not transferred, so authenticated MCP servers need fresh authentication.