devmind-cli 0.1.1

DevMind - Semantic Codebase Memory and Agentic Search for Developers

DevMind – Codebase Memory for Developers

"Your codebase finally has a memory."

DevMind is a developer CLI tool and local web interface that gives your codebase a persistent, queryable memory powered by Cognee. It scans source files, git commit history, comments, and architectural decisions, building a hybrid graph-vector knowledge store. This persistent memory allows developers and AI coding assistants (via MCP) to query the codebase in plain English and carry context across infinite sessions.

---

Features

1. One-Command Ingestion (devmind remember): Scans the codebase, git logs, and code comments to feed cognee.remember().
2. Plain-English Q&A (devmind ask "..."): Uses cognee.recall() to retrieve grounded, context-aware answers from the memory graph.
3. Decision Logging (devmind log "..."): Records Architecture Decision Records (ADRs) to capture design reasoning.
4. Memory Refresh (devmind refresh): Automatically detects modified files, updates the graph, and runs cognee.improve().
5. Surgical Forget (devmind forget --file ...): Prunes specific file memory from the knowledge graph using cognee.forget().
6. Claude Code MCP Server (devmind mcp): Seamlessly integrates with Claude Code or Cursor via standard Model Context Protocol (MCP).
7. Local Dashboard UI (devmind dashboard): Provides a clean visual panel showing memory status, search queries, and recent decisions.
8. Smart API Key Rotation: Automatically detects, formats, and rotates between multiple Groq and OpenRouter API keys to balance rate limits on free-tier LLM access.

---

Installation & Setup

1. Clone the repository

git clone https://github.com/Anishp-cell/devmind-CLI.git
cd devmind-CLI

2. Configure Environment Variables

Copy .env.example to .env and fill in your keys:

cp .env.example .env

To run for free, configure your .env with a list of rotated API keys:

LLM_PROVIDER="groq"

# Add a comma-separated list of Groq keys (gsk_...) and/or OpenRouter keys (sk-or-v1-...)
# The CLI automatically load-balances and routes requests to the correct endpoints!
GROQ_API_KEYS="gsk_key1,sk-or-v1-key2,gsk_key3"

EMBEDDING_PROVIDER="fastembed"
EMBEDDING_MODEL="BAAI/bge-small-en-v1.5"
EMBEDDING_DIMENSIONS="384"

3. Install DevMind

Install the package in editable mode:

pip install -e .

---

CLI Command Reference

• Ingest Codebase:

  devmind remember
  

• Ask a Question:

  devmind ask "Why did we switch to redis for the queue?"
  

• Log an Architectural Decision (ADR):

  devmind log "Chose FastAPI for the web UI because it supports async routes natively."
  

• Refresh Changed Memory:

  devmind refresh
  

• Forget a Specific File:

  devmind forget --file devmind/web/app.py
  

• Wipe Local Database Cache:

  devmind forget --all
  

• Launch Web Dashboard:

  devmind dashboard --port 8000
  

• Start MCP Server:

  devmind mcp
  

---

Running the Mock Demo Project

To test DevMind on a smaller project without polluting your main repo:

1. Navigate to the demo directory:

   cd examples/demo_project
   

2. Build the memory of the demo:

   devmind remember --dir .
   

3. Query its memory:

   devmind ask "What open TODO tasks are left in main.py?"
   devmind ask "Why do we use SQLite according to our architecture decisions?"
   

---

Claude Code MCP Integration

To connect Claude Code to DevMind's memory, add the server to your Claude MCP config:

claude mcp add devmind "devmind mcp"

Alternatively, configure your project-level .mcp.json file in your project root:

{
  "mcpServers": {
    "devmind": {
      "command": "devmind",
      "args": ["mcp"]
    }
  }
}

---

AI Assistant Declaration

Per the rules of The Hangover Part AI Hackathon, this project declares the use of Claude (via the Antigravity IDE agent) as an AI pair programmer.