Aikd Indexed Semantic & Bm25 Code Search For Ai Agents. Give Your Ai Instant Memory Of Your Codebase. Rust | Mcp Server.

🤔 なぜ AIKD なのか？

問題点： AI コーディングエージェントは強力ですが、忘れっぽいものです。新しい会話を始めるたびに、すべてがゼロからになります。コードベースやコーディングパターン、アーキテクチャの情報は引き継がれません。

AIKD の比較

✨ 主な機能

🔍 検索エンジン

• ハイブリッド検索：BM25（Tantivy）+ ベクトル（ONNX all-MiniLM-L6-v2、384d）
• 逆順位融合：キーワード検索とセマンティック検索の結果を賢く統合
• 増分インデックス作成：Blake3 ハッシュを使用し、重複のないスキャンを実現
• リソースに応じた最適化：CPU/GPU を自動検出し、バッチサイズを調整

🤖 AI 連携

• MCP プロトコル：Model Context Protocol をネイティブサポート
• 組み込みツール 7 種：scan、query、embed、stats、remember、recall、status
• 自動登録：Claude Code、Cursor、Cline、Continue、Windsurf、MiMoCode で動作
• セッションメモリ：セッションをまたいで会話のコンテキストを保持

🛠️ 開発者向け機能

• 単一バイナリ：Python、Node、依存関係は不要
• ファイル監視：ファイル変更時にインデックスを自動再作成
• REST API：独自の連携向けにポート 9090 で HTTP エンドポイントを提供
• CLI 優先：ターミナルからすべてを操作

🎬 動作を見る

$ aikd init
✅ AIKD initialized for project

$ aikd scan
📊 Indexed 847 files, 12,453 chunks in 1.2s

$ aikd query "authentication flow"
1. src/auth/login.rs (Lines 45-89, Score: 0.923)
   Implements JWT-based authentication with refresh tokens...

2. src/middleware/auth.rs (Lines 12-34, Score: 0.871)
   Validates Bearer tokens on protected routes...

3. docs/architecture/auth.md (Lines 1-25, Score: 0.845)
   Authentication flow diagram and security considerations...

📦 インストール

推奨（ワンライナー）

Linux / macOS：

curl -sSf https://raw.githubusercontent.com/gelutjari/aikd/main/install.sh | bash

Windows（PowerShell）：

irm https://raw.githubusercontent.com/gelutjari/aikd/main/install.ps1 | iex

その他の方法

cargo install aikd

brew install gelutjari/tap/aikd

git clone https://github.com/gelutjari/aikd.git
cd aikd
cargo build --release
cp target/release/aikd ~/.local/bin/

docker run -v $(pwd):/workspace -p 9090:9090 ghcr.io/gelutjari/aikd:latest

⚡ クイックスタート（3 分）

ステップ 1：初期化

cd your-project
aikd init

ステップ 3：検索する

# Keyword search (fast)
aikd query "error handling"

# Semantic search (smart)
aikd query "how does login work" --hybrid

# Get JSON output for scripting
aikd query "database connection" --json

ステップ 4：AI エージェントに接続する

{
  "mcpServers": {
    "aikd": {
      "command": "aikd",
      "args": ["serve"]
    }
  }
}

# Start the daemon
aikd daemon

# Query via HTTP
curl "http://localhost:9090/api/query?q=authentication&limit=5"

🎛️ 使用モード

                    ┌─────────────────┐
                    │   How to use    │
                    │     AIKD?       │
                    └────────┬────────┘
                             │
            ┌────────────────┼────────────────┐
            ▼                ▼                ▼
     ┌──────────┐     ┌──────────┐     ┌──────────┐
     │   CLI    │     │   MCP    │     │ REST API │
     │  Mode    │     │  Server  │     │  Daemon  │
     └──────────┘     └──────────┘     └──────────┘
     Best for:        Best for:        Best for:
     • Quick search   • AI agents      • Web apps
     • Scripts        • Claude Code    • Custom UIs
     • CI/CD          • Cursor         • Team shared

CLI モード（デフォルト）：

aikd query "rust error handling" --limit 5
aikd stats
aikd status

MCP サーバー（AI エージェント向け）：

aikd serve  # Starts stdio MCP server

REST デーモン（バックグラウンドサービス）：

aikd daemon              # Start in background
aikd daemon foreground   # Start in foreground
aikd daemon-stop         # Stop daemon

📊 ベンチマーク結果

ハードウェア： AMD EPYC 7B13、7.8GB RAM、NVMe SSD

リソース使用量：

CPU: ████████░░░░░░░░░░░░ 22.9%
RAM: █████░░░░░░░░░░░░░░░ 27.4%

💡 実環境での目安： 人間のまばたきには約300msかかります。その間に、AIKD はコードベース全体を対象に857 回のハイブリッド検索を完了できます。

⚙️ 設定

デフォルト設定（~/.aikd/config.yaml）：

version: 2.0.0
scan:
  include_paths: ["."]
  exclude_paths: ["node_modules", ".git", "target"]
  include_extensions: ["rs", "ts", "py", "md", "json"]
  follow_symlinks: false
chunk:
  max_tokens: 1000
  min_tokens: 100
embedding:
  enabled: true
  model: all-MiniLM-L6-v2
  batch_size: auto
server:
  rest_port: 9090
  auth_token: null
  cors_origins: ["*"]

embedding:
  enabled: true
  batch_size: 8
  device: cpu
resource:
  mode: Low

embedding:
  enabled: true
  batch_size: 64
  device: gpu
resource:
  mode: Max

scan:
  include_extensions: ["md", "txt", "rst"]
  exclude_paths: [".git"]
filter:
  max_file_size: 524288  # 512KB

server:
  rest_port: 9090
  auth_token: "your-secret-token"
  cors_origins:
    - "https://your-team-app.com"

🏗️ アーキテクチャ

┌─────────────────────────────────────────────────────────────┐
│                        AIKD v2.0.0                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────────┐  │
│  │  CLI    │  │  MCP    │  │  REST   │  │ File Watcher│  │
│  │ (clap)  │  │ (rmcp)  │  │ (axum)  │  │  (notify)   │  │
│  └────┬────┘  └────┬────┘  └────┬────┘  └──────┬──────┘  │
│       │            │            │               │          │
│       └────────────┴────────────┴───────────────┘          │
│                            │                                │
│  ┌─────────────────────────┴──────────────────────────┐    │
│  │                   Core Engine                       │    │
│  ├─────────────┬─────────────┬─────────────────────────┤    │
│  │  Scanner    │   Chunker   │      Session Manager    │    │
│  │ (walkdir)   │(pulldown-   │    (conversation DB)    │    │
│  │             │  cmark)     │                         │    │
│  └──────┬──────┴──────┬──────┴─────────────────────────┘    │
│         │             │                                      │
│  ┌──────┴──────┐ ┌────┴─────┐ ┌──────────────────────┐     │
│  │  Indexer    │ │ Embedder │ │     Storage           │     │
│  │  (Tantivy)  │ │ (ONNX)   │ │   (SQLite + WAL)     │     │
│  │  BM25 +     │ │ 384d     │ │   + r2d2 pool        │     │
│  │  HNSW ANN   │ │ MiniLM   │ │   + blake3 hashing   │     │
│  └─────────────┘ └──────────┘ └──────────────────────┘     │
│                                                             │
└─────────────────────────────────────────────────────────────┘

詳しい説明については、docs/ARCHITECTURE.md をご覧ください。

🆘 トラブルシューティング

診断コマンド：

aikd status --json     # System info
aikd stats             # Index statistics
aikd daemon-pid        # Check if daemon running

aikd model download

# Change port in config
# ~/.aikd/config.yaml
server:
  rest_port: 9091

resource:
  mode: Low
  max_memory_mb: 512

🤝 コミュニティ

サポートを受ける：

• 💬 GitHub Discussions — 質問する
• 🐛 Issues — バグを報告する
• 📧 メール：[email protected]

コントリビューター：

貢献方法については、CONTRIBUTING.md をご覧ください。

📄 ライセンス

MIT ライセンス — 詳細については LICENSE をご覧ください。