概要
loopkeep は、自分のマシンでパーソナルな AI 自動化の workflow を動かし、ひとつの
受信箱から監督します。常駐する daemon があなたのトリガー — cron、ファイルの変更、
git イベント、run の完了、そして GitHub や Slack であなたに起きたこと — を監視し、
あなたが起動しなくても workflow を開始します。
どのアクションを unattended で実行し、どれを承認待ちにするかは policy が決めます。あなたの判断が
必要なものはすべて受信箱に届きます。操作は好きな場所から行えます — lk CLI、ターミナル UI、
デスクトップアプリ。どれも対等で、同じ daemon を相手にします。
各パーツの関係
| 概念 | 説明 |
|---|---|
| workflow | エージェントに何をするかを伝える markdown ファイル。GitHub Agentic Workflows と互換。 |
| トリガー | workflow が発火するタイミング。cron、ファイルの変更、git イベント、run の完了、GitHub・Slack のイベント、自分の webhook、手動。 |
| run | workflow の 1 回の実行。専用の git worktree でステップごとにチェックポイントされる。 |
| policy | 提案された各アクションを auto-approve / notify / ask-first / deny のいずれかに振り分ける決定的なルール。 |
| 受信箱 | 承認と通知が届く唯一の場所。 |
| Console | デバイスのペアリングや GitHub・Slack の接続を行う、任意の Web コントロールプレーン。コードと secret は自分のマシンに残る。 |
ここから始める
- インストール — standalone のランタイムインストーラー、またはデスクトップアプリ。どちらも daemon・
lk・アダプターを届けます。 - クイックスタート — 空のフォルダから、監督付きの run まで。
- デスクトップアプリ — ウィンドウ、project、そしてすべての設定を一巡り。
- ターミナル UI — 同じダッシュボードを、そのままターミナルで。
- Console とペアリングする — 任意。デバイスとリモートトリガーを有効化する。
ガイド
- ワークフロー — 作成、構造化出力、予算(budget)、連鎖。
- トリガー — すべてのトリガー種別、フィルタ、集約(coalescing)、連鎖の上限。
- ポリシーと信頼 — アテンションレベル、レイヤー、floor、
policy explain。 - 実行と受信箱 — run のライフサイクル、チェックポイント、介入。
- Take-over & hand-back — run のセッションを自分で操作して、返す。
- Secrets — キーチェーンでの保存、参照、マスキングとその限界。
- GitHub Agentic Workflows — インポート、エクスポート、互換性の契約。
- Agent skills — コーディングエージェントに、あなたと一緒に loopkeep を操作させる。
- Consoleとは — デバイス、コネクタ、マシンから決して出ないもの。
リファレンス
- CLI — すべての
lkコマンド。 - ワークフローの frontmatter — サポートするすべてのキー。
- policy.yaml — 完全なスキーマ。
- Daemon と設定 —
loopkeepd、ディスク上のファイル、トラブルシュート。