memory-neo 0.1.4

Push your codebase to a graph DB and query it with natural language

memory-neo/docs/README.md

Path: docs/README.md

Purpose: User-facing documentation — install, usage, deployment

🧠 memory-neo

Push your codebase to a graph database. Query it with natural language.

pip install memory-neo
cd your-project/
memory-neo push
memory-neo query "show all auth functions"
memory-neo context parse_directory

---

How it works

1. Push — memory-neo push scans your project, extracts files and Python functions via AST, and sends the structure to a hosted Memgraph graph database.
2. Query — memory-neo query "..." converts your question to Cypher via Claude, runs it against your graph, and prints results with code highlighting.
3. Context — memory-neo context <name> fetches a function or file as prompt-ready code you can paste into any LLM.

---

Install

pip install memory-neo

Python 3.9+ required.

---

Authentication

Get an API key at memory-neo.dev, then:

memory-neo login
# Paste your API key when prompted
# Saved to ~/.memoryneo/config.json

---

Commands

memory-neo push

Scan the current directory and push its structure to Memgraph.

memory-neo push                        # use directory name as project name
memory-neo push my-project             # explicit project name
memory-neo push --dir ./src            # scan a subdirectory
memory-neo push --dry-run              # scan only, don't push

What gets indexed:

• Files: .py .js .jsx .ts .tsx .html .md .txt
• Python: full AST extraction — function names, line numbers, args, docstrings, code
• Other: file name, path, content, line count

Ignored by default (via memIgnore):

• .venv/, node_modules/, __pycache__/, .git/, *.pyc, .env, and more

Custom ignore: place a memIgnore file in your project root (same syntax as .gitignore).

---

memory-neo query

Ask a natural language question about your indexed codebase.

memory-neo query "show all auth functions"
memory-neo query "which files import httpx"
memory-neo query "list all Python files"
memory-neo query "how many functions are in each file"
memory-neo query "show the parse_directory function"
memory-neo query --project my-project "show all classes"
memory-neo query --raw "..."           # print raw JSON
memory-neo query --context "..."       # dump results as prompt-ready context block
memory-neo query                       # interactive mode

---

memory-neo context

Fetch the raw code of a function or file — ready to paste into a prompt.

memory-neo context parse_directory           # fetch function by name
memory-neo context memory_neo/main.py        # fetch file by path
memory-neo context login --type function     # force function lookup
memory-neo context main.py --copy            # copy to clipboard

---

Ignore patterns (memIgnore)

Place a memIgnore file in your project root to control what gets scanned. Uses the same syntax as .gitignore:

# Folders
.venv/
node_modules/
dist/

# Wildcards
*.log
*.tmp
*.pyc

# Files
.env
secrets.json

If no memIgnore is found in your project, the package default is used (covers most common cases).

---