Robo Cortex
by robotel-limitedcommunityv0.4.1
1
A local, git-aware memory system for coding agents that stores lessons and decisions in SQLite and flags memories as stale when linked code changes. It exposes CLI, Python SDK, and MCP tools for recording, retrieving, searching, attaching evidence, and changing memory status.
From the registry: Git-aware memory store for AI coding agents; memories are anchored to git blob hashes.
Install & configure
Prerequisites
- requiredInstall robo-cortex with MCP supportInstall the Python package with the MCP extra so the MCP server entrypoint is available.
https://pypi.org/project/robo-cortex/$ pip install 'robo-cortex[mcp]' - requiredInitialize and commit a git repositoryrobo-cortex requires a git repository with at least one commit for git-aware staleness detection and repo-scoped retrieval.
$ git init && git add -A && git commit -m "initial commit"
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `robo-cortex` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install robo-cortex with MCP support** — Install the Python package with the MCP extra so the MCP server entrypoint is available. Run: `pip install 'robo-cortex[mcp]'` (https://pypi.org/project/robo-cortex/)
- **Initialize and commit a git repository** — robo-cortex requires a git repository with at least one commit for git-aware staleness detection and repo-scoped retrieval. Run: `git init && git add -A && git commit -m "initial commit"`
Canonical MCP server config (stdio transport):
- command: `roco`
- args: ["mcp","--repo","<path-to-project>"]
- optional environment variables:
- `ROBO_CORTEX_NO_GLOBAL`: Set to disable the global store entirely so CLI and MCP only use the current repository store. (example: `1`)
- `ROBO_CORTEX_GLOBAL_DB`: Override the path to the global SQLite database used for shared/global memories. Use a local filesystem path only; do not use a network mount. (example: `<path-to-global.db>`)
- `ROBO_CORTEX_GITEA_URL`: Configure Gitea evidence verification. Without this, robo-cortex operates fully offline with no network calls. (example: `<your-gitea-url>`)
Note: The README’s MCP example uses the stdio server launched via the `roco` CLI. `robo-cortex` is an equivalent command alias if `roco` is unavailable or conflicts with another installed package.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README’s MCP example uses the stdio server launched via the `roco` CLI. `robo-cortex` is an equivalent command alias if `roco` is unavailable or conflicts with another installed package.
Tools (8)
retrieve_context
Retrieve relevant memories for a task/context
record_memory
Record a new memory or lesson
search_memory
Search memories by query
attach_evidence
Attach evidence to a memory
verify_evidence
Verify attached evidence
change_status
Change a memory's status
get_memory
Get a specific memory by id
list_affected
List memories affected by code changes
Prerequisites
- • python3
Packages
robo-cortex
pypiv0.4.1transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- Jul 15, 2026
- Last commit
- Aug 10, 2026
- Registry name
- io.github.robotel-limited/robo-cortex
Categories
Related Servers
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
32.3k
Gk Cli
The GitKraken MCP Server for managing repos, PRs, issues across GitHub, GitLab, Bitbucket and more.
446
Git Mcp Server
Comprehensive Git MCP server enabling native git tools including clone, commit, worktree, & more.
232