Skip to content

Commit 8bca70e

Browse files
prefrontalsysclaude
andcommitted
Update documentation and remove old branding assets
- Updated README.md with latest project information - Updated memory system prompt documentation - Removed deprecated logo files (PNG/SVG variants) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 23eefce commit 8bca70e

6 files changed

Lines changed: 3 additions & 171 deletions

File tree

‎README.md‎

Lines changed: 1 addition & 79 deletions
Original file line numberDiff line numberDiff line change
@@ -366,27 +366,6 @@ CORTEXGRAPH_PROMOTE_THRESHOLD=0.65
366366
LTM_VAULT_PATH=~/Documents/Obsidian/Vault
367367
```
368368

369-
**Method 2: Environment variables in Claude Desktop config**
370-
371-
Add environment variables directly to `~/Library/Application Support/Claude/claude_desktop_config.json`:
372-
373-
```json
374-
{
375-
"mcpServers": {
376-
"cortexgraph": {
377-
"command": "cortexgraph",
378-
"env": {
379-
"CORTEXGRAPH_STORAGE_PATH": "~/.config/cortexgraph/jsonl",
380-
"CORTEXGRAPH_DECAY_MODEL": "power_law",
381-
"CORTEXGRAPH_PL_ALPHA": "1.1",
382-
"CORTEXGRAPH_PL_HALFLIFE_DAYS": "3.0",
383-
"LTM_VAULT_PATH": "~/Documents/Obsidian/Vault"
384-
}
385-
}
386-
}
387-
}
388-
```
389-
390369
**Where cortexgraph looks for .env files:**
391370
1. **Primary**: `~/.config/cortexgraph/.env` ← Use this for `uv tool install` / `uvx`
392371
2. **Fallback**: `./.env` (current directory) ← Only works for editable installs
@@ -418,22 +397,6 @@ Use that path in your config. Replace `yourusername` with your actual username.
418397

419398
**Why absolute path?** GUI apps like Claude Desktop don't inherit your shell's PATH configuration (`.zshrc`, `.bashrc`). Using the full path ensures it always works.
420399

421-
**Alternative: Simple command (only if cortexgraph is in system PATH)**
422-
423-
If you've symlinked cortexgraph to `/usr/local/bin` or `/opt/homebrew/bin`:
424-
425-
```json
426-
{
427-
"mcpServers": {
428-
"cortexgraph": {
429-
"command": "cortexgraph"
430-
}
431-
}
432-
}
433-
```
434-
435-
Configuration loaded from `~/.config/cortexgraph/.env` or environment variables (see Configuration section above).
436-
437400
**For development (editable install):**
438401

439402
```json
@@ -487,19 +450,6 @@ Update your Claude config with the absolute path:
487450
```
488451

489452
Replace `/Users/username/.local/bin/cortexgraph` with your actual path from `which cortexgraph`.
490-
491-
**Alternative: System-wide install**
492-
493-
You can also install to a system location that Claude Desktop searches:
494-
495-
```bash
496-
# Option 1: Link to /usr/local/bin
497-
sudo ln -s ~/.local/bin/cortexgraph /usr/local/bin/cortexgraph
498-
499-
# Option 2: Install with pipx/uv to system location (requires admin)
500-
sudo uv tool install git+https://github.com/simplemindedbot/cortexgraph.git
501-
```
502-
503453
### Maintenance
504454

505455
Use the maintenance CLI to inspect and compact JSONL storage:
@@ -530,29 +480,6 @@ uv tool install git+https://github.com/simplemindedbot/cortexgraph.git
530480

531481
**Your data is safe!** This only changes how the command is installed. Your memories in `~/.config/cortexgraph/` are untouched.
532482

533-
### Migrating from STM Server
534-
535-
If you previously used this project as "STM Server", use the migration tool:
536-
537-
```bash
538-
# Preview what will be migrated
539-
cortexgraph-migrate --dry-run
540-
541-
# Migrate data files from ~/.stm/ to ~/.config/cortexgraph/
542-
cortexgraph-migrate --data-only
543-
544-
# Also migrate .env file (rename STM_* variables to CORTEXGRAPH_*)
545-
cortexgraph-migrate --migrate-env --env-path ./.env
546-
```
547-
548-
The migration tool will:
549-
- Copy JSONL files from `~/.stm/jsonl/` to `~/.config/cortexgraph/jsonl/`
550-
- Optionally rename environment variables (STM_* → CORTEXGRAPH_*)
551-
- Create backups before making changes
552-
- Provide clear next-step instructions
553-
554-
After migration, update your Claude Desktop config to use `cortexgraph` instead of `stm`.
555-
556483
## CLI Commands
557484

558485
The server includes 7 command-line tools:
@@ -782,16 +709,11 @@ AGPL-3.0 License - See [LICENSE](LICENSE) for details.
782709

783710
This project uses the GNU Affero General Public License v3.0, which requires that modifications to this software be made available as source code when used to provide a network service.
784711

785-
### Knowledge & Memory
786-
* [mem0ai/mem0-mcp](https://github.com/mem0ai/mem0-mcp) (Python) - A MCP server that provides a smart memory for AI to manage and reference past conversations, user preferences, and key details.
787-
* [cortexgraph](https://github.com/simplemindedbot/cortexgraph) (Python) - A Python-based MCP server that provides a human-like short-term working memory (JSONL) and long-term memory (Markdown) system for AI assistants. The core of the project is a temporal decay algorithm that causes memories to fade over time unless they are reinforced through use.
788-
* [modelcontextprotocol/server-memory](https://github.com/modelcontextprotocol/server-memory) (TypeScript) - A knowledge graph-based persistent memory system for AI.
789-
790712
## Related Work
791713

792714
- [Model Context Protocol](https://github.com/modelcontextprotocol) - MCP specification
793715
- [Ebbinghaus Forgetting Curve](https://en.wikipedia.org/wiki/Forgetting_curve) - Cognitive science foundation
794-
- Research inspired by: Memoripy, Titan MCP, MemoryBank
716+
- Research inspired by: mem0, Better Memory, Neo4j Graph Memory
795717

796718
## Citation
797719

‎cortexgraph_log.png‎

-12.8 KB
Binary file not shown.

‎cortexgraph_logo.png‎

-12.8 KB
Binary file not shown.

‎cortexgraph_logo.svg‎

Lines changed: 0 additions & 56 deletions
This file was deleted.

0 commit comments

Comments
 (0)