memaxdocs
Getting Started

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-cli
pnpm add -g memax-cli
yarn global add memax-cli
bun add -g memax-cli

Verify the installation:

memax --version

Authenticate

memax login

This 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.md

Memax 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-code

This 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:

  1. Open your agent (e.g., Claude Code)
  2. Ask a question about something you pushed — e.g., "What does the README say about setup?"
  3. 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.