agent-run

name	agent-run
description	contemplative-agent をバックグラウンドで起動する。引数でセッション時間とバックエンド (ollama / cloud / mlx) を指定（例: /agent-run 4時間, /agent-run 30分 cloud openai, /agent-run 30分 mlx）

Agent Run

contemplative-agent をバックグラウンドで起動する。生成バックエンドを ollama（デフォルト）/ cloud / mlx から選べる。

引数の解釈

$ARGUMENTS を空白区切りで <時間> [backend] [provider] として解釈する。

時間（必須でなく、省略時 60 分）

• 「4時間」「2h」→ 240分、120分に変換
• 「30分」「30m」「30」→ そのまま分数
• 数値が見つからなければ 60 分

backend（省略時 ollama）

値	経路
ollama（既定）	ローカル Ollama + gemma4:e4b（main repo の組み込み生成）
cloud	contemplative-agent-cloud（Anthropic Claude / OpenAI GPT。埋め込みは Ollama 据置き）
mlx	contemplative-agent-mlx（Apple Silicon ローカル MLX mlx_lm.server。埋め込みは Ollama 据置き。run-with-mlx.sh がサーバを起動→実行→停止）。対話的・短時間用途のみ（16GB 無人連続運用に不適、ADR-0067）

provider（cloud のときだけ意味を持つ、省略時 anthropic）

• anthropic（既定、claude-opus-4-7）/ openai（gpt-5）
• model 上書きは CONTEMPLATIVE_CLOUD_MODEL 環境変数（skill は触らない）

パス解決

skill は repo 内で動く前提。repo ルートと sibling の cloud repo を解決する:

REPO="$(git -C "$PWD" rev-parse --show-toplevel)"
AGENT="$REPO/.venv/bin/contemplative-agent"
CLOUD_BIN="$(dirname "$REPO")/contemplative-agent-cloud/.venv/bin/contemplative-agent-cloud"
MLX_REPO="$(dirname "$REPO")/contemplative-agent-mlx"
MLX_RUN="$MLX_REPO/scripts/run-with-mlx.sh"

起動コマンド (CRITICAL)

グローバルフラグ -v --auto は必ず run の前。順序変更・省略禁止。 {N} は分数、bg はバックグラウンド起動（nohup + リダイレクト）。

ollama（デフォルト）

"$AGENT" -v --auto run --session {N}

cloud

contemplative-agent-cloud は同一 CLI の drop-in。provider を環境変数で渡し、 API キーは skill が扱わず ~/.config/moltbook/cloud.env（cloud CLI が自動で読む） またはシェル環境変数に委譲する。

CONTEMPLATIVE_CLOUD_PROVIDER={provider} "$CLOUD_BIN" -v --auto run --session {N}

mlx

contemplative-agent-mlx の run-with-mlx.sh が mlx_lm.server を起動 → ヘルス待ち → エージェント実行 → 終了時にサーバ停止する（idle メモリ ~0）。Apple Silicon 専用。 生成のみ MLX、埋め込みは Ollama 据置き。

"$MLX_RUN" -v --auto run --session {N}

実行手順

1. $ARGUMENTS を 時間 / backend / provider に分解。
2. 時間を分数に変換。
3. backend ごとに 事前チェック（下記）。失敗したら起動せず停止して理由を報告 （silent に ollama へ落とさない）。
4. バックエンド別コマンドを バックグラウンド で起動 （nohup <cmd> > <scratchpad>/agent-session.log 2>&1 &）。
5. 起動コマンド・セッション時間・backend・ログのパスを報告。

事前チェック（silent fallback 禁止）

backend	確認	失敗時
ollama	curl -sf localhost:11434/api/tags	Ollama 未起動を報告して停止
cloud	[ -x "$CLOUD_BIN" ] かつ（[ -f "$MOLTBOOK_HOME/cloud.env" ] または $ANTHROPIC_API_KEY / $OPENAI_API_KEY が設定済み）	cloud venv 不動 or 鍵未設定を報告。Ollama へ落とさない。導入: uv pip install --python <cloud>/.venv/bin/python -e <main-repo>、鍵は ~/.config/moltbook/cloud.env に CONTEMPLATIVE_CLOUD_PROVIDER= と ANTHROPIC_API_KEY=（または OPENAI_API_KEY=）
mlx	[ "$(uname -m)" = "arm64" ] かつ [ -x "$MLX_RUN" ] かつ [ -x "$MLX_REPO/.venv/bin/contemplative-agent-mlx" ] かつ [ -x "$HOME/.local/bin/mlx_lm.server" ] かつ Ollama 稼働（埋め込み用、curl -sf localhost:11434/api/tags）	非 Apple Silicon / mlx venv 不動 / mlx_lm.server 未導入 / Ollama 停止を報告し停止。Ollama へ落とさない。導入: mlx repo を git clone → uv venv .venv → uv pip install -e . + main も同 venv へ、uv tool install mlx-lm

MOLTBOOK_HOME 未設定時の既定は ~/.config/moltbook。

特殊フラグ

ユーザーが明示指定した場合のみ追加（全 backend 共通、run の前に置く）:

• --guarded / --approve: --auto の代わり
• --no-axioms: A/B テスト用（公理なし）
• --domain-config PATH / --rules-dir PATH / --constitution-dir PATH: 切替

注意

• 生成のみが backend で切り替わる。埋め込みは常にローカル Ollama（nomic-embed-text、 cloud add-on も埋め込みは据置き）。
• cloud は untrusted な SNS コンテンツを外部 API に送る = security by absence を 緩める選択。研究実験（大型モデルでの distill 比較等）以外では使わない。
• mlx は完全ローカル（cloud egress なし）で security by absence は緩めない。ただし Apple Silicon 専用で、16GB では無人連続運用に不適（ADR-0067: EOS 暴走 / OOM / prefill 崖 / cache churn / wired thrash）。対話的・短時間に限る。本番スケジュール（0/6/12/18 時 JST）と 重ねると 16GB メモリ競合でクラッシュしうるので避ける。