Quickstart

Install the CLI

npm install -g memax-cli

pnpm add -g memax-cli

yarn global add memax-cli

bun add -g memax-cli

Verify:

memax --version

Sign in

memax login

Opens your browser for OAuth (GitHub or Google). After approval the CLI stores credentials under ~/.memax/.

Confirm with:

memax whoami

Save your first memory

memax push -f ./README.md

Or from inline / stdin:

memax push "We chose Postgres for strong consistency"
cat notes.md | memax push --stdin --title "Team standup notes"

The server classifies, summarizes, and chunks the content for retrieval. New memories start in processing state and become active within a few seconds.

Connect an agent

memax setup configures MCP, hooks, and agent instructions on your machine in one command:

memax setup --all

This detects installed agents (Claude Code, Cursor, Codex, etc.) and configures MCP + hooks for each. Limit to specific agents with --only claude-code,cursor.

For hand-rolled setups see the integrations guides.

Try it

memax recall "what did we decide about Postgres?"

From inside your agent, ask a related question — the agent should surface the relevant context via MCP or the hook.