SAGE Wrapper

SAGE - スマートエージェントガイダンスエンジン

SAGE は、AI コーディングエージェント向けのローカルファーストなコマンドラッパーです。ターミナルの出力全体をお使いのマシンに保持し、エージェントには整理して圧縮した要約を送信します。また、生のログをアップロードすることなく、効果を示す指標を記録します。

Claude Code、Codex、Cursor、Windsurf、OpenCode、Cline、カスタムエージェント、CI スクリプト、通常のターミナルワークフローで使用できます。

まずはこちら：SAGE をインストールし、sage run -- python -m pytest を一度実行してから、任意の AI エージェントを使用する

パッケージレジストリの安全性を確保するため、パッケージのインストールだけでは有効化されません。インストール後、sage install を一度実行すると、サポート対象のローカル AI エージェントで SAGE が有効になります。

PyPI / pip

pip install psycgod-sage
# or
python -m pip install --upgrade psycgod-sage
sage install
sage run -- python -m pytest

npm / npx

npm install -g psycgod-sage
npx -y psycgod-sage install
npx -y psycgod-sage run -- npm test

インストール後、開いている AI エージェントのセッションを再起動してください。新しいセッションでは SAGE の手順が自動的に読み込まれ、ターミナルコマンドが SAGE 経由で実行されます。

AI エージェントの再起動後に使うプロンプトの例：

Please help me with my general book in this folder.

自然なショートカットも使用できます：

sage pytest
sage npm test
sage git status

これらは次のように扱われます：

sage run -- pytest
sage run -- npm test
sage run -- git status

SAGE の機能

ステップ	結果
sage install	マシン上でローカルに有効化し、グローバルおよびプロジェクトのエージェント向け手順を修復して、有効化を検証します
sage run -- <command>	コマンドを実行し、生の出力をローカルに保存して、簡潔で役立つ要約を返します
エージェントのメモリ／フック	サポート対象の AI エージェントに、出力の多いターミナル作業では SAGE を使うよう指示します
ローカルデータベース	コマンド履歴、圧縮の効果を示す情報、再試行のコンテキストをユーザーのマシン上に保持します
ローカルでの効果の記録	コマンドと圧縮の指標をユーザーのマシン上に保持します

SAGE は MCP を自動的に有効化しません。MCP は任意であり、利用したいユーザーが手動で設定します。

記録されたローカル指標

2026-08-01 時点で取得した最新の統計：

指標	値
SAGE テレメトリのコマンドイベント数	27,892
処理したトークン数	799.5M
削減したトークン数	783.7M
圧縮率	98.02%
推定削減額	$16,261.90
コマンド成功率	88.3%
PyPI の過去 7 日間のダウンロード数	632
npm の過去 7 日間のダウンロード数	362
GitHub の過去 14 日間のクローン数	574

役立つ理由

AI コーディングエージェントは、繰り返されるログ、失敗したテストの出力、インストール時のノイズ、スタックトレース、ビルドの大量出力にコンテキストを費やしてしまいます。SAGE はコマンドとエージェントの間に位置します。

SAGE なし	SAGE あり
エージェントにノイズの多いターミナル出力全体が表示されます	エージェントには役立つ要約が表示されます
コンテキストがすぐに失われます	コンテキストが長く保たれます
失敗の繰り返しでトークンを無駄にします	エラーがまとめられ、説明されます
生のログがプロンプトに含まれる可能性があります	生のログはローカルに保持されます
削減効果を証明するのが困難です	SAGE が効果を示す指標を記録します

配布先

チャネル	パッケージ	状態
PyPI	psycgod-sage	正式な Python パッケージ
npm / npx	psycgod-sage	Python コアを起動する Node ランチャー
MCP Registry	io.github.PsYcGoD/sage	任意／手動で登録する MCP エントリー
Glama	PsYcGoD/sage	任意／手動で登録するホスト型 MCP リスティング

npm パッケージは Python 実装に処理を委ねるため、どちらのインストール方法でも同じローカルデータベース、テレメトリのルール、圧縮機能、コマンド動作を使用します。

よく使うコマンド

sage install                       # Activate this machine and AI-agent instructions
sage doctor --activation           # Verify activation
npx -y psycgod-sage doctor --activation
sage run -- <command>              # Wrap any command
sage run --cwd /project -- <command> # Explicit workspace for host integrations
sage pytest                        # Shortcut for: sage run -- pytest
sage npm test                      # Shortcut for: sage run -- npm test
sage git status                    # Shortcut for: sage run -- git status
sage context stats                 # Token savings summary
sage context report                # Full compression report
sage history --limit 10            # Recent command history
sage explain --failed              # Explain the latest failed command
sage suggest --failed              # Suggest the next fix
sage fix --apply                   # Try an automatic fix
sage ml setup                      # Optional ML V2 dependencies
sage mcp install                   # Optional/manual MCP config
sage dashboard start               # Local dashboard

プライバシーモード

モード	ログインが必要ですか？	データを送信しますか？	マシンの外部に送信されるもの
ローカルのみ	いいえ	いいえ	ありません
デバッグテレメトリ	任意	オプトインした場合のみ	匿名化された診断サマリー

SAGE は、ユーザーがデータ送信を必要とする機能を意図的に有効にしない限り、プロンプト、ソースコード、認証情報、生のコマンド出力、プロジェクトファイルをローカルに保持するよう設計されています。

既知の制限事項

制限事項	対処方法
すでに開いている AI エージェントのセッションでは、新しい指示が再読み込みされない場合があります	sage install の実行後、Claude/Codex/Cursor/Windsurf/OpenCode を再起動してください
制限されたホストアプリでは、シェルツールが無効にされる場合があります	SAGE では、ホストアプリがブロックしているツールを有効にできません
ホストがシェルを誤ったフォルダーで起動します	sage run --cwd <project> -- <command> を渡すか、SAGE_WORKSPACE_CWD を設定してください
npm/PyPI からのインストールでは、安全にアクティベーションを自動実行できません	パッケージのインストール後に一度 sage install を実行してください
一部の stdio エージェントセッションでは、MCP が切断されることがあります	既定では通常の sage run -- <command> を使用し、必要な場合にのみ MCP を手動で有効にしてください
パッケージのインストールは、設計上、機能を有効化しません	実際のアクティベーションは sage install から始まります

デモ

フロー	プレビュー
PyPI のインストール
npm のインストール
sage run --
CLI の実行

リンク

• PyPI：pypi.org/project/psycgod-sage
• npm：npmjs.com/package/psycgod-sage

ライセンス

MIT。詳しくは LICENSE をご覧ください。