Zap への設定の移行

このガイドは、設定系の構成(カスタムキーバインド・テーマ・ワークフロー・ MCP 設定など)を以前のインストールから Zap へ引き継ぎたい方向けです。

移行元として想定されるのは 2 つあり、両者では安全性プロファイルが異なるため、本書では別々のセクションで扱います。両方該当する場合は、まず OpenWarp から移行してから Warp の移行を検討してください。

OpenWarp —— Zap の以前の名称。
上流の Warp —— Zap が fork しているプロジェクト。

本書はコマンド履歴・SQLite データベース・Drive オブジェクト・認証情報のいずれも 意図的に対象外 としています。これらはマシン依存のストア (Keychain / DPAPI / libsecret)、または schema が結合したストアに格納されているため、コピーは安全ではありません。

ディスク上のレイアウト

Zap(および OpenWarp / 上流 Warp も同様)はディスク上の状態を 3 種類のディレクトリに分けて格納します:

config —— settings.toml、keybindings.yaml
data —— themes/、workflows/、launch_configurations/、tab_configs/
home dotfile —— .mcp.json、skills/

macOS では 3 カテゴリーがいずれも単一の home dotfile ディレクトリ (~/.warp/、~/.openwarp/、または ~/.zap/)に集約されます。Linux では XDG 規約に従って 3 つの異なる場所 に分かれ、Windows では directories クレートの同等レイアウトで分かれます。下記の移行スクリプトはプラットフォームごとに各ファイルを正しい保存先に配置します。

Zap の保存先

カテゴリー	macOS	Linux	Windows
config	`~/.zap/`	`${XDG_CONFIG_HOME:-~/.config}/zap/`	`%LOCALAPPDATA%\zap\Zap\config\`
data	`~/.zap/`	`${XDG_DATA_HOME:-~/.local/share}/zap/`	`%APPDATA%\zap\Zap\data\`
home dotfile	`~/.zap/`	`~/.zap/`	`%USERPROFILE%\.zap\`

OpenWarp のソースパス

カテゴリー	macOS	Linux	Windows
config	`~/.openwarp/`	`${XDG_CONFIG_HOME:-~/.config}/openwarp/`	`%LOCALAPPDATA%\openwarp\OpenWarp\config\`
data	`~/.openwarp/`	`${XDG_DATA_HOME:-~/.local/share}/openwarp/`	`%APPDATA%\openwarp\OpenWarp\data\`
home dotfile	`~/.openwarp/`	`~/.openwarp/`	`%USERPROFILE%\.openwarp\`

上流 Warp のソースパス

カテゴリー	macOS	Linux	Windows
config	`~/.warp/`	`${XDG_CONFIG_HOME:-~/.config}/warp-terminal/`	`%LOCALAPPDATA%\warp\Warp-Terminal\config\`
data	`~/.warp/`	`${XDG_DATA_HOME:-~/.local/share}/warp-terminal/`	`%APPDATA%\warp\Warp-Terminal\data\`
home dotfile	`~/.warp/`	`~/.warp/`	`%USERPROFILE%\.warp\`

Linux 上のディレクトリ名 warp-terminal は Linux パッケージ名と一致します (Debian/Ubuntu では /opt/warpdotdev/warp-terminal/ など)。Windows 上の organization フォルダ名はパッケージ方法によって異なる場合があります。 %APPDATA%\warp\Warp-Terminal(または %LOCALAPPDATA%\warp\Warp-Terminal) に見つからない場合は、お使いの Warp が実際に使用している %APPDATA% / %LOCALAPPDATA% のパスを確認してください。

1. OpenWarp からの移行(既存ユーザーの推奨経路)

OpenWarp は改名前の Zap そのものです。改名コミット (feat: rename project Warp/OpenWarp → Zap)は識別子とディスク上のパス名を変更しただけで、設定ファイルのフォーマットと schema は一切変わっていません。下記のファイルはそのままコピーできます。

コピー対象

ファイル / ディレクトリ	カテゴリー	役割
`settings.toml`	config	公開設定(TOML ベースの設定ファイル)。
`keybindings.yaml`	config	カスタムキーバインド。
`themes/`	data	カスタムテーマ。
`workflows/`	data	カスタムワークフロー。
`launch_configurations/`	data	Launch 設定。
`tab_configs/`	data	Tab 設定。
`.mcp.json`	home dotfile	MCP サーバー設定。
`skills/`	home dotfile	Agent skills。

手順

コピー前に Zap を終了してください。プロセスがファイルを掴んでいると失敗します。

macOS

mkdir -p "$HOME/.zap"
for f in settings.toml keybindings.yaml themes workflows launch_configurations tab_configs skills .mcp.json; do
  if [ -e "$HOME/.openwarp/$f" ] && [ ! -e "$HOME/.zap/$f" ]; then
    cp -R "$HOME/.openwarp/$f" "$HOME/.zap/$f"
  fi
done

Linux

src_config="${XDG_CONFIG_HOME:-$HOME/.config}/openwarp"
src_data="${XDG_DATA_HOME:-$HOME/.local/share}/openwarp"
src_home="$HOME/.openwarp"

dst_config="${XDG_CONFIG_HOME:-$HOME/.config}/zap"
dst_data="${XDG_DATA_HOME:-$HOME/.local/share}/zap"
dst_home="$HOME/.zap"
mkdir -p "$dst_config" "$dst_data" "$dst_home"

copy() {
  if [ -e "$1/$3" ] && [ ! -e "$2/$3" ]; then
    cp -R "$1/$3" "$2/$3"
  fi
}

copy "$src_config" "$dst_config" settings.toml
copy "$src_config" "$dst_config" keybindings.yaml
copy "$src_data"   "$dst_data"   themes
copy "$src_data"   "$dst_data"   workflows
copy "$src_data"   "$dst_data"   launch_configurations
copy "$src_data"   "$dst_data"   tab_configs
copy "$src_home"   "$dst_home"   .mcp.json
copy "$src_home"   "$dst_home"   skills

Windows(PowerShell)

$src_config = "$env:LOCALAPPDATA\openwarp\OpenWarp\config"
$src_data   = "$env:APPDATA\openwarp\OpenWarp\data"
$src_home   = "$env:USERPROFILE\.openwarp"

$dst_config = "$env:LOCALAPPDATA\zap\Zap\config"
$dst_data   = "$env:APPDATA\zap\Zap\data"
$dst_home   = "$env:USERPROFILE\.zap"
New-Item -ItemType Directory -Force -Path $dst_config, $dst_data, $dst_home | Out-Null

function Copy-IfMissing($srcDir, $dstDir, $name) {
  $from = Join-Path $srcDir $name
  $to   = Join-Path $dstDir $name
  if ((Test-Path $from) -and -not (Test-Path $to)) {
    Copy-Item -Path $from -Destination $to -Recurse
  }
}

Copy-IfMissing $src_config $dst_config settings.toml
Copy-IfMissing $src_config $dst_config keybindings.yaml
Copy-IfMissing $src_data   $dst_data   themes
Copy-IfMissing $src_data   $dst_data   workflows
Copy-IfMissing $src_data   $dst_data   launch_configurations
Copy-IfMissing $src_data   $dst_data   tab_configs
Copy-IfMissing $src_home   $dst_home   .mcp.json
Copy-IfMissing $src_home   $dst_home   skills

[ ! -e ... ] / -not (Test-Path $to) のガードは、Zap 側で既にカスタマイズした内容を上書きしないためのものです。OpenWarp の値で上書きしたい場合は外してください。

Zap が問題なく動くことを確認したら、上記の OpenWarp ディレクトリを削除してディスク領域を回収できます。もう誰も使っていません。

2. 上流 Warp からの移行

上流 Warp は独立した別プロダクトで、独自のディスク上アイデンティティを持ちます(上の「上流 Warp のソースパス」表を参照)。Zap はビルド時の channel が Oss で、独自の app id(dev.zap.Zap)と、プラットフォームごとに分かれたレイアウトを持ちます。両者のインストールは互いに相手のファイルを見ることができません —— これは Warp のアカウントやクラウド状態を Zap に持ち込まないための仕様でもあります。

下記のテキスト形式ファイルは schema が安定しており、コピーしても安全です。 それ以外はそうではありません —— Warp は Zap とは独立に進化しており、バイナリ / プライベートストアは Warp の認証や bundle 識別子に紐付いている場合があります。

コピー対象

セクション 1 と同じ 8 項目です:

ファイル / ディレクトリ	カテゴリー	役割
`settings.toml`	config	公開設定(TOML ベースの設定ファイル)。
`keybindings.yaml`	config	カスタムキーバインド。
`themes/`	data	カスタムテーマ。
`workflows/`	data	カスタムワークフロー。
`launch_configurations/`	data	Launch 設定。
`tab_configs/`	data	Tab 設定。
`.mcp.json`	home dotfile	MCP サーバー設定。
`skills/`	home dotfile	Agent skills。

コピーしてはいけないもの

user_preferences.json —— macOS の ~/Library/Application Support/dev.warp.Warp/(Linux / Windows ではそれに相当する state ディレクトリ)にあるプライベートストアで、ユーザー設定・認証トークン・マシン依存 ID・クラウドキャッシュが混在しています。ファイルごとコピーすると ID 情報が漏れたり、Zap の認証状態が壊れたりします。 Zap のデフォルトはもともとプライバシー優先なので、触らないでください。
warp.sqlite(および -wal / -shm のサイドカー)—— schema が上流 Warp に結合しており、Zap の migration が通る保証はありません。
Keychain / DPAPI / libsecret のエントリ —— Warp の bundle / service 名に紐付いており、Zap からは利用できません。

手順

コピー前に Warp と Zap を終了してください。

macOS

mkdir -p "$HOME/.zap"
for f in settings.toml keybindings.yaml themes workflows launch_configurations tab_configs skills .mcp.json; do
  if [ -e "$HOME/.warp/$f" ] && [ ! -e "$HOME/.zap/$f" ]; then
    cp -R "$HOME/.warp/$f" "$HOME/.zap/$f"
  fi
done

Linux

src_config="${XDG_CONFIG_HOME:-$HOME/.config}/warp-terminal"
src_data="${XDG_DATA_HOME:-$HOME/.local/share}/warp-terminal"
src_home="$HOME/.warp"

dst_config="${XDG_CONFIG_HOME:-$HOME/.config}/zap"
dst_data="${XDG_DATA_HOME:-$HOME/.local/share}/zap"
dst_home="$HOME/.zap"
mkdir -p "$dst_config" "$dst_data" "$dst_home"

copy() {
  if [ -e "$1/$3" ] && [ ! -e "$2/$3" ]; then
    cp -R "$1/$3" "$2/$3"
  fi
}

copy "$src_config" "$dst_config" settings.toml
copy "$src_config" "$dst_config" keybindings.yaml
copy "$src_data"   "$dst_data"   themes
copy "$src_data"   "$dst_data"   workflows
copy "$src_data"   "$dst_data"   launch_configurations
copy "$src_data"   "$dst_data"   tab_configs
copy "$src_home"   "$dst_home"   .mcp.json
copy "$src_home"   "$dst_home"   skills

Windows(PowerShell)

$src_config = "$env:LOCALAPPDATA\warp\Warp-Terminal\config"
$src_data   = "$env:APPDATA\warp\Warp-Terminal\data"
$src_home   = "$env:USERPROFILE\.warp"

$dst_config = "$env:LOCALAPPDATA\zap\Zap\config"
$dst_data   = "$env:APPDATA\zap\Zap\data"
$dst_home   = "$env:USERPROFILE\.zap"
New-Item -ItemType Directory -Force -Path $dst_config, $dst_data, $dst_home | Out-Null

function Copy-IfMissing($srcDir, $dstDir, $name) {
  $from = Join-Path $srcDir $name
  $to   = Join-Path $dstDir $name
  if ((Test-Path $from) -and -not (Test-Path $to)) {
    Copy-Item -Path $from -Destination $to -Recurse
  }
}

Copy-IfMissing $src_config $dst_config settings.toml
Copy-IfMissing $src_config $dst_config keybindings.yaml
Copy-IfMissing $src_data   $dst_data   themes
Copy-IfMissing $src_data   $dst_data   workflows
Copy-IfMissing $src_data   $dst_data   launch_configurations
Copy-IfMissing $src_data   $dst_data   tab_configs
Copy-IfMissing $src_home   $dst_home   .mcp.json
Copy-IfMissing $src_home   $dst_home   skills

Warp 自体のデータは一切手を加えません —— Warp 本体はそのまま使い続けられます。

確認方法

Zap を起動すると、テーマピッカーにカスタムテーマ、キーバインドエディタにカスタムキーバインド、ワークフローランチャーにカスタムワークフローが見えるはずです。settings.toml に存在するキーは、設定 UI 上でも移行元の値が反映されます。

うまく反映されない場合、原因は上記 8 ファイルのいずれかに含まれています —— テキストエディタで開いて確認するか、削除して Zap のデフォルトに戻してください。

ロールバック

本書の操作はいずれも破壊的ではありません。コピーしたファイルはどれも Zap が起動時にデフォルトから再生成できるものです。すべてを元に戻すには:

# macOS
rm -rf ~/.zap

# Linux
rm -rf "${XDG_CONFIG_HOME:-$HOME/.config}/zap"
rm -rf "${XDG_DATA_HOME:-$HOME/.local/share}/zap"
rm -rf "$HOME/.zap"

# Windows
Remove-Item -Recurse -Force "$env:APPDATA\zap"
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\zap"
Remove-Item -Recurse -Force "$env:USERPROFILE\.zap"

OpenWarp および Warp のソースディレクトリは、いずれも本ガイドからは変更されません。

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Zap への設定の移行

ディスク上のレイアウト

Zap の保存先

OpenWarp のソースパス

上流 Warp のソースパス

1. OpenWarp からの移行(既存ユーザーの推奨経路)

コピー対象

手順

2. 上流 Warp からの移行

コピー対象

コピーしてはいけないもの

手順

確認方法

ロールバック

FilesExpand file tree

migrate-from-warp.ja.md

Latest commit

History

migrate-from-warp.ja.md

File metadata and controls

Zap への設定の移行

ディスク上のレイアウト

Zap の保存先

OpenWarp のソースパス

上流 Warp のソースパス

1. OpenWarp からの移行(既存ユーザーの推奨経路)

コピー対象

手順

2. 上流 Warp からの移行

コピー対象

コピーしてはいけないもの

手順

確認方法

ロールバック