# Neurobase

> Neurobase is an open-source, local-first memory layer that captures, curates, and recalls durable context across Claude Code and Codex CLI.

Neurobase records useful coding-agent session context with deterministic local hooks, folds it into a small current fact set, synthesizes a wikilinked Markdown wiki, and recalls relevant memory in later sessions. Its recommender mines recurring cross-agent patterns and proposes reusable SKILL.md, AGENTS.md, or CLAUDE.md instructions for human review.

Current status: 0.1.0 release candidate. The working implementation is in GitHub; the first public Git tag, GitHub Release, and PyPI publication are still pending.

## Start Here

- [Neurobase home](https://neurobase.dev/)
- [For AI agents](https://neurobase.dev/for-agents)
- [GitHub repository](https://github.com/rebelscum216/neurobase)
- [README](https://github.com/rebelscum216/neurobase/blob/main/README.md)
- [How Neurobase works](https://github.com/rebelscum216/neurobase/blob/main/docs/how-it-works.md)
- [Architecture](https://github.com/rebelscum216/neurobase/blob/main/docs/architecture.md)
- [Adapter guide](https://github.com/rebelscum216/neurobase/blob/main/docs/adapter-guide.md)
- [Security](https://github.com/rebelscum216/neurobase/blob/main/SECURITY.md)
- [Changelog](https://github.com/rebelscum216/neurobase/blob/main/CHANGELOG.md)

## Articles

- [All articles](https://neurobase.dev/articles)
- [Machine-readable article catalog](https://neurobase.dev/articles.json)
- [RSS feed](https://neurobase.dev/feed.xml)
- [JSON Feed](https://neurobase.dev/feed.json)

Each article also has a clean Markdown version at its canonical URL plus `.md`.

## Core Concepts

- Local-first storage
- Cross-agent memory
- Deterministic capture hooks
- LLM-based curation that supersedes and removes stale facts
- Wikilinked Markdown synthesis
- Automatic recall at session start
- On-demand recall over MCP
- Human-reviewed skill and rule recommendations

## Installation

Until the first public package release:

```bash
git clone https://github.com/rebelscum216/neurobase.git
cd neurobase
uv tool install .
neurobase init --user
neurobase doctor
```

## Optional

- [Expanded Neurobase corpus for agents](https://neurobase.dev/llms-full.txt)