Quickstart
Get Memax running in under two minutes. Install the CLI, push your first memory, and connect an agent.
This guide gets you from zero to a working Memax setup in under two minutes.
Install the CLI
npm install -g memax-clipnpm add -g memax-cliyarn global add memax-clibun add -g memax-cliVerify the installation:
memax --versionAuthenticate
memax loginThis opens your browser for OAuth authentication (GitHub or Google). After approval, the CLI stores your credentials locally.
Push your first memory
memax push --file ./README.mdMemax indexes your content, classifies it into a category, assigns appropriate boundaries, and chunks it semantically for retrieval.
✓ Saved — "Project README" (core · private) [48ms]Connect an agent
The fastest integration is MCP (Model Context Protocol), supported by Claude Code, Cursor, and others:
memax setup claude-codeThis configures the MCP server so your agent can call memax_recall and memax_push directly. No code changes needed.
What's next?
Learn about memories and hubs, explore the full CLI reference, or set up more agent integrations.
Verify it works
After connecting an agent, test the integration:
- Open your agent (e.g., Claude Code)
- Ask a question about something you pushed — e.g., "What does the README say about setup?"
- The agent should recall the relevant context from Memax automatically
If the agent doesn't find context, check that memax recall "your query" returns results from the CLI.