先に結論:
- Agent Autoloop(MIT)は「端末を見守る」を「イベント / cron → 1 ラウンドで終了 → 必要なときだけカード → 回答で同じセッション再開」に変えます。README は macOS / Linux。Windows 公式は未定(issue #17、当面は WSL2)。
- インストール:
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh、その後agent-autoloop try。 - 2026 年 11 月 6 日、Linux で実測:Node 24.22.2、agent-autoloop v1.5.0、Codex(aicodewith、
gpt-6.1-sol)。承認ループ成功 — 色カードまで約 9 秒、「緑」回答後同じセッションで約 10 秒「試走通過」。GUI なしでnotify-send欠如、CLI で完走。 - ルールは
~/.agent-autoloop/rules.json。agent-autoloop checkで検証。 - 無人運用はローカル権限そのもの。カードリンクを外に出さない。Webhook は認証。SECURITY によればプロンプト注入は未解決部分あり。既定は
edit、副作用はask。
API Key を作り、Claude Code / Codex をつないでループを始める →
何を解決するか
Claude Code や Codex は、端末を見ながらの使い方が多いです。窓を閉じると止まります。
Agent Autoloop は決定的な kernel(README 上およそ 1650 行・実行時依存ゼロ)を中心に、イベント・エージェント・通知・配信をプラグインで差し替えます。
- イベント到来 — 朝 9 時の cron、新しい GitHub Issue、アラート。
- ルールで配布 — どの Agent・どのディレクトリか。同じ件名は合流。
- 1 ラウンドで終了 — 判断待ちのあいだ Agent プロセスは動かない。
- 必要なときだけカード — 削除・再起動・外向き送信など。
- 回答で再開 — 元の会話を続ける。
README によれば Claude Code / Codex / ACP は複数ターンとセッション継続を実測済み。Feishu は実配信あり。Webhook 等はローカル mock 中心。
前提
| 項目 | 要件 |
|---|---|
| OS | macOS / Linux。Windows 公式は未定(#17)。INSTALL に WSL2 |
| ランタイム | Node.js 24+、Git、curl |
| Agent | 利用可能な Claude Code または Codex(command でも可) |
| aicodewith Key(任意) | 登録して API Key 作成 |
当機は Node 22 → n 24 で 24.22.2。
手順 0:API Key
- aicodewith.ai で登録し「キー管理」。
- 「キー作成」、分かりやすい名前(例
autoloop-box)。 - すぐ全文をコピー。Create API Key ドキュメント。
Codex — ~/.codex/config.toml:
model = "gpt-6.1-sol"
model_provider = "aicodewith"
[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"
Claude Code — ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
}
}
関連:Codex インストール、Codex API Key、config.toml、Claude Code バックグラウンドサブエージェント、Conductor 代替 worktree。
インストール
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh
本体は ~/.agent-autoloop/app。CI / ヘッドレスは --no-service のあと agent-autoloop up(INSTALL)。
実測(2026-11-06、Asia/Shanghai):v1.5.0(f211ca2de3b1)、Agent は Codex。
agent-autoloop --version
agent-autoloop doctor
agent-autoloop up
agent-autoloop try
最小ループ:try → answer → status
Codex のタイムライン(UTC+8):
| 手順 | 時刻 | 結果 |
|---|---|---|
| try | 15:25:01 → 15:25:10 | 約 9 秒、色カード |
| answer 1 2 | 15:25:27 | 緑、第 3 ラウンド、同一セッション |
| 完了 | 15:25:27 → 15:25:37 | 約 10 秒、「試走通過」 |
| 通知 | — | notify-send なし。CLI OK |
agent-autoloop answer 1 2
agent-autoloop status
agent-autoloop why 3
正直な記録: 初回 try はモデル名が本サイトに無く失敗。gpt-6.1-sol に変更後に成功。Claude Code 単体スモーク約 6 秒で OK。今回の try は Codex プラグイン。
rules.json
朝のブリーフ(README):
{
"name": "Morning brief",
"when": { "cron": "0 9 * * *" },
"to": "codex",
"cwd": "~/notes",
"prompt": "Summarize yesterday's notes and commits into today's brief."
}
check OK。rules explain は Asia/Shanghai、次回 11/07 09:00。GitHub issues 例はリポジトリ。
Claude Code / Codex / その他
use は claude / codex / acp / dsh、または {prompt} を 1 引数にする command。Claude Code / Codex / Cursor は並列の選択肢。worktree 並列はConductor 代替。
安全
SECURITY より:ローカル権限、カードリンクは 7 日・所持即回答、イベントは Agent を指名できない、Webhook 認証、CLI ログインは中継しない、計測後に Key 設定を削除。
FAQ
Windows? 未定(#17)、WSL2 あり。サービス必須? いいえ。try 失敗? doctor、Node ≥ 24、モデル一覧、完全な experimental_bearer_token。
まとめ
Node 24 → インストール → try / answer / status → cron ルール → SECURITY → Key を消す。



