codemind-okf 1.2.0

CodeMind OKF CLI — Generate AI-ready knowledge bundles for any codebase. Works with Cursor, Antigravity, GitHub Copilot, and any MCP-compatible AI IDE.

🧠 CodeMind OKF CLI

Generate AI-ready knowledge bundles for any codebase.
Works with Cursor, Antigravity IDE, Claude Desktop, GitHub Copilot, and any MCP-compatible AI IDE.

---

📦 Installation

pip install codemind-okf

---

🚀 Quick Usage

1. codemind index — Index Any Project

Crawls your project files using Tree-sitter & AST parsers to generate a .okf/ knowledge bundle.

codemind index .                         # Index current directory
codemind index /path/to/project          # Index a specific directory
codemind index . --lang python           # Only index Python files
codemind index . --overwrite             # Force re-index from scratch

• ⚡ SHA-256 Incremental Indexing: Remembers file hashes. Subsequent runs skip unchanged files in 0.05s!

---

2. codemind init — Drop AI IDE Instructions

Creates instruction files so Cursor, Antigravity, and GitHub Copilot use .okf/index.md as primary context.

codemind init                            # Create all AI IDE config files

Files created:

File	Compatible Tool
.cursorrules	Cursor AI IDE
.agents/AGENTS.md	Antigravity IDE & Open Agents
.github/copilot-instructions.md	GitHub Copilot

---

3. codemind audit — Architecture & Health Audit

Performs an architectural health check evaluating line density, docstring coverage, and layer separation.

codemind audit                          # Health score (0-100 A+)

---

4. codemind watch — Real-Time Background File Watcher

Watches the project directory for file saves and incrementally updates .okf/ in under 50ms.

codemind watch                          # Run watcher in background

---

5. codemind mcp — Model Context Protocol (MCP) Server

Launches the MCP server over STDIO. Connects CodeMind natively to Cursor, Claude Desktop, Antigravity, or Zed.

codemind mcp

Add to Cursor / Claude Desktop / Antigravity (mcp.json):

{
  "mcpServers": {
    "codemind": {
      "command": "uvx",
      "args": [
        "--from",
        "codemind-okf",
        "codemind",
        "mcp"
      ]
    }
  }
}

6. codemind memory — Manage AI Persistent Memory Log (.okf/memory.md)

Inspect, view, clear, or manually log memory entries to .okf/memory.md.

codemind memory show                     # Print full memory log
codemind memory ls                       # Show entry summary by type
codemind memory add "..." --type decision# Manually append memory entry
codemind memory clear                    # Reset memory log

---

🔌 Exposed MCP Tools

MCP Tool	Description
🧠 remember(content, type)	Persists AI decisions, tasks, context & bugs into .okf/memory.md
🔄 recall(query)	Retrieves relevant past memories at session start to eliminate context loss
📚 get_project_index	Reads the master architecture map (index.md)
🔍 search_bundle(query)	Sub-word & token search across all project modules
📖 read_module(slug)	Reads specific module AST metadata & function signatures
🔗 trace_dependencies(slug)	Traces import graphs between components
📁 list_bundles	Discovers available .okf/ knowledge bundles

---

📄 License

MIT License. See repository for details.