--- title: cli order: 4 description: Full command reference for the memory engine CLI. --- # cli The `me` command line interface provides full access to memory engine. Install it with: ```bash curl -fsSL https://install.memory.build | sh ``` ## commands ### me install Interactive setup wizard. Creates the install directory, provisions the database, configures embeddings, creates the admin user, and registers MCP tools. ```bash me install # quick mode (zero questions) me install -i # interactive mode (full wizard) me install -c me.yaml # config-driven mode me install /opt/me # custom install directory ``` ### me server Start the JSON-RPC server and embedding daemon. ```bash me server ``` The server listens on the host and port configured in `me.yaml` (default `127.0.0.1:2024`). The embedding daemon runs in the background, processing memories that don't yet have embeddings. ### me mcp Start the MCP server over stdio. This is typically called by your AI tool, not directly. ```bash me mcp ``` To install the MCP configuration for your tools: ```bash me mcp install ``` ### me login Authenticate with a remote memory engine server. ```bash me login ``` Prompts for server URL, identifier (username or email), and password. Stores credentials locally. ### me logout Clear stored credentials. ```bash me logout ``` ### me whoami Show the current authenticated principal. ```bash me whoami ``` ### me memory Manage memories (memories). #### create ```bash me memory create \ --content "The deployment uses blue-green strategy" \ --tree "eng.infra.deploy" \ --meta '{"type": "fact", "source": "runbook"}' ``` | Flag | Description | |------|-------------| | `--content` | The memory text (required) | | `--tree` | Hierarchical path for organization | | `--meta` | JSON metadata object | | `--temporal-start` | Start of temporal range (ISO 8601) | | `--temporal-end` | End of temporal range (ISO 8601) | #### get ```bash me memory get ``` #### update ```bash me memory update \ --content "Updated content" \ --meta '{"reviewed": true}' ``` #### delete Delete a single memory by ID, or all memories under a tree prefix: ```bash me memory delete # by UUID me memory delete pack.datasync --dry-run # preview count me memory delete pack.datasync -y # skip confirmation ``` | Flag | Description | |------|-------------| | `--dry-run` | Show count without deleting (tree mode) | | `-y, --yes` | Skip confirmation prompt (tree mode) | #### search ```bash me memory search --semantic "deployment strategy" me memory search --fulltext "blue-green deploy" me memory search --semantic "deployment" --fulltext "blue-green" --tree "eng.infra" ``` | Flag | Description | |------|-------------| | `--semantic` | Semantic search query (vector similarity) | | `--fulltext` | Full-text keyword search (BM25) | | `--tree` | Filter by tree path (supports wildcards) | | `--meta` | Filter by metadata (JSON containment) | | `--temporal-contains` | Filter to memories whose temporal range contains this date | | `--order-by` | Sort direction for filter-only searches: `asc` or `desc` (default: desc) | | `--limit` | Maximum results (default 10) | #### mv Move memories between tree paths: ```bash me memory mv --source "work.old_project" --destination "archive.old_project" ``` ### me principal Manage principals (users and agents). #### list ```bash me principal list ``` #### create ```bash me principal create alice --email alice@example.com --password secret me principal create indexer-bot # agent (no login) me principal create admin-user --admin # superuser ``` | Argument / Flag | Description | |-----------------|-------------| | `` | Principal name (positional, required) | | `--email` | Email address (optional, enables login) | | `--password` | Password (optional, enables login) | | `--admin` | Grant superuser privileges | #### get ```bash me principal get alice ``` #### delete ```bash me principal delete alice ``` #### rename ```bash me principal rename alice alice-new ``` #### set-password ```bash me principal set-password alice ``` Prompts interactively for the new password and confirmation. #### grants List grants for a principal, or all grants if no name is given. ```bash me principal grants alice me principal grants # all grants ``` #### check-access Check whether the current principal has access to a tree path. ```bash me principal check-access eng.backend read ``` | Argument | Description | |----------|-------------| | `` | Tree path to check (positional, required) | | `` | Action to check: `read`, `create`, `update`, or `delete` (positional, required) | #### grant Grant a principal access to a tree path. ```bash me principal grant alice eng.backend read create update ``` | Argument | Description | |----------|-------------| | `` | Principal name (positional, required) | | `` | Tree path (positional, required) | | `` | One or more of: `read`, `create`, `update`, `delete` | #### revoke Revoke a principal's grant on a tree path. ```bash me principal revoke alice eng.backend ``` ### me apikey Manage API keys. #### create ```bash me apikey create ci-bot me apikey create ci-bot --principal indexer-bot # create key for another principal ``` | Argument / Flag | Description | |-----------------|-------------| | `[name]` | Key name (positional, optional — defaults to "unnamed") | | `--principal` | Create the key for another principal (requires `createrole`) | #### list ```bash me apikey list ``` #### delete ```bash me apikey delete ``` ### me role Manage roles for grouping principals. #### create ```bash me role create engineers ``` #### delete ```bash me role delete engineers ``` #### list ```bash me role list ``` #### add-member ```bash me role add-member engineers alice ``` #### remove-member ```bash me role remove-member engineers alice ``` #### members List members of a role. ```bash me role members engineers ``` #### list-for List roles for a principal, or for the current principal if no name is given. ```bash me role list-for alice me role list-for # current principal ``` ### me owner Manage tree path ownership. #### set ```bash me owner set eng.backend alice ``` #### get ```bash me owner get eng.backend ``` #### remove ```bash me owner remove eng.backend ``` #### list ```bash me owner list me owner list --principal alice # filter by principal ``` ### me service Manage the system service (launchd on macOS, systemd on Linux). ```bash me service install # install and enable the service me service start # start the service me service stop # stop the service me service status # check service status ``` ### me config ```bash me config example # print a commented example me.yaml ``` ### me pack Manage memory packs — curated collections of memories. #### validate ```bash me pack validate packs/git-history.yaml ``` | Flag | Description | |------|-------------| | `--json` | Machine-readable JSON output | | `--yaml` | YAML output (multi-doc stream) | #### import ```bash me pack import packs/git-history.yaml ``` | Flag | Description | |------|-------------| | `--server ` | Server URL (overrides credentials) | | `--dry-run` | Preview without making changes | | `--json` | Machine-readable JSON output |