alex188dot/agensic暗号化ターミナルフォレンジックとAIエージェント向けセッションリプレイ。すべてのコマンドを発祥ラベル付きで追跡、署名、監査し、リプレイ可能なセッションとGitタイムトラベルを提供。プライバシーファーストで、ローカルSQLiteストレージと秘密情報の墨消しを備える。
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/4480e118bb0f8f08f64f7da7573729d0dc6641679e7781e4c4050d939ea4d1b2.png" alt="Agensic logo" width="100%" /> </p> <h2 align="center">何が、どこで、いつ、誰によって実行されたかを把握する</h2> <h3 align="center">AI駆動ターミナルワークフローのための欠けている可観測性レイヤー</h3> <p align="center"> <code>署名付き来歴</code> <code>追跡セッション</code> <code>Gitタイムトラベル</code> <code>再生可能セッション</code> <code>IDEスタイルのTab補完</code> </p> --- Agensicは、既存のターミナルワークフローをAI時代にアップグレードします。シェルでAIエージェントの生産性向上を求めるが、**監査可能性、制御、プライバシー**を妥協したくない開発者のために設計されています。 AIエージェントがコマンドラインをますます引き継ぎ、自律的にタスクを実行するにつれて、可視性と制御が重要になります。 Agensicは**ターミナルコマンドを第一級市民として扱い**、それらを追跡、検査、管理するための堅牢なフレームワークを提供します。 すべてのターミナルアクティビティを単一の曖昧な「シェル履歴」に平坦化する代わりに、Agensicはフォレンジックオブザーバーおよびスマートコパイロットとして機能します。インタラクティブなAIコーディングセッションをシームレスに追跡し、エージェント実行コマンドを暗号学的に署名し、履歴に基づいた高速なIDEスタイルのTab補完を提供します。 --- ## 📋 目次 1. [プラットフォームサポート](#-プラットフォームサポート) 2. [インストール](#-インストール) 3. [クイックスタート](#-クイックスタート) 4. [Agensic来歴](#-agensic来歴) - [機能](#-機能-来歴) - [サポートされているラベル](#-サポートされているラベル) 5. [Agensicセッション](#-agensicセッション) - [機能](#-機能-セッション) - [サポートされているエージェント](#-サポートされているエージェント) 6. [Agensic補完](#-agensic補完) - [機能](#-機能-補完) - [サポートされているプロバイダー](#-サポートされているプロバイダー) 7. [利用可能なコマンド](#-利用可能なコマンド) 8. [安全性とプライバシー](#-安全性とプライバシー) 9. [プロジェクト作成者](#-プロジェクト作成者) 10. [サポート](#-サポート) 11. [ライセンス](#-ライセンス) --- ## 💻 <a id="-プラットフォームサポート"></a>プラットフォームサポート Agensicはシェル環境と深く統合するように設計されています。 - macOS（Zsh）— 完全サポート ✅ - Linux（Bash）— 完全サポート ✅ --- ## 🚀 <a id="-インストール"></a>インストール 最速の方法は、管理されたワンライナーインストーラーです： ```bash curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash ``` 手動でクローンしたい場合： ```bash git clone https://github.com/Alex188dot/agensic.git cd agensic bash ./install.sh ``` 既に `uv` がインストールされている場合、インストーラーはそれを自動的に使用して高速セットアップを行います。 初回実行時に、Agensicは希望するLLMプロバイダーを選択し、コマンド補完用のAPIキーを設定するよう促します。 または、以下のコマンドを実行してLLMプロバイダーとAPIキーを設定することもできます： ```bash agensic setup ``` ## ⚡ <a id="-クイックスタート"></a>クイックスタート セットアップ後、**新しいターミナルを開く**と、Agensicが自動的にターミナルアクティビティの追跡を開始し、入力中に補完候補を提供します！ ### 🤖 シームレスなエージェント自動追跡 通常通りに作業を開始します。例えば、お気に入りのAIコーディングアシスタント（Claude Code、Codex CLIなど）を使用します： ```bash claude ``` または ```bash codex ``` サポートされているすべてのエージェントの完全なリストについては、[サポートされているエージェント](#-サポートされているエージェント)セクションを参照してください。エージェントがリストにない場合は、<code>agensic --add_agent "executable"</code> を実行して追加し、通常通り使用することでAgensicが追跡できるようになります。 終了したら、Agensicを使用してセッション履歴を検査できます： ```bash agensic sessions ``` またはフォレンジック来歴を表示： ```bash agensic provenance ``` --- ## 🧾 <a id="-agensic来歴"></a>Agensic来歴 Agensicは、すべてのコマンドにフォレンジックトランスクリプトを提供します。何が起こったかを分類し、豊富なメタデータを記録し、明確な監査証跡を明らかにすることで、コマンドが手動で入力されたか、提案から受け入れられたか、エージェントによって直接実行されたかを判断できるようにします。 <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/954db235102e042437af9e18befe1d48176d543e55a5bd8ba5cc3ff7a8396f41.gif" alt="Agensic来歴デモ" width="75%" /> </p> ### <a id="-機能-来歴"></a>✨ 機能 ### 🔍 全画面来歴エクスプローラー <p> 「ここで正確に何が実行され、誰がそれをトリガーしたのか？」という質問に答える必要がありますか？ <code>agensic provenance</code> を実行して全画面来歴ビューアを開きます。ラベル、エージェント、プロバイダー、時間枠でフィルタリングし、正確なコマンドトレイルを検査し、デバッグ、インシデントレビュー、コンプライアンスのために永続的な記録が必要な場合に現在のビューをJSONまたはCSVにエクスポートできます。 </p> ### 🛡️ 暗号学的コマンド来歴と署名 <p> 人間かAIがビルドを壊したのか、推測するのはやめましょう。Agensicはすべてのコマンドの豊富なメタデータをキャプチャし、ローカルのEd25519署名を使用してエージェント実行の実行に明白な <code>AI_EXECUTED</code> ラベルをタグ付けします。人間のキーストロークとAIの提案、自動実行を区別する、明確で監査可能なタイムラインが得られます。 </p> ### 🏷️ 構造化された属性ラベル <p> Agensicはターミナル履歴を生の文字列リストに還元しません。追跡されたすべてのコマンドは来歴ラベルに分類され、実行をフィルタリングし、動作を調査し、コマンドがどのようにシェルに入力されたかを理解するための一貫した方法を提供します。 </p> ### <a id="-サポートされているラベル"></a>🔖 サポートされているラベル Agensicは現在、以下の来歴ラベルをサポートしています： - <code>AI_EXECUTED</code>：AIエージェントによって直接実行され、署名付き証明のあるコマンド - <code>HUMAN_TYPED</code>：人間がシェルに手動で入力したコマンド - <code>AI_SUGGESTED_HUMAN_RAN</code>：外部のAI LLM呼び出しによって提案され、人間が実行したコマンド - <code>AG_SUGGESTED_HUMAN_RAN</code>：Agensicによって提案され、人間が実行したコマンド - <code>INVALID_PROOF</code>：検証に失敗した証明メタデータとともに到着したコマンド - <code>UNKNOWN</code>：利用可能な証拠が不十分で、より強い属性ラベルを割り当てることができないコマンド --- ## 🕵️♂️ <a id="-agensicセッション"></a>Agensicセッション Agensicはインタラクティブなエージェントセッションを記録し、何が起こったかの明白な証拠と、Time Travel機能を介してリポジトリの状態を安全に操作する機能を提供します。 <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/5a2de01b27f96092f2a728dcd93c9368336747306cea978c81b18ad3b6714f5e.gif" alt="Agensic再生デモ" width="75%" /> </p> ### <a id="-機能-セッション"></a>✨ 機能 ### ▶️ 再生可能なセッション <p> 昨夜のセッションを監査して、何が起こったのかを理解する必要がありますか？ <code>agensic sessions</code> を実行し、再生したいセッションを選択します。超高速の全画面TUIにより、タイムラインの即時ブラウズ、ペイロードの検査、セッションの再生が可能です。インシデントレビューの証拠を共有する必要がある場合、ワンキーストロークで正確なデータセットをJSONまたはCSVにエクスポートできます。 </p> ### ⏪ タイムトラベル <p> 「エージェントが破壊的なコミットを行う直前、私のリポジトリは正確にどのような状態だったのか？」と考えたことはありませんか？ タイムトラベルを使用すると、特定のセッションチェックポイントでキャプチャされた正確なGit状態にリポジトリを巻き戻すことができます。Agensicは追跡されていないファイルや変更されたファイルを新しいブランチに安全に復元し、調査中にライブの作業ツリーを誤って破壊することを防ぎます。 </p> ### 🗄️ 回復力のあるローカルファースト状態 <p> あなたのデータはあなたのものです。Agensicは、追記専用のイベントジャーナルと自動スナップショット機能を備えた堅牢なSQLite状態バックエンドを使用します。これにより、フォレンジック履歴は、予期しないターミナルクラッシュ、システム再起動、長期のローカル使用にも破損することなく耐えることができます。 </p> ### <a id="-サポートされているエージェント"></a>🤖 サポートされているエージェント Agensicは、追跡可能な事前設定済みの組み込みエージェントのセットをサポートしています： - Claude Code - Codex CLI - Gemini CLI - OpenClaw - OpenCode - Kimi Code - Mini Agent - Qwen Code - GitHub Copilot CLI - Kiro CLI - Cline CLI - Cursor CLI - Nanoclaw - Droid - Hermes Agent - Ollama - Mistral Vibe - Aider - Pi.dev - Kilo Code - Continue CLI カスタムエージェント：agensic setupで任意のエージェント実行可能ファイルを挿入すると、設定なしですぐに動作します --- ## ⚡ <a id="-agensic補完"></a>Agensic補完 Agensicはターミナル候補を再定義します。コンテキストを認識し、セマンティックで、常に高速なIDEスタイルの満足のいくTab補完を提供します。 <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/f710d6a7c01b14691b1d825894e1640c2a92ff1642178a5aed2b3d7d0ac241e3.gif" alt="Agensic補完デモ" width="50%" /> </p> ### <a id="-機能-補完"></a>✨ 機能 ### 🚀 超高速ローカル履歴候補 <p> 入力遅延にさようなら。入力中、Agensicは実際のコマンド履歴のストアをクエリします。ゴーストテキストとして候補が即座に表示され、<code>Tab</code> で簡単に受け入れられます。パターンから学習し、実際の操作に依存するため、候補は非常に正確でリポジトリを認識します。 </p> ### 🧠 セマンティック検索とタイポ回復 <p> 人間は間違いを犯します。Agensicがそれを修正します。<code>dokcer</code> と入力すると、Agensicは即座に <code>Did you mean: docker</code> を提案します。正確な構文を覚えていませんか？ セマンティック再ランキングが意図を救出し、プレフィックスが完全に一致しなくても正しいコマンドを見つけます。<code>docker records</code> と入力すると、<code>Did you mean: docker logs</code> が表示されます（過去に <code>docker logs</code> を実行したことがある場合）。 </p> ### 💡 オンデマンドAIフォールバック <p> AIは強力なフォールバックであり、すべてのキーストロークに対する税ではありません。Agensicはプロンプトスパムを防ぐために、行ごとのLLM予算を適用します。ローカル履歴だけでは不十分な場合、自動LLMフォールバックがトリガーされます。または、いつでも <code>Ctrl+Space</code> を押して、好みのローカルまたはホスト型LLMからインテリジェントな候補を手動で取得することもできます。 </p> ### 💬 自然言語コマンドモード <p> 正確な構文を忘れて、やりたいことを説明するだけです。次のように入力します：<code># このフォルダ内で10MB以上のファイルをすべて見つけるにはどうすればいいですか？</code>。Agensicは3つのコピー可能なシェルコマンドを生成し、最も可能性の高いオプションを次の行に直接挿入します。コマンドの代わりにガイダンスが必要ですか？ アシスタントモードを使用して、ターミナルで直接ステップバイステップの回答を取得します：<code>## macOSにNodeをインストールする方法は？</code>。コマンドを実行する前に理解したいですか？ 次を使用します：<code>agensic --explain "ここにコマンドを入力"</code> </p> ### 🛡️ ネイティブTab保存とリスクブロッキング <p> Agensicはターミナルを尊重します。ファイルパスやスクリプトを補完するときは <code>Tab</code> をそのままにしておくため、ネイティブシェル補完が最適な場面で優先されます。さらに重要なことに、破壊的なコマンド（<code>rm -rf</code>、<code>mkfs</code>、<code>dd</code> など）は候補プールから厳密にブロックされるため、誤って災害を実行することはありません。 </p> ### <a id="-サポートされているプロバイダー"></a>🌐 サポートされているプロバイダー Agensicは、モデルをローカルで実行する場合でも、ホスト型エンドポイントを使用する場合でも、スタックに適合します。 - **ローカル：** Ollama、LM Studio - **ホスト型：** OpenAI、Anthropic、Gemini、Azure、DeepSeek、Groq、Mistral、Qwen（DashScope）、MiniMax、Moonshot、OpenRouter、Xiaomi MiMo、Z.AI、AWS SageMaker - **カスタム：** OpenAI互換の任意のエンドポイント - **履歴のみ：** AI呼び出しなしで完全にオフラインで動作し、ローカルコマンド履歴のみを使用 ## 🧰 <a id="-利用可能なコマンド"></a>利用可能なコマンド 以下の表は、Agensicで現在利用可能なすべてのCLIコマンドを示しています。 | コマンド | 機能 | | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | <code>agensic --help</code> | メインCLIヘルプとすべての標準ユーザー向けコマンドを表示 | | <code>agensic --version</code> | インストールされているAgensicバージョンを表示して終了 | | <code>agensic update</code> | 最新の公開Agensic GitHubリリースをダウンロードしてインストール | | <code>agensic setup</code> | Agensicセッションと補完のインタラクティブセットアップフローを開く | | <code>agensic enable-startup</code> | ログイン時または起動時にAgensicが自動的に起動するように設定 | | <code>agensic first-run</code> | 初回インストール時のオンボーディングフローを実行 | | <code>agensic start</code> | Agensicバックグラウンドデーモンを手動で起動 | | <code>agensic stop</code> | Agensicデーモンを停止 | | <code>agensic logs</code> | デーモンログ出力をリアルタイムで追跡 | | <code>agensic test</code> | デーモンにテスト補完リクエストを送信して接続を確認 | | <code>agensic provenance</code> | コマンド来歴ビューを開く。<code>--limit</code>、<code>--label</code>、<code>--contains</code> などのフィルターをサポート | | <code>agensic sessions</code> | 追跡セッションブラウザを開く。プレーンテキスト出力には <code>--text</code> を使用 | ## 🔒 <a id="-安全性とプライバシー"></a>安全性とプライバシー Agensicは最小特権と最大プライバシーの原則に基づいて動作します： - **ローカル認証：** すべてのlocalhost APIルートは、自動トークンローテーションで厳密に認証されます - **シークレット編集：** 高エントロピー値、URL認証情報、既知のシークレット形式（AWSキーやJWTなど）は、LLM呼び出しのためにデータがマシンから送信される**前に**取り除かれ、編集されます - **コマンドガードレール：** 破壊的なコマンドは、提案エンジンとフィードバックループの両方からハードブロックされます - **レート制限：** 外部LLM呼び出しは、API乱用を防ぐために厳格なタイムアウトと予算によって制限されます --- ## <a id="-プロジェクト作成者"></a>👤 プロジェクト作成者 Alessio Leodori ## <a id="-サポート"></a>🤝 サポート Agensicが役に立ちましたか？ リポジトリに ⭐️ を付けて、友達に教えてください！ これが私たちの成長に役立ちます 🌱 ## 📄 <a id="-ライセンス"></a>ライセンス Agensicはオープンソースであり、**Apache-2.0ライセンス**の下でライセンスされています。
