@gogoai/index1

AI memory system for coding agents — code index + cognitive facts, persistent across sessions.

This npm package is a Node.js wrapper that auto-installs and forwards to the Python index1 CLI. It lets you use npx index1 without manually installing Python packages.

Quick Start

npx @gogoai/index1 index ./src    # Index your project
npx @gogoai/index1 serve          # Start MCP Server
npx @gogoai/index1 setup          # One-click Claude Code plugin install

Or install globally:

npm i -g @gogoai/index1
index1 search "how does auth work"

How it works

1. Checks if index1 Python CLI is already installed
2. If not, auto-installs via pipx / pip3 / pip
3. Forwards all arguments to the Python CLI

What is index1?

index1 gives AI coding agents persistent memory:

| Module | Memory Type | What it stores | |--------|-------------|---------------| | corpus/ | Semantic memory | Code index — files, functions, classes | | cognition/ | Episodic memory | Cognitive facts — lessons, decisions, bug causes |

Key features

• Hybrid search: BM25 + vector, fused with RRF
• Built-in ONNX embedding (bge-small-en-v1.5) — vector search works out of the box
• 6 MCP tools: recall, learn, read, status, reindex, config
• Structure-aware chunking: Python, Rust, JavaScript, Markdown, plain text
• CJK optimized: Chinese/Japanese/Korean with dynamic weight tuning
• Graceful degradation: No embedding service? Falls back to BM25-only

MCP Setup

Add to your .mcp.json:

{
  "mcpServers": {
    "index1": {
      "type": "stdio",
      "command": "index1",
      "args": ["serve"]
    }
  }
}

Or use one-click setup: index1 setup

Requirements

• Node.js >= 16 (for this wrapper)
• Python >= 3.10 (auto-installed dependency)
• ONNX embedding built-in — vector search works out of the box
• Ollama (optional, for enhanced multilingual/CJK support)

Also available as

• PyPI: pip install index1
• GitHub: gladego/index1
• Claude Code Marketplace: gladego/index1-plugins
• ClawHub: clawhub install index1

License

Apache-2.0