LaunchNext CLI と TUI
LaunchNext には 2 つのターミナルインターフェースがあります。
CLI: スクリプトや自動化向けの単発実行。TUI: 履歴付きの対話型ターミナルセッション。
実際には、この機能はターミナル上で動く AI Agent、たとえば Claude Code、Codex、それに近いローカル自動化ツール向けの用途と相性が良いです。GUI を手で操作しなくても、現在の LaunchNext レイアウト確認、アプリ検索、スナップショット取得、制御された変更実行まで行えます。
このページは LaunchNextCLI.swift、LaunchNextCLIIPC.swift、LaunchpadApp.swift、および現在の General 設定 UI の実装に合わせています。
利用前の準備
設定 > 一般を開く。- GUI endpoint を使う CLI コマンドや
--tuiを使う場合はEnable CLI codeをオンにする。 - GUI 依存コマンドを使う場合は LaunchNext GUI を起動したままにする。
重要な制約:
historyとhelpは GUI なしで動作。exampleも GUI なしで動作。list、snapshot、search、create-folder、moveは GUI プロセスが必要。- レイアウトロック有効時は
create-folder/moveは失敗。 --tuiは対話型ターミナル (TTY) 必須。
起動モード
bash
launchnext
launchnext --gui
launchnext --tui
launchnext --cli help
launchnext list次も利用できます:
bash
LaunchNext --cli help
LaunchNext --tui
/Applications/LaunchNext.app/Contents/MacOS/LaunchNext --tuiモード挙動:
- 引数なし
launchnext:- 対話型ターミナル -> TUI に入る
- 非対話環境 -> GUI モードのまま
--guiは常に GUI モード。--tuiは常に TUI モード。--cli <command>は 1 コマンド実行して終了。
CLI コマンド一覧
| コマンド | GUI 必須 | 内容 |
|---|---|---|
help | 不要 | 使い方とヘルプを表示。 |
list | 必要 | フラットなアプリ一覧を表示。 |
snapshot | 必要 | フォルダ ID を含むレイアウト JSON を出力。 |
history | 不要 | 保存済み CLI/TUI 履歴を表示。 |
example | 不要 | CLI/TUI サンプルコマンドを表示。 |
search | 必要 | 名前とパスでアプリ/フォルダを検索。 |
create-folder | 必要 | トップレベルアプリからフォルダを作成。 |
move | 必要 | ソース/ターゲット指定でアプリを移動。 |
search 詳細
利用例:
bash
launchnext --cli search --query "safari"
launchnext --cli search safari
launchnext --cli search --query "mail" --limit 20
launchnext --cli search --query "mail" --limit 20 --json補足:
limitのデフォルトは50limitの最大は500--jsonで構造化 JSON を返す
create-folder 詳細
利用例:
bash
launchnext --cli create-folder \
--path "/Applications/Mail.app" \
--path "/Applications/Notes.app" \
--name "Utilities" \
--index 12 \
--dry-runルール:
- 異なる
--pathを最低 2 つ指定する必要がある。 - 現在はトップレベルアプリのみ対応。
- フォルダ内アプリは拒否される。
--dry-runは検証とプレビュー JSON のみで、実変更は行わない。
move 詳細
基本形:
bash
launchnext --cli move --source normal-app --path "/Applications/Safari.app" --to normal-index --index 12 --dry-run現行ビルドで対応している組み合わせ:
normal-app -> normal-indexfolder-app -> normal-indexnormal-app -> folder-appendfolder-app -> folder-appendfolder-app -> folder-index
ターゲットごとの必須引数:
normal-index:--index <n>folder-append:--target-folder-id <id>folder-index:--target-folder-id <id> --index <n>
推奨フロー:
- 先に
snapshotで folder ID を確認。 --dry-runで事前検証。- 問題なければ
--dry-runを外して実行。
TUI 操作フロー
起動:
bash
launchnext --tuiTUI プロンプト (launchnext>) で使える主なコマンド:
listsnapshothistoryexamplesearchcreate-foldermoveclearhelpquit
TUI は履歴を永続化し、上下キーで履歴を再利用できます。
履歴とランタイムファイル
- 履歴ファイル:
~/Library/Application Support/LaunchNext/cli_history - CLI IPC ソケット:
~/Library/Application Support/LaunchNext/cli.sock - 履歴は最大
200件保持。
よくあるエラーと対処
CLI code is disabled
設定 > 一般 > Enable CLI codeをオンにする。- 注: 旧ビルドでは端末メッセージに "Development settings" と表示される場合があります。
Please launch LaunchNext GUI first
- 先に GUI を起動:
bash
open -a LaunchNextLayout is locked
move/create-folder実行前にレイアウトロックを解除。
LaunchNext TUI requires an interactive terminal
- 非対話シェルではなく通常のターミナルで実行する。