Harness CLI (AIOS)¶
ローカル agent ワークフローレイヤー。
codex/claude/gemini/opencodeに記憶、協調、検証を追加します。
いつものコマンドを使い続けられます。ワークフローは変わりません。ただ、agent に脳、チーム、自己診断が追加されるだけです。
コア機能¶
| 機能 | 説明 | コマンド |
|---|---|---|
| ContextDB | イベント、checkpoint、context pack を持つクロスセッションプロジェクト記憶 | codex / claude / gemini / opencode が自動ロード |
| Memo Storage | Git フレンドリーなプロジェクトメモ。デフォルトは追加専用ファイルストレージ | aios memo add "note" / aios memo storage status |
| Native Route Shortcuts | single/subagent/team/harness レーン向けクライアントネイティブルートプロンプト | Claude/Gemini/OpenCode: /team <task>; Codex: /prompts:team <task> |
| Native Token Compression | RTK/Caveman パターンに着想を得た自前入力/出力削減。競合ツールはインストールしません | context:pack --token-budget 1200 --token-strategy balanced |
| Model Router | Agent Team 向けインテリジェントマルチモデルディスパッチ。能力、コスト、成功率でタスクをマッチング | node scripts/aios.mjs model-router route --task "..." |
| Codemap | Tree-sitter コード知識グラフ — ワンコマンドで全エージェントがコード構造を即座に理解 | aios internal codemap install / doctor |
| Agent Team | HUD ビジュアル追跡付きマルチ agent 並列協調 | aios team 3:codex "task description" |
| Solo Harness | resume サポートとランジャーナル付き単一 agent 夜通しタスク | aios harness run --objective "goal" --worktree |
| Perception | コンテンツ成果トラッキング + 統計インサイト + perception インジェクション | aios perception record / insights / summary |
| Browser MCP | CDP 経由ステルスブラウザ自動化 | aios internal browser doctor |
| Superpowers | 再利用可能なワークフロースキル(brainstorm/plan/debug/verify) | TUI から選択 |
| Privacy Guard | 共有前に機密ファイルを自動リダクション | aios privacy status |
仕組み¶
User → codex / claude / gemini / opencode
→ zsh wrapper (透過的)
→ ctx-agent.mjs (ContextDB 統合)
→ contextdb CLI (記憶永続化)
→ launch native CLI (context pack 付き)
→ browser MCP (オプションブラウザ自動化)
インストール後は、いつも通り codex、claude、gemini、opencode を使うだけ。Harness CLI はバックグラウンドでプロジェクト記憶を自動ロードし、クライアントがサポートする場所にルートショートカットをプロビジョニングします。
クイックツアー¶
# TUI を起動
aios
# Git フレンドリーなプロジェクトメモを保存
aios memo add "Remember to keep auth tests strict"
aios memo storage status
# セットアップ後のネイティブクライアント内ルート
# Claude/Gemini/OpenCode: /team <task>
# Codex: /prompts:team <task>
# マルチ agent 協調
aios team 3:codex "Refactor the auth module and run tests"
# 単一 agent 夜通しタスク
aios harness run --objective "Finish the handoff docs for tomorrow" --worktree
# インテリジェントモデルルーティング
node scripts/aios.mjs model-router route --task "Review auth.js for security issues"
# ネイティブ token 圧縮 ContextDB パケット
cd mcp-server && npm run contextdb -- context:pack --session <session_id> --token-budget 1200 --token-strategy balanced
# コンテンツ成果トラッキング
aios perception record --content-id note_001 --platform xiaohongshu --content-type note --title "Test" --metrics '{"likes":100}'
# タスクステータス確認
aios team status --provider codex --watch
初めての方へ¶
始めるなら: クイックスタート — インストール、設定、初回 agent 実行を約3分で。
もう設定済み? 必要なところにジャンプ:
| したいこと | 移動先 |
|---|---|
| agent にプロジェクト記憶を付与 | ContextDB |
| 複数の agent を一緒に使う | Agent Team |
| 1つの agent を夜通し走らせる | Solo Harness |
| タスクをインテリジェントにルーティング | Model Router |
| token 使用量を削減 | Token Compression |
| 適切なコマンドを見つける | シナリオ別コマンド |
要件¶
- Git
- Node.js 24 LTS + npm
- Windows: PowerShell 5.x or 7
開発¶
git clone https://github.com/rexleimo/harness-cli.git
cd harness-cli
確認:
cd mcp-server
npm test
npm run typecheck
npm run build
ドキュメント¶
- クイックスタート — インストール、設定、初回実行
- Model Router — Agent Team 向けマルチモデルディスパッチ
- ContextDB — プロジェクト記憶システム
- Agent Team — マルチ agent 協調ガイド
- Solo Harness — 夜通しタスクガイド
- Perception — コンテンツ成果トラッキング & インサイト
- アーキテクチャ — システムアーキテクチャ
- トラブルシューティング — よくある問題
- ユースケース — シナリオ別コマンド検索