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

npm install -g memax-cli

Or run once without installing:

npx memax-cli recall "jwt session rotation policy"

Quick start

# 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 <dir> — 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 <command> --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 <memax-context> 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:

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
• Docs — docs.memax.app
• SDK — memax-sdk

License

Apache 2.0 — see LICENSE and NOTICE.