コンテンツにスキップ
HARNESS CLI
HARNESS CLI

変更履歴

リリース履歴、アップグレード情報、関連ドキュメントへの入口。

On This Page

変更履歴

v4.0.1(2026-07-14)— 公開コンテンツと SEO/GEO カバレッジ

  • ドキュメントのバージョン表示、ルートの VERSION、GitHub Release、公開 changelog を 4.0.1 に同期しました。
  • 現在の AIOS workflow、リリースナビゲーション、検索と AI answer engine が理解しやすい公開ドキュメントとブログを拡充しました。

v4.0.0(2026-07-14)— 適応型ワークフローポリシー

  • noopdirectguardedplanned の適応型ルーティングを追加し、依頼に合った開発プロセスを選べるようにしました。
  • 複数ステップの AI agent 作業に向けて、永続化された計画、編集安全ゲート、証拠ベースの検証を文書化しました。
  • リリース記事:v4.0 適応型ワークフローポリシー

ドキュメントと workflow のメモ

  • v3.6.0 Headroom token インテリジェンス workflowaios init は RTK と Caveman に加えてテスト済みの Headroom CLI range を install します。Gemini/Grok の user-scope MCP registration には別途 --yes-headroom-mcp consent が必要です。Hermes には実際の TTY が必要で、そうでなければ pending-interactive を報告します。既存の external または conflict entry は上書きせず、AIOS 所有 entry は ~/.aios/integrations/headroom-mcp.json に記録します。MCP-only compression は明示的であり、透過的 input interception を主張しません。詳細:Token インテリジェンスと圧縮Headroom + Ponytail の記事
  • agent governance の説明を Team ドキュメント、シナリオガイド、ContextDB リファレンス、ブログに追加しました。
  • 新しい smoke 証跡ガイドでは .aios/agents/smoke/<agent>.json.aios/agents/provenance/<agent>.json.aios/interception/metrics/agents-smoke-<agent>.jsonl を参照します。
  • skill を変更したら、live workflow を信頼する前に node scripts/aios.mjs skill verify-training --changed --base HEAD --json を実行してください。
  • Grok Build が AIOS ファーストクラスクライアントに昇格:xAI Grok Build(grok / runtime id grok-build)が skills、agents、superpowers、native、team、harness を備えて登録されました。MCP は Codex 形式 TOML(~/.grok/config.toml)。詳細: Grok Build + AIOS
  • Hermes Agent が AIOS ファーストクラスクライアントに昇格:skills、native、harness、superpowers。詳細: Hermes Agent + AIOS ブログ記事

v3.6.0(2026-07-10)— Headroom + Ponytail token インテリジェンス workflow

追加

  • Python 3.10+ が必要な隔離された uv tool または pipx environment に headroom-ai[all]>=0.31.0,<0.32.0 を検出・install。
  • 無人 package installation と MCP user-configuration consent を独立に保つため、--yes-headroom-mcp を追加。
  • Gemini CLI、Grok Build、Hermes Agent の native MCP command で公式 headroom mcp serve を登録。TTY がない Hermes は pending-interactive のままです。

安全性と互換性

  • AIOS 所有の MCP registration fingerprint を ~/.aios/integrations/headroom-mcp.json に保持し、external または conflict entry を保全。
  • MCP tool(headroom_compressheadroom_retrieveheadroom_stats)が現在の request に対する透過的 interception ではなく、明示的な on-demand compression であることを明確化。
  • RTK、Caveman、ContextDB、Headroom、および Ponytail に着想を得た smallest-correct-change gate を別々の layer として文書化。

v3.4.0(2026-07-09)— Grok Build ファーストクラスクライアント

  • grok / grok-build をフル能力セットで登録(team + harness 含む)
  • プロジェクト skills/agents: .grok/skills.grok/agents;指示ファイルは共有 AGENTS.md
  • 無人実行: grok --always-approve -p "..."
  • 公式ドキュメント・changelog・多言語ブログを更新

v3.3.0(2026-07-02)— ネイティブインターセプションランタイム廃止、RTK + Caveman 全自動インストール

Breaking Change:AIOS ネイティブインターセプションランタイム廃止

AIOS ネイティブトークンインターセプションランタイム(scripts/aios-mcp-proxy.mjsscripts/aios-intercept.mjsconfig/aios-interception.json)は deprecated になりました。コードは保持されますが、積極的なメンテナンスは終了します。

代替はコミュニティツールです:

  • RTK (https://github.com/rtk-ai/rtk) — Rust CLI プロキシ、コマンド出力を 60-90% 圧縮。シングルバイナリ、<10ms オーバーヘッド、100+ 対応コマンド。ローカル実行、外部サービスなし。
  • Caveman (https://github.com/JuliusBrussee/caveman) — Claude Code スキル、agent 出力トークンを ~75% 圧縮。技術的正確性を維持、表現スタイルのみ圧縮。ローカル prompt skill。

新機能:全自動インストール

aios init が RTK + Caveman を自動検出・インストール:

node scripts/aios.mjs init --all
node scripts/aios.mjs init --all --yes-compression-tools
node scripts/aios.mjs init --dry-run

フロー:検出 → ユーザー確認 → ダウンロードインストール → 検証 → PATH 設定 → rtk init -g クライアント初期化。

プラットフォーム:macOS (brew)、Linux/WSL (install.sh)、Windows (PowerShell zip + 自動 PATH)。

削除されたポリシー

  • bidirectional-turn-compression 強制ポリシー削除
  • pre_send / post_receive 圧縮検証要件削除
  • uncontrolled_host_output ポリシー違反マーキング削除
  • "Do not install RTK, Caveman" 禁止削除

マイグレーション

  1. aios init で RTK + Caveman をインストール
  2. scripts/aios-mcp-proxy.mjs は削除不要、メンテナンス終了
  3. 旧設定 config/aios-interception.json は読み込まれません
  4. AI クライアントを再起動して RTK hook/plugin を有効化
  5. Claude Code で /caveman 入力で Caveman を有効化

v3.2.0(2026-07-01)— Harness 信頼性とスキルライフサイクル向上

Harness Solo Runtime

  • consecutiveFailures 自動中止backoff.mjs にデュアルカウンター(consecutiveFailures + consecutiveInfraFailures)を追加。5 連続非成功 outcome で自動 abort、無限リトライによる token 無駄を防止。
  • Emergency 圧縮ティアmermaid-canvas.mjs に 3 番目の圧縮レベル(100+ ノードで発火)を追加。emergency モードは最近 5 ノードのみ保持し、canvas オーバーフローを防止。
  • Dry-run Readiness プレフライト:新規 dry-run-readiness.mjs が harness 起動前に 4 次元(ContextDB、Git、Provider、Session)をチェック。blocked レベルは起動を阻止。

Runtime Directive システム

  • Directive 注入:新規 directive-inject.mjs.aios/config.jsondefault_mode を読み、対応する systemPromptAdditions を毎回の harness 反復 prompt に注入。3 つの内蔵プリセットとカスタム mode_presets をサポート。

Auto-Dream(Phase A: 手動)

  • 手動メモリ整理 CLIscripts/lib/memo/autodream.mjs--preview(計画のみ)と --apply(実行)モードを提供。既存の taxonomy + 重複排除 + TTL 期限切れパイプラインをラップ。

Skill Workshop

  • Stale 検出:apply 前にターゲット SKILL.md のファイルシステム hash と lock の computedHash を比較。不一致場合は apply を拒否し、ユーザーの手動編集を保護。
  • ファイルレベル rollback:apply 前に完全な SKILL.md 内容を lock.rollbackSnapshot.previousContent に保存。rollback 時に実際のファイル内容を復元。

検証

全変更は 37/37 ユニット + 統合テストで検証済み。

詳細: v3.2.0 リリース記事

v3.1.0(2026-06-30)— Hermes Agent ファーストクラスクライアント統合

  • Hermes Agent が 7 番目の AIOS ファーストクラスクライアントとして登録:skills、native、harness、superpowers の全機能を備える。
  • MCP ブリッジサーバーscripts/aios-mcp-server.mjs が Hermes セッション内で 5 つの AIOS ツール(aios_context_packaios_doctor_suiteaios_intercept_compressaios_skill_validateaios_skill_install)を公開。
  • Native emitter + MCP target:AGENTS.md 出力 + JSON stdio(.mcp.json + config.yaml scopes)。
  • 多言語ドキュメント対応(英/中/日/韓)。
  • 詳細: Hermes Agent + AIOS ブログ記事

v2.0.2 (2026-06-15)

  • Skill health validation: recordSkillObservation() は未知の status を拒否し、producer の typo を failure として保存しないようになりました。
  • Help-first CLI parsing: aios skill ... --helpaios session ... --help は必須位置引数の検証より先に usage を表示します。
  • Crush config hygiene: .crush.jsoncrush.json は repository で tracking されなくなりました。local Crush config は引き続き利用できますが git では無視されます。
  • 参考: v2.0.2 release post.

v2.0.1 (2026-06-13)

  • Browser MCP alias migration: default browser-use runtime を保ったまま legacy alias compatibility を修正しました。

v2.0.0 (2026-06-12)

  • Pull-based runtime context: automatic ContextDB prompt injection と startup-mode injection を削除し、必要な時だけ runtime context を読み込む形にしました。

v1.52.0 (2026-06-11)

  • aios_shell MCP ツール: aios-shell MCP エイリアス経由で全クライアントにおいて決定論的な shell 出力圧縮を実現。shell コマンドは scripts/shell-mcp-server.mjs で実行され、MCP proxy が自動的に 99%+ の節約率 で圧縮します。
  • 3層防御: MCP ツール (全クライアント) → shim+hook (Claude/全クライアント) → プロンプト誘導。単一障害点なし。
  • Shim 自己修復: ネイティブ shim が 4 つの fallback パスを探索し、fail-open で実際のクライアントバイナリを実行。
  • 機密コマンドガード: git pushnpm publish が実行前に遮断され、ホスト権限確認が必要。
  • aios-shell 全クライアント登録: doctor --fix.mcp.json.codex/config.toml.gemini/settings.jsonopencode.jsoncrush.json に登録。
  • 参考: v1.52.0 ブログ記事.

v1.51.0 (2026-06-10)

  • Crush smoke 検証: Crush (charmbracelet) を pending-smoke ゲーティングに追加し、live execution ブロックを強化。
  • Native strict モード強化: clients doctor --native-strict が管理 shim の背後に実際のダウンストリームクライアントが存在するか検証。

v1.50.1 (2026-06-05)

  • 全クライアント turn compression compliance: すべての AIOS-managed client/host が bidirectional-turn-compression metric を共有し、pre_sendpost_receive を必須にしました。
  • Bypass で偽の節約をしない: AIOS-managed runner 外の direct host output は policy-violation / non_compliant として記録され、saved_bytes=0 になります。
  • Proof matrix: node scripts/aios.mjs interception proof --jsondoctor --json が Codex、Claude、Gemini、Antigravity、OpenCode、Crush、Cursor、aios-harnessgeneric-mcpturn_compression_matrix を出力します。
  • Skill training evidence: aios-interception-runtime は SkillOpt-Lite で training 済みで、artifact は .skillopt/aios-interception-runtime-2026-06-05 にあります。
  • Release tutorial: v1.50.1 token compression compliance postToken インテリジェンスと圧縮 を参照してください。

v1.50.0(2026-06-04)

  • 統合 AIOS 検索node scripts/aios.mjs search "<query>" で project memory、pinned memo、docs、plans、code を一度に検索できます。
  • クロス CLI の記憶安全性project_shared は全 client で見え、agent_private は一致する --agent <runtime-client-id> のみで見えます。
  • 全 client への native guidance:Codex/OpenCode/Crush は AGENTS.md、Claude は CLAUDE.md、Gemini/Antigravity は GEMINI.md で同じ search 指示を受け取ります。
  • リリース tutorialv1.50.0 統合検索 tutorialContextDB を参照してください。

このページでは Harness CLI の変更点を追跡し、関連ドキュメントへ移動できます。

公式リリース履歴

⭐ GitHub で Star 📦 Releases を見る

最新安定版

  • 1.17.0 (2026-05-16):
  • Memo Storage: aios memo は storage abstraction を使い、公開 implementation は file(既定の append-only JSONL: .aios/memo/file/events.jsonl)と split(memo event ごとに 1 JSON file)の 2 つです。aios memo storage statusaios memo storage use splitaios memo storage use fileaios memo storage rebuildaios memo storage doctor で管理します。
  • Git-friendly memo source of truth: .aios/memo/ が project memo の正規 root です。ContextDB/SQLite は互換 mirror と再構築可能 cache であり、memo source of truth ではありません。
  • Runtime state alignment: 新しい ContextDB runtime state は .aios/context-db/ に書き込まれます。legacy memory/context-db は存在する場合のみ互換読み取り path として扱います。
  • 詳細は ContextDB の memo storage boundary を参照してください。

  • 1.11.0 (2026-05-09):

  • debug-hub v0.3: インストルメンテーション追跡と自動クリーンアップ。新しい MCP ツール: instrumentlist_instrumentscleanup_instruments。マーカー規約 DH:<sessionId> によるゼロ依存デバッグコード注入とデュアルモードクリーンアップ(instrument 記録による明示的モード、workspace grep によるフォールバック)。dryRun プレビュー対応。ワークスペースメモリ経由のクロスモデルデバッグプロトコル。アップストリーム debug スキルを debug-hub スキルに置き換え。詳細は debug-hub

  • 1.10.0 (2026-05-09):

  • debug-hub v0.2: 自動 Trace 物化(デバウンス)、agent デバッグセッション、構造化証拠イベント、/api/healthtimeline / health / compact_context MCP ツールを追加。HTTP エンドポイント入力バリデーション、MCP 引数バリデーション、パストラバーサル保護、大文字小文字を区別しない検索、デバウンスドトレースインデックスを含む。詳細は debug-hub

  • 1.8.0 (2026-05-08):

  • ラップされた codexclaudegeminiopencodehermesgrok セッション向けの self-trigger harness routing を追加。
  • Model Router: Agent Team 向けのインテリジェントなマルチモデルディスパッチ。モデル能力レジストリ (8モデル)、タスクタイプからモデルへのルーティング、3つの CLI プロトコルアダプタ (claude/codex/gemini)、コスト昇順のフォールバックチェーン、Agent 呼び出し可能な model-router スキル、AIOS_MODEL_{ROLE} 環境変数オーバーライド、知覚フィードバックループ統合を含みます。詳細は モデルルーター を参照してください。
  • GroupChat Runtime: aios team の live モードが共有会話履歴を持つラウンドベースのエージェント実行に対応。各ラウンドのエージェントは並列実行され、全エージェントが蓄積されたスレッド全体を参照可能。ブロックされたエージェントは自動的に re-plan ラウンドをトリガー。従来の one-shot 独立 dispatch モデルとの差別化。
  • OpenCode CLI subagent 対応: opencode-cli がすべての orchestration パス(subagent、team、GroupChat runtime)で完全サポートされる AIOS_SUBAGENT_CLIENT に。

以前の安定版

  • 1.7.1 (2026-04-26):
  • Solo Harness のリリース記事を追加。
  • 既存の persona/user profile memory layer(aios memo persona ...aios memo user ...)を明確化し、以前のドキュメント漏れを修正。

  • 1.7.0 (2026-04-26):

  • 単一 agent の夜間実行向けに aios harness を追加。run journal、stop/resume 制御、HUD 表示、必要に応じた worktree 分離を提供。
  • 公式 Solo Harness ドキュメントを English、中国語、日本語、한국어 へ同期。

さらに以前の安定版

  • 1.6.3 (2026-04-25):
  • 中国語版の視覚的オンボーディング構成を English、日本語、한국어 ページへ同期。
  • Overview、Quick Start、シナリオ別コマンド、Agent Team を同じ初心者優先ルートへ更新。

  • 1.6.2 (2026-04-25):

  • 公式ドキュメントに初心者ルート、TUI Setup/Doctor、ContextDB 記憶ループ、Agent Team/HUD の視覚ガイドを追加。
  • 新規ユーザーが高度な ContextDB、Agent Team、orchestration 概念より先に、作業別コマンドを選べる構成へ改善。

  • 1.6.1 (2026-04-25):

  • clean Linux checkout で GitHub Release pipeline が通るよう修復。
  • 中国語オンボーディング文書を簡略化し、新規ユーザーが作業別にコマンドを探せるよう改善。

最近のバージョン

  • main (未リリース):
  • debug-hub MCP ネイティブデバッグログサービス (2026-05-06): coding agent 向けの MCP ネイティブなデバッグログ収集。Node.js/Browser/Go SDK、組み込み Web UI、~/.debug-hub/ 配下のファイルベースストレージ、agent 自己診断用の 5 つの MCP ツール(list_tracesget_tracesearch_logsget_statsclear_logs)を提供。agent は人間の介入なしに自身のランタイムログを内省可能
    • Agent self-trigger harness routing (2026-05-05): ラップされた codex / claude / gemini / opencode / hermes / grok セッションが single/subagent/team/harness を提示;長時間・夜間・再開可能な目標は aios harness run ... --workspace <project-root> を自己トリガーでき、--max-iterationsCTXDB_HARNESS_PROVIDER / CTXDB_HARNESS_MAX_ITERATIONS で制御可能
  • ラップされた coding agent 向け Privacy Shield (2026-04-24): ContextDB shell の対話型 CLI 起動時に Privacy Guard 状態、カスタムモデル中継エンドポイント検出、aios privacy read --file <path> の安全な読み取りパスを示すカラーのプライバシーパネルを表示;自動プロンプトでも LLM のプライバシー指示は助言的で、検証可能な保護は deterministic な AIOS gate によるものだと明示
  • ワークスペース認識の routed startup + プロジェクト Node 選択 (2026-04-23): routed ctx-agent startup が non-AIOS リポジトリから起動された場合でもアクティブな git ワークスペースを保持;mcp-server の npm scripts は scripts/with-project-node.mjs 経由で実行され、.nvmrc / Node 24 を一貫して尊重するため、組み込み node:sqlite により外部 SQLite addon の ABI ドリフトを避け、Node 24 が見つからない場合は明確なエラーを返します
  • ContextDB Shell 起動最適化 (2026-04-22): ctx()npm run -s contextdb よりコンパイル済み mcp-server/dist/contextdb/cli.js を優先し、1 回あたりのオーバーヘッドを ~0.3s から ~0.06s に削減;one-shot エージェント起動を ~2.2s から ~0.5s に短縮(約 78% 高速化);shell-bridge の detectRunnertsx を不要に;インストール時に dist/ がない場合は自動ビルドし、ビルド失敗時は npm-run モードに自動フォールバック
  • デフォルト core skills 更新 (2026-04-19): awesome-design-mdfrontend-designcap-commit-push をデフォルト core skills に昇格
  • ContextDB レイジーロード (2026-04-18 〜 2026-04-19): インタラクティブセッションがデフォルトでレイジーコンテキストロード (CTXDB_LAZY_LOAD=on) を使用;エージェントはフルコンテキストパックの注入ではなくファサードプロンプトでメモリを自己発見;レイジーロードドキュメント と多言語ブログ記事を追加
  • AIOS ワークフロールーター skill (2026-04-18): タスクから skill への信頼性あるルーティングと発見のため .claude/skills/aios-workflow-router を追加
  • Browser MCP の browser-use CDP への移行 (2026-04-10): デフォルトのブラウザランタイムを Playwright から browser-use MCP over CDP に切り替え;新しいランチャー scripts/run-browser-use-mcp.sh;移行コマンド aios internal browser mcp-migrate;スクリーンショットタイムアウトガード BROWSER_USE_SCREENSHOT_TIMEOUT_MS 設定可能
  • HUD/Team skill-candidate 機能強化 (2026-04-09 〜 2026-04-10): 詳細ビュー用の --show-skill-candidates フラグ;設定可能な --skill-candidate-limit <N>;fast-watch モードのデフォルト制限を 6 から 3 に削減;パフォーマンス向上のための artifact 読み取りキャッシュ;HUD が skill-candidate apply コマンドを提案;team status で skill-candidate artifacts と drafts を表示
  • Quality-gate の可視化 (2026-04-08 〜 2026-04-09): HUD minimal status と team history summary に quality-gate category を表示;quality-failed-only フィルター;multi-value 対応の quality prefix フィルター
  • Learn-eval draft 推奨 (2026-04-07 〜 2026-04-09): hindsight lesson drafts;skill patch draft candidates;draft recommendation apply フロー;skill-candidate draft artifacts の永続化
  • Turn-envelope v0 (2026-04-07): ターンベースのテレメトリイベントリンク;harness の clarity entropy memo カバレッジ
  • Browser doctor 自動修復 (2026-04-06 〜 2026-04-08): doctor --fix で CDP サービスを自動修復;setup/update ライフサイクルで browser doctor を自動修復;ドキュメントに CDP クイックコマンドを追加
  • マルチ環境 RL トレーニングシステム: shell、browser、orchestrator アダプタを持つ共有 rl-core 制御プレーン;3 ポインター checkpoint 系列;4 レーン replay pool;PPO + teacher 蒸留トレーニング
  • 混合環境キャンペーン (rl-mixed-v1): 1 つのライブバッチが shell + browser + orchestrator episode にまたがり、統一ロールバック判断で実行
  • ContextDB search がデフォルトで SQLite FTS5 + bm25(...) ランキングになり、FTS 利用不可時は自動レキシカルフォールバック
  • ContextDB セマンティックリランキングがクエリスクープのレキシカル候補で動作し、古い完全一致のドロップを削減
  • aios orchestratesubagent-runtime live 実行(AIOS_EXECUTE_LIVE=1 で opt-in)
  • 所有権ヒント付きバウンド work-item キュー Scheduling
  • no-op ファストパス:上流 handoff がファイルをタッチしなかった場合に reviewer / security-reviewer を自動完了
  • main への各 push 時に Windows PowerShell shell-smoke ワークフロー(.github/workflows/windows-shell-smoke.yml
  • global / project ターゲット選択を持つスコープ対応 skills インストールフロー
  • canonical skill オーサリングが skill-sources/ に移動、repo-local クライアントルートは node scripts/sync-skills.mjs で生成
  • デフォルト skills インストールモードがポータブル copy に;明示的 --install-mode link はローカル開発向けに維持
  • リリース packaging/preflight が check-skills-sync で生成 skill roots を検証
  • コアデフォルト、オプショナル business skills、アンインストールでインストール済み項目のみ表示のカタログ駆動 skill ピッカー
  • TUI skill ピッカーが CoreOptional にグループ化し、ターミナル可読性のために説明を切り詰める
  • doctor が同名グローバルインストールのプロジェクト skill 上書きを警告
  • Node ランタイムガイダンスが Node 24 LTS に明示的に整合
  • Ink TUI リファクタ (v1.1.0): TypeScript + Ink ベースの React コンポーネント TUI;REXCLI ASCII アート起動バナー;アダプティブ watch 間隔;左右オプションサイクリング
  • 0.17.0 (2026-03-17):
  • TUI アンインストールピッカーが小さいターミナルでスクロールし、Select all / Clear all / Done を下部に固定
  • アンインストールカーソル選択が描画グループリストと整合 유지
  • セットアップ/更新 skill ピッカーがすでにインストール済みスキルを (installed) でラベル付け
  • 0.16.0 (2026-03-10): orchestrator agent catalog と生成器を追加
  • 0.15.0 (2026-03-10): orchestrate live をデフォルトで gate(AIOS_EXECUTE_LIVE
  • 0.14.0 (2026-03-10): subagent-runtime ランタイムアダプタ(stub)を追加
  • 0.13.0 (2026-03-10): ランタイム manifest を外部化
  • 0.11.0 (2026-03-10): ローカル orchestrate preflight の対応範囲を拡張
  • 0.10.4 (2026-03-08): 非 git ワークスペースの wrapper fallback と docs 同期
  • 0.10.3 (2026-03-08): Windows の cmd-backed CLI 起動を修正
  • 0.10.0 (2026-03-08): セットアップ/更新/削除のライフサイクルを Node に統合
  • 0.8.0 (2026-03-05): 厳格な Privacy Guard(Ollama 対応)とセットアップ統合を追加
  • 0.5.0 (2026-03-03): ContextDB の SQLite sidecar index(index:rebuild)、任意の --semantic 検索、ctx-agent 実行コア統合

2026-03-16 運用状況

  • 継続的ライブサンプルが成功中(dispatchRun.ok=true)、最新アーティファクト:
  • .aios/context-db/sessions/codex-cli-20260303T080437-065e16c0/artifacts/dispatch-run-20260316T111419Z.json
  • learn-eval がまだ以下を推奨:
  • [fix] runbook.failure-triageclarity-needs-input=5
  • [observe] sample.latency-watchavgElapsedMs=160678
  • latency-watch 観察が続く間、Timeout 予算は現状維持。

関連記事

更新ルール

セットアップ、実行挙動、互換性に関わる変更は、同一 PR でドキュメントを更新し本ページにも反映します。