CLI
lk は loopkeep daemon へのコマンドラインクライアントです。standalone インストーラーか
デスクトップアプリ でインストールします。対話端末では、引数なしの lk は
ターミナル UI を開きます。パイプやリダイレクトにつなぐと usage を表示します。
このページはコマンド全体をグループ分けしたものです。
ほとんどのコマンドは workspace に対して働きます。対象は次の順で解決されます:
--workspace <id|path> → 環境変数 LOOPKEEP_WORKSPACE → カレントディレクトリ。
workspace のセットアップ
| コマンド | 何をするか |
|---|
lk init | この workspace に .loopkeep/ を作る(スターター policy + workflow 1 つ)。冪等。 |
lk trust | 現在の policy を承認する — project policy と自動トリガーを有効化する。policy ファイルが変わったら再度必要。 |
lk untrust | この workspace のトリガーが自動発火しないようにする — デスクトップアプリと同じ kill switch。手動と実行中の run は続く。lk trust で再開。 |
daemon
| コマンド | 何をするか |
|---|
lk start | loopkeepd を起動する(別名: up)。 |
lk stop | 停止する(別名: down)。実行中の run は次の起動時に interrupted として復元。 |
lk restart | 停止してから起動する。 |
lk status | daemon の状態。 |
run
| コマンド | 何をするか |
|---|
lk run <workflow> | workflow を手動で実行する。 |
lk rerun <run> | 完了した run の workflow を、そのトリガー context を再利用してもう一度実行する。 |
lk runs | run を一覧表示する。 |
lk pause <run> / lk resume <run> | 次のステップ境界で中断 / 再開する。 |
lk abort <run> | run を終了する。worktree は残る。--rollback は先に最後のチェックポイントまでリセット。 |
lk take-over <run> | run の claude セッションを自分で対話的に操作する。 |
lk hand-back <run> [--summary <text>] | take-over を終え、run を running に戻す。 |
受信箱
| コマンド | 何をするか |
|---|
lk inbox | まだあなたを待っているアテンション。 |
lk watch [--json] [--no-notify] | 新しいアテンションが届くたびにストリーム表示。ask-first で鳴る。--json は NDJSON を出力。--workspace で絞らない限り全 workspace が対象。 |
lk approve <seq> [--steer|--abort] [--instruction <t>] | waiting 中のアテンションを決める。--steer は instruction が必須。--abort は run を止める。 |
lk notify <message> [--url <url>] | 外部の通知を受信箱に投稿する — CI hook やスクリプト向け。Markdown 対応。 |
トリガー
| コマンド | 何をするか |
|---|
lk disable <workflow> / lk enable <workflow> | この workspace で workflow の自動トリガーを off/on にする。手動と実行中の run には影響しない。 |
lk pause --all / lk resume --all | グローバルな kill switch: 全 workspace でトリガー由来の run を停止/再開する。信頼とは独立。 |
policy
| コマンド | 何をするか |
|---|
lk policy explain <tool> [paths...] [--tags a,b] [--self <level>] [--workflow <name>] [--command <text>] | 仮のアクションを評価し、一致する各ルールをレイヤー・ファイル・最終レベルとともに表示する。 |
lk policy test <tool> [paths...] [--expect <level>] […] | 同じ評価を exit code で表す。--expect を付けると一致で 0、不一致で 1。付けなければ最終レベルの順位(auto-approve 0、notify 1、ask-first 2、deny 3)。エラーは exit ≥ 10。 |
どちらも daemon を動かさずに使えます — CI で使えます。
secret
| コマンド | 何をするか |
|---|
lk secret set <name> [--value <v>] | secret を OS のキーチェーンに保存する(--value なしなら stdin を読む)。 |
lk secret list | この workspace に記録された secret の名前を一覧表示する。 |
GitHub Agentic Workflows
| コマンド | 何をするか |
|---|
lk export --to-gh-aw <workflow> [--json] | gh-aw へ変換し、green/yellow/red のレポートを出す。 |
lk import <gh-aw-file> | gh-aw ファイルをインポートする。ローカルで動かせないトリガーは手動になる。 |
workspace と設定
| コマンド | 何をするか |
|---|
lk workspaces | 登録済みの workspace を一覧表示する。 |
lk workspaces add <path> [--name <n>] / lk workspaces remove <id> | workspace を登録 / 削除する(home は削除できない)。 |
lk global-max [<n>] | 全 workspace を通じた実行中 run の上限を取得/設定する。 |
lk workspace-max [<n>|clear] | この workspace 固有の実行中 run の上限を取得/設定する(clear で解除。実効上限は本値と global-max の小さいほう)。 |
lk retention [<days>|off] | 完了した run の worktree を保持する期間を取得/設定する。 |
lk cleanup | 完了した run の worktree を今すぐ削除する(チェックポイントブランチは残る)。 |
Console
| コマンド | 何をするか |
|---|
lk login | ご利用中のデバイスを Console とペアリングする(ブラウザで承認)。 |
lk logout | このデバイスを revoke してログアウトする。 |
lk account | ログイン状態と Console 接続を表示する。 |
ランタイム
| コマンド | 何をするか |
|---|
lk update [--check|--rollback|--force] | ランタイム(lk + loopkeepd + アダプター)を最新リリースへ更新する。--check は確認のみ、--rollback は直前のバージョンへ戻す。Homebrew・デスクトップアプリでの導入はそのチャネル側で更新する。 |
lk version | lk のバージョンを表示する(daemon が動いていればそのバージョンも)。 |
環境変数
| 変数 | 意味 |
|---|
LOOPKEEP_WORKSPACE | --workspace を指定しないときの既定の対象 workspace。 |
LOOPKEEP_SOCKET | daemon の socket パス(既定 /tmp/loopkeepd.sock)。 |
LOOPKEEP_CONFIG | config.yaml のパス。既定の場所を上書きする。 |
LOOPKEEP_DAEMON_BIN | lk start が使う loopkeepd バイナリを明示指定する。 |