Skip to main content

CLI Overview

The MEMANTO CLI is your command-line interface for all memory operations, agent management, and workflow automation.

Installation

pip install memanto
Verify:
memanto --version

Core Concept

memanto [COMMAND] [SUBCOMMAND] [OPTIONS]

Command Groups

MEMANTO CLI is organized into these command groups:
GroupPurposeExamples
CoreBasic operationsstatus, serve, ui
agentAgent managementagent create, agent activate
memoryMemory operationsremember, recall, answer
sessionSession managementsession info, session extend
scheduleAutomationschedule enable, schedule disable
configConfigurationconfig show
connectIDE integrationconnect claude-code, connect cursor

Core Commands

memanto

Interactive setup and first-run configuration:
memanto
Prompts for Moorcheh API key and optional settings.

memanto status

View current configuration, active agent, and system health:
memanto status
Output:
Moorcheh API Key:    ✓ Configured (mk_****)
Moorcheh Connection: ✓ Connected
Configuration Path:  ~/.memanto/config.json
Active Agent:        customer-support
Active Session:      session_abc123
Session Expires:     2025-03-31 22:30:00 UTC

memanto serve

Start the local MEMANTO API server:
memanto serve [OPTIONS]
Options:
  • --host TEXT - Server host (default: 0.0.0.0)
  • --port INTEGER - Server port (default: 8000)
  • --reload - Auto-reload on code changes (development)
Example:
memanto serve --port 8001 --reload

memanto ui

Start the web dashboard:
memanto ui
Opens interactive dashboard in your browser at http://localhost:3000 (or similar).

Agent Commands

memanto agent [SUBCOMMAND]
Subcommands:
  • create NAME - Create a new agent
  • list - List all agents
  • activate NAME - Start a session
  • deactivate - End current session
  • bootstrap NAME - View agent metadata
Example:
memanto agent create customer-support
memanto agent activate customer-support
memanto agent list
See Agent Commands for details.

Memory Commands

memanto [COMMAND]
Top-level commands:
  • remember TEXT - Store a memory
  • recall TEXT - Retrieve memories
  • answer TEXT - Get AI-powered answer
  • daily-summary - Generate daily summary
  • conflicts - Detect contradictions
Example:
memanto remember "Paris is the capital of France" --type fact
memanto recall "What's the capital of France?"
memanto answer "Where is the capital of France?"
See Memory Commands for details.

Session Commands

memanto session [SUBCOMMAND]
Subcommands:
  • info - Check current session status
  • extend - Extend session duration
Example:
memanto session info
memanto session extend --hours 6
See Session Commands for details.

Schedule Commands

memanto schedule [SUBCOMMAND]
Subcommands:
  • enable - Enable daily summaries
  • disable - Disable daily summaries
  • status - Check schedule status
Example:
memanto schedule enable
memanto schedule status
See Schedule Commands for details.

Config Commands

memanto config [SUBCOMMAND]
Subcommands:
  • show - Display current configuration
Example:
memanto config show
See Config Commands for details.

Connect Commands

memanto connect [SUBCOMMAND]
Connect MEMANTO to external tools: Tools:
  • claude-code - Claude Code extension
  • codex - Codex IDE
  • cursor - Cursor IDE
  • windsurf - Windsurf IDE
  • cline - Cline extension
  • continue - Continue extension
  • goose - Goose IDE
  • roo - Roo IDE
  • github-copilot - GitHub Copilot
  • gemini-cli - Gemini CLI
  • opencode - OpenCode
  • antigravity - Antigravity IDE
  • augment - Augment IDE
Example:
memanto connect claude-code
memanto connect cursor --global
memanto connect list
See Connect Commands for details.

Memory File Commands

memanto memory [SUBCOMMAND]
Subcommands:
  • export - Export memories to file
  • sync - Sync memories to MEMORY.md
Example:
memanto memory export
memanto memory export --format json
memanto memory sync

Global Options

All commands support:
  • --help - Show command help
  • --version - Show MEMANTO version
Example:
memanto remember --help
memanto --version

Common Workflows

First-Time Setup

# 1. Configure
memanto

# 2. Create agent
memanto agent create my-agent

# 3. Activate session
memanto agent activate my-agent

# 4. Start storing memories
memanto remember "My first memory" --type fact

Daily Use

# Check status
memanto status

# Store memory
memanto remember "Update from meeting" --type event

# Recall information
memanto recall "What happened in meeting?"

# Get AI answer
memanto answer "Based on memories, what should we do next?"

Scheduled Operations

# Enable daily summaries at 8 AM
memanto schedule enable
# Choose time: 08:00

# Check schedule
memanto schedule status

# View daily summary
memanto daily-summary

# Check for conflicts
memanto conflicts

Server & Dashboard

# Terminal 1: Start API server
memanto serve

# Terminal 2: Open web dashboard
memanto ui

# Access at http://localhost:3000

IDE Integration

# Connect to Claude Code
memanto connect claude-code

# Connect to Cursor
memanto connect cursor

# List all connections
memanto connect list

# Remove integration
memanto connect remove claude-code

Tips & Tricks

Pipe to jq for JSON Output

# Export memories to JSON and process
memanto memory export --format json | jq '.memories | length'

Batch Operations

# Create memories from file
memanto remember --batch batch.json

# Export and backup
memanto memory export > backup_$(date +%Y-%m-%d).md

Combine Commands

# Create, activate, and store in sequence
memanto agent create mybot && \
memanto agent activate mybot && \
memanto remember "Agent activated" --type event

Check Help Anytime

# Top-level help
memanto --help

# Group help
memanto agent --help

# Command help
memanto remember --help

Troubleshooting

Command Not Found

# Reinstall
pip install --upgrade memanto

# Check installation
which memanto

API Key Issues

# Reconfigure
memanto

# Check configuration
memanto config show

Session Expired

# Extend current session
memanto session extend --hours 6

# Or create new session
memanto agent activate {agent_id}

Next Steps


The CLI is the fastest way to work with MEMANTO. Master these commands and you’ll be productive immediately!