liminal-overview

name	liminal-overview
description	Entry point for LiminalPalette HTTP API automation via the bundled `liminal` CLI. Explains the seven liminal-* skills and which one to pick, plus links to references on ports/auth/troubleshooting. Invoke this first when a task mentions LiminalPalette.
when_to_use	User mentions LiminalPalette, LP, or asks to script a Unity Editor / Play Mode action. Trigger phrases: "LP のヘルスチェック", "LP に何ができる", "Unity を CLI で操作", "list available commands", "what skills are there for the palette".
allowed-tools	Bash(liminal *), Bash(jq *), Read

liminal-overview

LiminalPalette (LP) は Unity プロジェクトに [LiminalCommand] で登録された C# メソッドを HTTP API 経由で実行できるライブラリ。AI Agent (Claude Code 等) が Editor / Play Mode を CLI で自動操作することを主用途とする。

このスキルは LP を使う 最初の入り口。専用 CLI liminal 経由で叩く前提で、他 7 個の liminal-* スキルへの索引と運用ルールを提供する。

liminal はトークン読み込みとポート発見を自動でやるので、各スキルでセットアップを書く必要はない。Editor を再起動した後でも liminal 側で再スキャンされる。

---

前提: liminal CLI

LP リポジトリ同梱の Tools~/liminal/liminal (Python 3 標準ライブラリのみ、依存ゼロ) を PATH に通しておく。

ln -s "<liminal-palette-package-path>/Tools~/liminal/liminal" ~/.local/bin/liminal
liminal health   # → ok ... が出れば設定 OK

詳細: Tools~/liminal/README.md。

自動化される項目	出所
トークン	~/.liminal-palette/token (Editor 初回起動時に自動生成) または $LP_TOKEN
ベース URL	~/.liminal-palette/ports.json のキャッシュ → 失敗時 7610〜7615 を short timeout で probe
ターゲットプロジェクト	--project / $LP_PROJECT / cwd の ProjectSettings/ProjectVersion.txt 検出 (/health の projectName+projectPath で照合)

明示したい場合は --token, --port, --base-url, --project で個別に上書きできる。複数 Unity プロジェクトが同時起動しているときは liminal doctor で全体像を確認すると速い。

---

ワークフロー早見表

やりたいこと	使うスキル	liminal サブコマンド
新規プロジェクトの環境確認 / 固定ポート設定	(直接実行)	liminal init [--port N --runtime-port M]
LP が起動しているか確認	/liminal-find-port	liminal health / liminal doctor
利用できるコマンドを発見	/liminal-list-commands	liminal commands [--filter Player/]
コマンドを実行する	/liminal-execute	liminal exec <path> key=value...
現在のゲーム状態を読む	/liminal-get-state	liminal state [<path>]
直近の実行履歴を見る	/liminal-get-logs	liminal logs --limit N
宣言済みシナリオ一覧	/liminal-list-scenarios	liminal scenarios
シナリオ実行 (named/ad-hoc)	/liminal-run-scenario	liminal run <path> / liminal run --steps -

典型フロー 1: 探索 → 実行 → 検証

liminal health → liminal commands --filter Player/ → liminal exec ... → liminal state Player/HP

典型フロー 2: 統合テスト (1 リクエストで複数操作)

liminal scenarios → liminal run <path>     # named
liminal run --steps -                  # ad-hoc を stdin から流す

典型フロー 3: 失敗した実行をデバッグ

liminal logs --json | jq '.invocations[] | select(.result.success==false)' → liminal commands --filter <prefix> → liminal exec ... (修正)

---

--json で機械可読モード

人間向けの装飾 (色 / 整形) を切って生 JSON が出る。jq と組み合わせる時に使う:

liminal commands --json | jq -r '.commands[] | select(.path | startswith("Player/")) | .path'
liminal logs --limit 100 --json | jq '.invocations[] | select(.result.success == false)'
liminal state --json | jq '.fields[] | select(.value != null)'

通常は色付き整形で出るので --json 無しのまま読めば良い。

---

主要事実 (詳細は references/)

• ポート割り当て: Editor=7610, Play Mode=7611, build=7610。Production build は コンパイル除外で応答しない。詳細: references/ports.md
• 認証: Bearer token。liminal が自動で読む。漏洩時は ~/.liminal-palette/token を削除→Editor 再起動で再生成。詳細: references/auth.md
• レートリミット: liminal exec と liminal run で 30 req/s 共有。1 秒スライディングウィンドウ
• body 上限: 全 POST endpoint で 1 MB
• Production 除外: HTTP サーバ自体が Player Production からコンパイル除外される

---

ULoop と LiminalPalette の使い分け

両方インストール済み環境での選択基準:

やりたいこと	推奨	理由
Unity Editor 自体の操作 (asset 作成, scene 編集)	uloop-*	Editor SDK へのフルアクセス
Game View スクリーンショット	uloop-screenshot	LP に対応 endpoint なし
利用側プロジェクトに [LiminalCommand] で公開された ゲームロジック	liminal-*	プロジェクトコードへの最短パス
ゲーム内 reactive 状態 (ReactiveProperty<T>) を読む	liminal-get-state	Observable 専用の endpoint
spawn → wait → assert の連鎖 (統合テスト)	liminal-run-scenario ad-hoc	fail-fast + 1 リクエストで完結

両方の名前空間に似た skill (例: uloop-get-logs vs liminal-get-logs) があるが 目的が違う ことに注意:

• uloop-get-logs → Unity Console 全体 (Debug.Log* 含む)
• liminal-get-logs → LP の invocation history のみ

---

エラー早見

liminal の exit code:

code	状況
0	成功
1	HTTP / ネットワーク / トークン未設定など使用エラー
2	サーバには届いたが success: false (exec / run)

HTTP status 別の対処:

Status	意味	一次対処
401	Token 不一致/欠落	~/.liminal-palette/token を再 cat / Editor 再起動
404	path 未登録	liminal commands / liminal scenarios で確認
405	method 違い	endpoint の GET/POST を確認
409	scenario 排他実行中	完了を待つ (1 並列のみ)
413	body 1 MB 超過	ファイルパス渡しに切り替え
429	rate limit 超過	間隔を空ける
500	endpoint 内例外	response の error 本文を確認

詳細: references/troubleshooting.md。

---

See also

• LP 本体ドキュメント: Documentation~/{ipc,scenarios,security,commands}.md
• CLI 詳細: Tools~/liminal/README.md
• 個別 skill: /liminal-find-port, /liminal-list-commands, /liminal-execute, /liminal-get-state, /liminal-get-logs, /liminal-list-scenarios, /liminal-run-scenario
• references/
  • ports.md — Editor/Play Mode/Build のポート割り当てと両稼働の判別
  • auth.md — token の生成/再生成/権限/共有時の注意
  • troubleshooting.md — 「全ポートで応答が無い」「401 が来る」等の網羅