winstonkoh87/Athena-Public

これは何？

主な機能

• 01メモリとコンテキストをプレーンなMarkdownファイルとJSONLファイルとしてローカルディスクに保存。
• 02BM25全文検索、pgvector、ONNXクロスエンコーダーによる再ランキングを組み合わせたハイブリッド検索。
• 03反証可能な仮説とBrierスコアによる較正評価を備えた問題定義の台帳。
• 04SHA-256の証跡を伴う、EEV、ケリー基準の3分の1、破産確率、MCDA、モンテカルロによる定量的な意思決定のスクリーニング。
• 05メモリ検索用、およびCSV、JSON、ParquetファイルのDuckDBクエリ用のMCPサーバー。
• 06特定の破壊的なコマンドをブロックし、シークレットをスキャンするフック。

ユースケース

• Claude Code、Cursor、Gemini CLIを切り替えても、AIコーディングアシスタントのプロジェクトコンテキストを一貫して保つ。
• 前提と反証条件を明示した、構造化された意思決定を記録・レビューする。
• 大きなCSVやParquetのデータセットをコンテキストウィンドウに読み込まずに、LLMエージェントからクエリする。
• AIエージェントのセッションにローカルなガバナンス用フックを追加する。

クイックスタート

1. 1

   リポジトリをクローンして、そのディレクトリに移動する

   git clone https://github.com/winstonkoh87/Athena-Public.git && cd Athena-Public
2. 2

   Python仮想環境を作成して有効化する

   python3 -m venv .venv && source .venv/bin/activate
3. 3

   軽量版パッケージをインストールする

   pip install -e ".[local]"
4. 4

   IDE用にAthenaを初期化し、ヘルスチェックを実行する

   athena init --ide claude && athena doctor

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

• !長期的なパーソナライズの根拠は、複数ユーザーを対象とした調査ではなく、1人の著者による利用実績（N=1）に基づいています。
• !ライフサイクルフックのないIDEでは、一部の迎合防止策はエージェントの裁量に委ねられます。
• !検索品質は限定的で、著者の正解データセットにおける厳密なHit@5は0.569です。
• !完全なインストールには、同期用のSupabaseなどのオプションのクラウドサービスが必要です。

収録されている特集

トピック

よくある質問

Athena-Public とは？

MarkdownとJSONLファイルにコンテキストを保存し、複数のIDEやLLMで使える、ローカルファーストのAIエージェント向けメモリ・意思決定レイヤー。 Athenaは、AIアシスタントのメモリ、問題の捉え方、意思決定の記録を、所有者自身のディスク上にプレーンなMarkdownファイルとJSONLファイルとして保存するため、モデルやエディターを切り替えてもコンテキストを維持できます。Pythonパッケージとしてインストールし、検索とガバナンス用、およびDuckDBベースの分析クエリ用の2つのMCPサーバーを通じて機能を提供します。

Athena-Public は無料で使えますか？ライセンスは？

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

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

活発にメンテナンス中。Athena-Public の最終コミットは 2026年11月6日 です。

Athena-Public は何に使えますか？

Claude Code、Cursor、Gemini CLIを切り替えても、AIコーディングアシスタントのプロジェクトコンテキストを一貫して保つ。 前提と反証条件を明示した、構造化された意思決定を記録・レビューする。 大きなCSVやParquetのデータセットをコンテキストウィンドウに読み込まずに、LLMエージェントからクエリする。 AIエージェントのセッションにローカルなガバナンス用フックを追加する。

Athena-Public のインストール方法は？

リポジトリをクローンして、そのディレクトリに移動する: git clone https://github.com/winstonkoh87/Athena-Public.git && cd Athena-Public Python仮想環境を作成して有効化する: python3 -m venv .venv && source .venv/bin/activate 軽量版パッケージをインストールする: pip install -e ".[local]" IDE用にAthenaを初期化し、ヘルスチェックを実行する: athena init --ide claude && athena doctor

Athena-Public はどこで入手できますか？

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