agensic v0.3.0

何が、どこで、いつ、誰によって実行されたかを把握する

AI駆動ターミナルワークフローのための欠けている可観測性レイヤー

署名付き来歴 追跡セッション Gitタイムトラベル 再生可能セッション IDEスタイルのTab補完

Agensicは、既存のターミナルワークフローをAI時代にアップグレードします。シェルでAIエージェントの生産性向上を求めるが、監査可能性、制御、プライバシーを妥協したくない開発者のために設計されています。

AIエージェントがコマンドラインをますます引き継ぎ、自律的にタスクを実行するにつれて、可視性と制御が重要になります。 Agensicはターミナルコマンドを第一級市民として扱い、それらを追跡、検査、管理するための堅牢なフレームワークを提供します。

すべてのターミナルアクティビティを単一の曖昧な「シェル履歴」に平坦化する代わりに、Agensicはフォレンジックオブザーバーおよびスマートコパイロットとして機能します。インタラクティブなAIコーディングセッションをシームレスに追跡し、エージェント実行コマンドを暗号学的に署名し、履歴に基づいた高速なIDEスタイルのTab補完を提供します。

📋 目次

1. プラットフォームサポート
2. インストール
3. クイックスタート
4. Agensic来歴
   • 機能
   • サポートされているラベル
5. Agensicセッション
   • 機能
   • サポートされているエージェント
6. Agensic補完
   • 機能
   • サポートされているプロバイダー
7. 利用可能なコマンド
8. 安全性とプライバシー
9. プロジェクト作成者
10. サポート
11. ライセンス

💻 プラットフォームサポート

Agensicはシェル環境と深く統合するように設計されています。

• macOS（Zsh）— 完全サポート ✅

• Linux（Bash）— 完全サポート ✅

🚀 インストール

最速の方法は、管理されたワンライナーインストーラーです：

curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash

手動でクローンしたい場合：

git clone https://github.com/Alex188dot/agensic.git
cd agensic
bash ./install.sh

既に uv がインストールされている場合、インストーラーはそれを自動的に使用して高速セットアップを行います。

初回実行時に、Agensicは希望するLLMプロバイダーを選択し、コマンド補完用のAPIキーを設定するよう促します。

または、以下のコマンドを実行してLLMプロバイダーとAPIキーを設定することもできます：

agensic setup

⚡ クイックスタート

セットアップ後、新しいターミナルを開くと、Agensicが自動的にターミナルアクティビティの追跡を開始し、入力中に補完候補を提供します！

🤖 シームレスなエージェント自動追跡

通常通りに作業を開始します。例えば、お気に入りのAIコーディングアシスタント（Claude Code、Codex CLIなど）を使用します：

claude

または

codex

サポートされているすべてのエージェントの完全なリストについては、サポートされているエージェントセクションを参照してください。エージェントがリストにない場合は、agensic --add_agent "executable" を実行して追加し、通常通り使用することでAgensicが追跡できるようになります。

終了したら、Agensicを使用してセッション履歴を検査できます：

agensic sessions

またはフォレンジック来歴を表示：

agensic provenance

🧾 Agensic来歴

Agensicは、すべてのコマンドにフォレンジックトランスクリプトを提供します。何が起こったかを分類し、豊富なメタデータを記録し、明確な監査証跡を明らかにすることで、コマンドが手動で入力されたか、提案から受け入れられたか、エージェントによって直接実行されたかを判断できるようにします。

✨ 機能

🔍 全画面来歴エクスプローラー

「ここで正確に何が実行され、誰がそれをトリガーしたのか？」という質問に答える必要がありますか？ agensic provenance を実行して全画面来歴ビューアを開きます。ラベル、エージェント、プロバイダー、時間枠でフィルタリングし、正確なコマンドトレイルを検査し、デバッグ、インシデントレビュー、コンプライアンスのために永続的な記録が必要な場合に現在のビューをJSONまたはCSVにエクスポートできます。

🛡️ 暗号学的コマンド来歴と署名

人間かAIがビルドを壊したのか、推測するのはやめましょう。Agensicはすべてのコマンドの豊富なメタデータをキャプチャし、ローカルのEd25519署名を使用してエージェント実行の実行に明白な AI_EXECUTED ラベルをタグ付けします。人間のキーストロークとAIの提案、自動実行を区別する、明確で監査可能なタイムラインが得られます。

🏷️ 構造化された属性ラベル

Agensicはターミナル履歴を生の文字列リストに還元しません。追跡されたすべてのコマンドは来歴ラベルに分類され、実行をフィルタリングし、動作を調査し、コマンドがどのようにシェルに入力されたかを理解するための一貫した方法を提供します。

🔖 サポートされているラベル

Agensicは現在、以下の来歴ラベルをサポートしています：

• AI_EXECUTED：AIエージェントによって直接実行され、署名付き証明のあるコマンド
• HUMAN_TYPED：人間がシェルに手動で入力したコマンド
• AI_SUGGESTED_HUMAN_RAN：外部のAI LLM呼び出しによって提案され、人間が実行したコマンド
• AG_SUGGESTED_HUMAN_RAN：Agensicによって提案され、人間が実行したコマンド
• INVALID_PROOF：検証に失敗した証明メタデータとともに到着したコマンド
• UNKNOWN：利用可能な証拠が不十分で、より強い属性ラベルを割り当てることができないコマンド

🕵️‍♂️ Agensicセッション

Agensicはインタラクティブなエージェントセッションを記録し、何が起こったかの明白な証拠と、Time Travel機能を介してリポジトリの状態を安全に操作する機能を提供します。

✨ 機能

▶️ 再生可能なセッション

昨夜のセッションを監査して、何が起こったのかを理解する必要がありますか？ agensic sessions を実行し、再生したいセッションを選択します。超高速の全画面TUIにより、タイムラインの即時ブラウズ、ペイロードの検査、セッションの再生が可能です。インシデントレビューの証拠を共有する必要がある場合、ワンキーストロークで正確なデータセットをJSONまたはCSVにエクスポートできます。

⏪ タイムトラベル

「エージェントが破壊的なコミットを行う直前、私のリポジトリは正確にどのような状態だったのか？」と考えたことはありませんか？ タイムトラベルを使用すると、特定のセッションチェックポイントでキャプチャされた正確なGit状態にリポジトリを巻き戻すことができます。Agensicは追跡されていないファイルや変更されたファイルを新しいブランチに安全に復元し、調査中にライブの作業ツリーを誤って破壊することを防ぎます。

🗄️ 回復力のあるローカルファースト状態

あなたのデータはあなたのものです。Agensicは、追記専用のイベントジャーナルと自動スナップショット機能を備えた堅牢なSQLite状態バックエンドを使用します。これにより、フォレンジック履歴は、予期しないターミナルクラッシュ、システム再起動、長期のローカル使用にも破損することなく耐えることができます。

🤖 サポートされているエージェント

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で任意のエージェント実行可能ファイルを挿入すると、設定なしですぐに動作します

⚡ Agensic補完

Agensicはターミナル候補を再定義します。コンテキストを認識し、セマンティックで、常に高速なIDEスタイルの満足のいくTab補完を提供します。

✨ 機能

🚀 超高速ローカル履歴候補

入力遅延にさようなら。入力中、Agensicは実際のコマンド履歴のストアをクエリします。ゴーストテキストとして候補が即座に表示され、Tab で簡単に受け入れられます。パターンから学習し、実際の操作に依存するため、候補は非常に正確でリポジトリを認識します。

🧠 セマンティック検索とタイポ回復

人間は間違いを犯します。Agensicがそれを修正します。dokcer と入力すると、Agensicは即座に Did you mean: docker を提案します。正確な構文を覚えていませんか？ セマンティック再ランキングが意図を救出し、プレフィックスが完全に一致しなくても正しいコマンドを見つけます。docker records と入力すると、Did you mean: docker logs が表示されます（過去に docker logs を実行したことがある場合）。

💡 オンデマンドAIフォールバック

AIは強力なフォールバックであり、すべてのキーストロークに対する税ではありません。Agensicはプロンプトスパムを防ぐために、行ごとのLLM予算を適用します。ローカル履歴だけでは不十分な場合、自動LLMフォールバックがトリガーされます。または、いつでも Ctrl+Space を押して、好みのローカルまたはホスト型LLMからインテリジェントな候補を手動で取得することもできます。

💬 自然言語コマンドモード

正確な構文を忘れて、やりたいことを説明するだけです。次のように入力します：# このフォルダ内で10MB以上のファイルをすべて見つけるにはどうすればいいですか？。Agensicは3つのコピー可能なシェルコマンドを生成し、最も可能性の高いオプションを次の行に直接挿入します。コマンドの代わりにガイダンスが必要ですか？ アシスタントモードを使用して、ターミナルで直接ステップバイステップの回答を取得します：## macOSにNodeをインストールする方法は？。コマンドを実行する前に理解したいですか？ 次を使用します：agensic --explain "ここにコマンドを入力"

🛡️ ネイティブTab保存とリスクブロッキング

Agensicはターミナルを尊重します。ファイルパスやスクリプトを補完するときは Tab をそのままにしておくため、ネイティブシェル補完が最適な場面で優先されます。さらに重要なことに、破壊的なコマンド（rm -rf、mkfs、dd など）は候補プールから厳密にブロックされるため、誤って災害を実行することはありません。

🌐 サポートされているプロバイダー

Agensicは、モデルをローカルで実行する場合でも、ホスト型エンドポイントを使用する場合でも、スタックに適合します。

• ローカル： Ollama、LM Studio
• ホスト型： OpenAI、Anthropic、Gemini、Azure、DeepSeek、Groq、Mistral、Qwen（DashScope）、MiniMax、Moonshot、OpenRouter、Xiaomi MiMo、Z.AI、AWS SageMaker
• カスタム： OpenAI互換の任意のエンドポイント
• 履歴のみ： AI呼び出しなしで完全にオフラインで動作し、ローカルコマンド履歴のみを使用

🧰 利用可能なコマンド

以下の表は、Agensicで現在利用可能なすべてのCLIコマンドを示しています。

🔒 安全性とプライバシー

Agensicは最小特権と最大プライバシーの原則に基づいて動作します：

• ローカル認証： すべてのlocalhost APIルートは、自動トークンローテーションで厳密に認証されます
• シークレット編集： 高エントロピー値、URL認証情報、既知のシークレット形式（AWSキーやJWTなど）は、LLM呼び出しのためにデータがマシンから送信される前に取り除かれ、編集されます
• コマンドガードレール： 破壊的なコマンドは、提案エンジンとフィードバックループの両方からハードブロックされます
• レート制限： 外部LLM呼び出しは、API乱用を防ぐために厳格なタイムアウトと予算によって制限されます

👤 プロジェクト作成者

Alessio Leodori

🤝 サポート

Agensicが役に立ちましたか？ リポジトリに ⭐️ を付けて、友達に教えてください！ これが私たちの成長に役立ちます 🌱

📄 ライセンス

Agensicはオープンソースであり、Apache-2.0ライセンスの下でライセンスされています。