Agent Run

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 へ落とさない）。

1. バックエンド別コマンドを バックグラウンド で起動

（nohup > /agent-session.log 2>&1 &）。

1. 起動コマンド・セッション時間・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 /.venv/bin/python -e 、鍵は ~/.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 メモリ競合でクラッシュしうるので避ける。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: shimo4228
• Source: shimo4228/contemplative-agent
• License: MIT
• Homepage: https://doi.org/10.5281/zenodo.19212118

Install and usage instructions live in the source repository linked above.