Installation

Install the Rust agent-memory CLI for hosted Agent Memory Labs. Managed users do not need Python, Neo4j, Docker, or a local database.

1. Install the CLI

Install once per machine. The binary name is agent-memory (not the legacy agentic-memory Python package).

Windows

irm https://agentmemorylabs.com/install.ps1 | iex
agent-memory --version

Installs to %LOCALAPPDATA%\Programs\agent-memory\bin and adds that directory to your user PATH.

macOS / Linux

curl -fsSL https://agentmemorylabs.com/install.sh | sh
agent-memory --version

Default install directory: ~/.local/bin (ensure it is on your PATH).

Pin a version

# Windows
$env:AM_CLI_VERSION = "0.2.0"
irm https://agentmemorylabs.com/install.ps1 | iex

# macOS / Linux
AM_CLI_VERSION=0.2.0 curl -fsSL https://agentmemorylabs.com/install.sh | sh

Manual download

If the one-liner is blocked or returns an error, download the zip for your platform from the manifest:

https://agentmemorylabs.com/downloads/cli/manifest.json

Extract the agent-memory binary and place it on your PATH.

Troubleshooting: If install.sh or install.ps1 returns HTTP 404, the CLI CDN may not be published yet. Use the manual manifest URL above, or contact support. Do not fall back to pipx install agentic-memory for hosted prod — that is the legacy Python path.

2. Log in

Create an API key at agentmemorylabs.com/account, then configure the hosted backend and authenticate:

export AM_HOSTED_BASE_URL=https://backend.agentmemorylabs.com
agent-memory login --api-key YOUR_ACCOUNT_API_KEY

On Windows PowerShell, use $env:AM_HOSTED_BASE_URL = "https://backend.agentmemorylabs.com" instead of export.

3. Index a repository

From the repository root:

agent-memory init --managed
agent-memory doctor
agent-memory index
agent-memory index-watch --job-id <job_id_from_index_output>
agent-memory search --query "where is auth handled?"

First success criterion: agent-memory doctor exits 0 with no fail checks.

4. Connect Cursor (MCP)

Frictionless default — OAuth over HTTP; no local stdio server or Neo4j environment variables:

{
  "mcpServers": {
    "agentic-memory": {
      "url": "https://mcp.agentmemorylabs.com/mcp"
    }
  }
}

See MCP Integration for ChatGPT, Codex, and advanced endpoints.

Operator and contributor paths

Contributors (build from source): cargo install --path crates/am-cli in a private repo checkout
Legacy Python / Neo4j self-hosted: historical instructions — not hosted production

Need a faster walkthrough? Start with the Quickstart guide.