Skip to main content

​
Core Commands

Core MEMANTO commands for setup, server management, and status checking.

​
memanto

Interactive first-run setup. Configures Moorcheh API key and optional settings. 
memanto
Interactive Prompts:
  1. Enter Moorcheh API key (starts with mk_)
  2. (Optional) Configure daily summary time
  3. Saves to ~/.memanto/config.json
Output: 
✓ API key configured
✓ Configuration saved to ~/.memanto/config.json

​
memanto status

Display current system status, configuration, and active sessions. 
memanto status
Output: 
═══════════════════════════════════════════════════════
MEMANTO Status
═══════════════════════════════════════════════════════

Moorcheh API Key:      ✓ Configured (mk_****)
Moorcheh Connection:   ✓ Connected
Configuration Path:    ~/.memanto/config.json

Active Agent:          customer-support
Active Session:        session_abc123xyz
Session Token:         eyJhbGc... (truncated)
Session Expires:       2025-03-31 22:30:00 UTC

Time Until Expiry:     5h 47m
Use Cases:
  • Verify API key is valid
  • Check active agent
  • Monitor session expiry
  • Troubleshoot connection issues

​
memanto serve

Start the local MEMANTO API server. Exposes REST endpoints for programmatic access. 
memanto serve [OPTIONS]
Options:
OptionDefaultDescription
--host TEXT0.0.0.0Server host address
--port INTEGER8000Server port
--reloadfalseAuto-reload on code changes
Examples: Start on default port: 
memanto serve
Start on custom port: 
memanto serve --port 8001
Start with auto-reload (development): 
memanto serve --reload
Specify host and port: 
memanto serve --host 127.0.0.1 --port 9000
Output: 
INFO:     Uvicorn running on http://0.0.0.0:8000
INFO:     Application startup complete
API Documentation: Once server is running: Health Check: 
curl http://localhost:8000/health
Use Cases:
  • Run MEMANTO as a service
  • Programmatic access via REST API
  • Integration with external applications
  • Development and testing

​
memanto ui

Launch the interactive web dashboard. Provides UI for managing agents, memories, and sessions. 
memanto ui [OPTIONS]
Options:
OptionDefaultDescription
--host TEXT0.0.0.0Server host address
--port INTEGER3000Dashboard port
Examples: Launch dashboard on default port: 
memanto ui
Launch on custom port: 
memanto ui --port 8080
Output: 
✓ Dashboard started at http://localhost:3000
✓ Opening browser...
Automatically opens browser to dashboard. Dashboard Features:
  • View all agents
  • Create and view agents
  • Manage sessions
  • Store memories (UI form)
  • Search/recall memories
  • View memory statistics
  • Monitor daily summaries
  • View conflicts
Use Cases:
  • Visual memory management
  • Agent monitoring
  • Non-technical team members
  • Quick testing
Note: Server must be running (memanto serve) for dashboard to function.

​
Workflow: Setup to Use

Complete workflow from installation to first memory: 
# 1. First-time configuration
memanto

# 2. In terminal 1: Start API server
memanto serve

# 3. In terminal 2: Open dashboard
memanto ui
# Or just use CLI...

# 4. Create agent
memanto agent create my-bot

# 5. Activate session
memanto agent activate my-bot

# 6. Verify status
memanto status

# 7. Store memory
memanto remember "Hello World" --type fact

​
Troubleshooting

​
”API key not found"

memanto  # Reconfigure API key

​
"Connection refused” to Moorcheh

# Check internet connection
# Check API key validity
# Check Moorcheh status: https://status.moorcheh.ai

​
”Port already in use"

# Use different port
memanto serve --port 8001
memanto ui --port 8080

​
"Dashboard won’t open”

# Server not running?
memanto serve  # Run server first

# Manual URL
# Open browser to http://localhost:3000

​
Next Steps