Persistent memory and context for AI agents — from the terminal.
---
Memax is the shared memory layer for you and your AI agents. Push knowledge once — notes, files, URLs, chat transcripts — and recall it from any agent, any session, any device. Ask grounded questions and get answers with citations from your own memory base.
`memax-cli` is the command-line entry point. It ships the `memax` binary for terminal workflows and a local MCP server so Claude Code, Cursor, Codex, and any other MCP-aware agent can read and write your memory directly.
## Install
```bash
npm install -g memax-cli
```
Or run once without installing:
```bash
npx memax-cli recall "jwt session rotation policy"
```
## Quick start
```bash
# One-time: log in via browser
memax login
# Remember something
memax push "Never block on a live migration — always do online + backfill."
# Recall with natural language
memax recall "migration guidelines"
# Ask a grounded question — answer includes citations
memax ask "How do we handle breaking schema changes?"
# Wire up your IDE agent (writes an MCP entry to the right config file)
memax setup
```
## What it does
- **`memax push`** — save a thought, file, URL, or piped stdin
- **`memax recall`** — natural-language search across personal + team knowledge
- **`memax ask`** — AI-synthesized answer grounded in your memory, with citations
- **`memax list` / `show` / `delete`** — browse and manage entries
- **`memax hub`** — create, invite, and switch between team hubs
- **`memax topic`** — inspect auto-generated topic clusters
- **`memax dreams`** — view the ingestion/organization pipeline status
- **`memax agents sync`** — device-aware sync of agent configs and session artifacts
- **`memax import `** — one-way ingest of a directory into memory
- **`memax mcp serve`** — start a local MCP server for agent integration
- **`memax setup`** — detect installed agents and wire up MCP + hooks
- **`memax hook`** — Claude Code hook for automatic context injection
Run `memax --help` or `memax --help` for the full surface.
## Agent integration
Memax is built agent-first. Three integration paths:
1. **MCP (recommended for IDE agents)** — `memax setup` writes the right MCP server entry for Claude Code, Cursor, Codex, or Windsurf. The agent can then call `memax_recall`, `memax_push`, `memax_ask`, and friends directly.
2. **Claude Code hooks** — automatic context injection before each prompt (`memax hook`). Latency budget is under 500ms; context is injected as `` blocks.
3. **Direct CLI piping** — works with any agent and in CI. `memax recall … | your-agent`.
## Configuration
The CLI reads from `~/.memax/config.json` after first login. For CI and non-interactive use:
```bash
export MEMAX_API_KEY="mk_live_..." # from memax.app → Settings → API Keys
export MEMAX_API_URL="https://api.memax.app" # default
```
## Links
- **Product** — [memax.app](https://memax.app)
- **Docs** — [docs.memax.app](https://docs.memax.app)
- **SDK** — [`memax-sdk`](https://www.npmjs.com/package/memax-sdk)
## License
Apache 2.0 — see [LICENSE](./LICENSE) and [NOTICE](./NOTICE).