Overview
ai-memex-cli (zelixag) is a universal CLI + agent skill with a dual-vault system (global + project) and session distillation. It is a Tier 2 MCP/tooling implementation in the comprehensive report — useful for separating personal vs project memory and capturing sessions automatically.
Key Facts
- Interface: universal CLI + agent skill
- Dual-vault: global vault + per-project vault
- Session distillation: distills conversation sessions into memory
- Recommended graduate path for “I can run a CLI” users adding graph later
- License: MIT
Features
Core Architecture
- Dual-vault system — default wiki vault at ~/.llmwiki/ (personal, compounding) + project vault at
/.llmwiki/local/ (project-specific) - Agent-first workflows — 6 intent verbs: capture, ingest, query, distill, lint, status
- CLI toolbox — deterministic primitives underneath: fetch, search, lint, link-check, init, onboard, install-hooks
- Zero LLM API calls from CLI — the agent (Claude Code, Cursor, Codex) does semantic work through the skill
Ingest & Processing
- Web fetching — URL crawl, sitemap crawl, recursive depth control, keyword search via DuckDuckGo (no API key)
- Session distillation — batch-convert agent session files (JSONL) into structured markdown with frontmatter
- Fuzzy path resolution — ingest accepts partial paths, agent resolves actual files
- Multi-format — markdown, PDF, DOCX, and more via agent
Search & Retrieval
- Full-text search — local wiki search with relevance scoring
- Agent-driven query — answers from durable wiki knowledge with citations instead of re-deriving
Quality & Governance
- Two-layer lint — mechanical CLI pass + agent-driven semantic pass
- Self-healing watch daemon — ingest → lint → ingest loop until zero issues (optional, token-burning)
- Link check — validates wikilinks across all pages
Integration
- 8+ agent support — Claude Code, Codex, OpenCode, Gemini CLI, Cursor, Aider, Continue.dev, Generic
- Slash commands — auto-generated for all agents (/memex:capture, /memex:ingest, /memex:query, etc.)
- Interactive onboarding wizard — select agent, record session dirs, init vault, install hooks
- Context bootstrap — memex context install writes vault digest into CLAUDE.md/AGENTS.md for session-start context
Data & Storage
- Git-backed markdown — plain markdown files versioned in git
- Scene × type classification — pages organized by scene (personal/research/reading/team) × type (entity/concept/source/comparison/overview/synthesis)
- Self-update — memex update auto-detects npm or git install
Relationships
- “compatible-with” llm-wiki — CLI/skill implementation of the pattern
- “belongs-to” agent-memory-systems — session distillation is a memory operation
- “operates-with” claude-code — agent skill form factor
- “sibling-of” cognee — both offer session/auto-capture; Cognee is heavier
Implications
ai-memex-cli’s dual-vault + session distillation is a concrete answer to “capture without manual work” — it auto-distills chats into the wiki, removing the human drop-step.
External Links
- Repository: https://github.com/zelixag/ai-memex-cli
Não confunda com
Este projeto compartilha o nome “memex” com outros dois do ecossistema, mas são coisas diferentes:
- memex-zero-rag — foca em zero-hallucination (quarantena de páginas >20% sem fonte), não em CLI dual-vault.
- wastedcode-memex — é um runtime daemonizado em Go, não uma CLI de sessão.