lokei について
lokei は、lokei CLI でローカルプロジェクトを名前付き HTTPS ドメインで実行し、公開トンネルやローカル環境を管理してネットワーク問題を調べるワークフロースキルです。インストール状態を確認し、一度限りのセットアップやアンインストールには事前承認を求めます。
主な機能
- 01CLI とセットアップ状態の確認
- 02名前付き HTTPS ドメインでアプリを実行
- 03必要に応じた公開トンネルの作成
- 04Docker と複数サービスのオーケストレーション
- 05プロキシとネットワーク問題の診断
活用シーン
- 01開発中のローカルアプリを HTTPS で実行
- 02公開トンネル経由でローカルサービスを共有
- 03Docker Compose または複数サービス環境を起動
- 04ローカルプロキシや DNS 設定の問題を調査
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/lokeiを入力して読み込まれたか確認します。
同梱ファイルreferences/command-reference.md
詳細
必ず守るルール：
lokeiを利用する前に、使用可能かどうかを確認してください。- 承認なしに、初回セットアップやアンインストールのフローを自動実行しないでください。
- ユーザーがローカルのみの HTTPS、パブリックトンネル、複数サービスのオーケストレーションのどれを希望しているか確認してください。
- 用途に合った最もシンプルなコマンドを優先してください。
- 生成された URL と診断で判明した問題を明確に報告してください。
lokei
入力
$request：ローカル HTTPS、共有、Docker、サービス、または診断に関するタスク
目標
lokei を使用して、以下を実行します。
- ローカルプロジェクトを、名前付き HTTPS
.testドメインの背後で実行する - 要望があれば、ローカルサービスをトンネル経由で公開する
- Docker または複数サービスのローカル環境をオーケストレーションする
- ローカルプロキシやセットアップの問題を診断して説明する
ステップ 0：インストール状況とセットアップの健全性を確認する
以下を確認します。
lokei --versionlokei doctor
lokei が見つからない場合は、ユーザーに次のように伝えてください。
lokeiはインストールされていません。次のコマンドでインストールしてください。npm i -g lokei && lokei setup
lokei setupは初回に一度だけ実行され、ローカル CA を生成して OS のキーチェーンで信頼し、.test用の DNS を設定して、ポートフォワーディングを構成します。
インストールやセットアップを自動実行しないでください。ユーザーの確認を待ってください。
セットアップに問題がある場合：
- 失敗したコンポーネントを説明します
- よくある解決策：CA が信頼されていない、または DNS リゾルバーがない場合は、
lokei setupを再実行します - 初回セットアップ操作を提案または実行する前に、ユーザーに確認してください
成功条件：lokei が使用可能で、セットアップ状態が把握できていること。
ステップ 1：要求されたモードを確認する
ユーザーが次のどれを希望しているか確認します。
- 1 つのローカルアプリには
lokei run - パブリックアクセスには
lokei shareまたはlokei run --expose - Docker Compose には
lokei docker up .test.yamlのオーケストレーションにはlokei up- 診断には
lokei routes ls、inspect、またはlogs
また、プロジェクト名、コマンド、ポートを上書きする必要があるかどうかも確認します。
成功条件：実行前に、適切な lokei モードが選択されていること。
ステップ 2：必要最小限で適切なコマンドを実行する
以下を優先します。
- 通常のローカル開発には
lokei run - 一時的な共有には
lokei share --port <port> - 同じセッションでローカル HTTPS とパブリックトンネルの両方が必要な場合は
lokei run --expose - プロジェクトの構成上必要な場合に限り、
lokei docker upまたはlokei up
ユーザーが明示的に求めていない限り、サービスのインストールやアンインストールのフローは避けてください。
成功条件：実行したコマンドが、必要以上の操作を行わず、要求されたワークフローに合致していること。
ステップ 3：URL と状態を明確に報告する
実行後、以下を報告します。
- ローカルの
.testURL - 作成した場合はパブリックトンネルの URL
- 関連する場合はプロジェクト名とルートの詳細
- コマンドが失敗した場合は、doctor またはセットアップで判明した問題
成功条件：アプリにアクセスできる場所と、アクセスできない場合はその原因が、ユーザーに明確に伝わっていること。
ガードレール
- 承認なしに
lokei setup、service install、またはuninstallを自動実行しないでください。 - ローカルのみの HTTPS で十分な場合に、ユーザーがパブリックトンネルを希望していると決めつけないでください。
- 診断結果を「セットアップに失敗しました」のような一般的な要約で隠さないでください。
disable-model-invocationを追加しないでください。これは通常の環境ワークフロー用スキルです。
参照資料を読み込むタイミング
references/command-reference.mdコマンドの全一覧、フレームワーク検出表、アーキテクチャの詳細、.test.yamlの例、git worktree の動作、シナリオ別クイックリファレンスを確認する際に使用します。
出力の要件
以下を報告します。
- 選択したモード
- 実行したコマンド
- 生成されたローカルまたはパブリック URL
- 検出したセットアップまたはネットワークの問題
- ユーザーの承認が必要な場合は、次のアクション