open-gitagent/gitagent

これは何？

主な機能

• 01エージェントのアイデンティティ、ルール、メモリ、ツールを、gitでバージョン管理されるファイルとして保存します。
• 02ツール呼び出しを制御・変更するフックを備えた、`query()`経由のストリーミング対応SDK。
• 03ローカルディレクトリを対象にするか、GitHubリポジトリをセッション用ブランチにcloneして実行します。
• 04MCPクライアントとして動作し、設定済みサーバーからツールを自動登録します。
• 05宣言型のYAMLツール、スキル、プラグインに対応します。
• 06任意で有効化できるOpenTelemetryトレーシングと監査ログ。

ユースケース

• ルールやメモリをgitの差分でレビューしながら、個人用またはチーム用のAIアシスタントを管理する。
• ベースとなるエージェントをフォークし、性格やルールのバリエーションをブランチで作成する。
• GitHubリポジトリを対象にエージェントを実行し、セッション用ブランチで修正を加える。
• カスタムツールを使い、`query()` SDK経由でNode.jsアプリにエージェントを組み込む。

クイックスタート

1. 1

   npmでCLIとSDKをインストールする

   npm install -g @open-gitagent/gitagent
2. 2

   OpenAI APIキーを設定する

   export OPENAI_API_KEY="sk-..."
3. 3

   プロジェクトディレクトリで最初のエージェントを実行する

   gitagent --dir ~/my-project "Explain this project and suggest improvements"

使う前に知っておきたいこと

• !エージェントを実行するには、OpenAIやAnthropicなどのモデルプロバイダーのAPIキーが必要です。
• !音声モードとWeb UIは別パッケージの@open-gitagent/voiceに含まれており、個別にインストールする必要があります。

トピック

よくある質問

gitagent とは？

エージェントのアイデンティティ、ルール、メモリ、ツール、スキルをリポジトリ内のバージョン管理可能なファイルとして扱う、GitネイティブなAIエージェントフレームワーク。 Gitagentでは、AIエージェントをGitリポジトリとして扱います。エージェントの性格（SOUL.md）、行動ルール（RULES.md）、メモリ（memory/）、宣言型のYAMLツール、組み合わせ可能なスキル、ライフサイクルフックはすべて通常のファイルです。そのため、一般的なgitコマンドでエージェントをフォーク、ブランチ作成、差分確認、調査できます。

gitagent は無料で使えますか？ライセンスは？

gitagent は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

gitagent は今もメンテナンスされていますか？

活発にメンテナンス中。gitagent の最終コミットは 2026年10月22日 です。

gitagent は何に使えますか？

ルールやメモリをgitの差分でレビューしながら、個人用またはチーム用のAIアシスタントを管理する。 ベースとなるエージェントをフォークし、性格やルールのバリエーションをブランチで作成する。 GitHubリポジトリを対象にエージェントを実行し、セッション用ブランチで修正を加える。 カスタムツールを使い、`query()` SDK経由でNode.jsアプリにエージェントを組み込む。

gitagent のインストール方法は？

npmでCLIとSDKをインストールする: npm install -g @open-gitagent/gitagent OpenAI APIキーを設定する: export OPENAI_API_KEY="sk-..." プロジェクトディレクトリで最初のエージェントを実行する: gitagent --dir ~/my-project "Explain this project and suggest improvements"

gitagent はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/open-gitagent/gitagent