@lanonasis/repl-cli

LZero Concierge - Intelligent REPL for LanOnasis Memory Service with natural language AI orchestration, command history, tab completion, multi-line input, and health monitoring.

✨ Features

🎯 Core Intelligence

• 🧠 Natural Language Interface - Talk naturally to your memory system
• 🤖 LZero AI Orchestration - Vendor-abstracted AI with automatic fallback (Primary → Backup → Local)
• 🔍 Enhanced Semantic Search - AI-powered search with main answer + additional context
• 💾 Full Memory Operations - Create, search, list, get, and delete memories
• ✨ Prompt Optimization - Refine prompts for better AI results
• 🎯 Model Configuration - User-configurable AI model selection

🚀 Concierge Enhancements (v1.0.0)

• 📜 Command History - Navigate 1000 previous commands with ↑/↓ arrows
• ⌨️ Tab Completion - Auto-complete all commands and aliases
• 📖 Multi-line Input - Auto-detect unclosed quotes, braces, code blocks
• 🏥 Health Monitoring - Real-time AI endpoint health checks with lrepl health
• 🎨 Interactive Dashboard - Beautiful Ink-based TUI with keyboard navigation (optional)
• 🛡️ Vendor Abstraction - LZero-branded logging (no vendor names exposed)

🔧 Developer Experience

• 🔌 MCP Support - Model Context Protocol integration
• 🎨 Beautiful Output - Colored, formatted terminal experience
• ⚡ Fast & Lightweight - ~95 KB bundled
• 🔐 Multiple Auth Methods - OAuth 2.1, OTP/magic link, API keys, vendor keys
• 📝 Config Persistence - Settings saved between sessions
• 💬 Context Awareness - Maintains conversation history
• 📊 Enhanced Logging - Real-time LZero processing status with latency

📦 Installation

Global Installation (Recommended)

npm install -g @lanonasis/repl-cli

Local Installation

npm install @lanonasis/repl-cli

Verify Installation

onasis-repl --version
# or
lrepl --version

🚀 Quick Start

1. Login (First Time)

# Standard OAuth
lrepl login

# Passwordless OTP
lrepl login --otp

# Lonasis/Supabase
lrepl login --lonasis

2. Start REPL

# Classic REPL (default)
lrepl start

# With custom API
lrepl start --api https://api.lanonasis.com

# With AI Router override
lrepl start --ai-router https://ai.vortexcore.app

# With model selection
lrepl start --model gpt-4

3. Interact Naturally

💭 Remember that I prefer TypeScript over JavaScript
💭 What do I know about my API project?
💭 Show me my recent memories
💭 Find information about authentication
💭 Please refine this prompt: "Write a function"

4. Use Commands

💭 create Project Notes API architecture details...
💭 search authentication --type=project
💭 list 10
💭 get <memory-id>
💭 history
💭 help

🎮 Keyboard Shortcuts

| Key | Action | |-----|--------| | ↑ / ↓ | Navigate command history (1000 commands) | | Tab | Auto-complete commands | | Enter | Submit command | | Ctrl+C | Cancel input / Exit REPL |

Multi-line Input

Leave these open to continue on next line:

• Quotes: "text or 'text
• Braces: {code
• Brackets: [text
• Code blocks: ```
• Backslash: text\

📋 Command Reference

Main Commands

lrepl start              # Launch REPL session
lrepl login              # Authenticate with OAuth
lrepl login --otp        # Passwordless OTP login
lrepl logout             # Clear credentials
lrepl auth-status        # Show auth status (alias: whoami)
lrepl config             # Show configuration
lrepl health             # Check AI endpoint health
lrepl --version          # Show version

REPL Internal Commands

Memory Operations:

• create <title> <content> - Create a memory
• update <id> [--content=...] - Update a memory
• search <query> [--type=<type>] - Search memories
• list [limit] - List recent memories
• get <id> - Get specific memory
• delete <id> - Delete a memory

System Commands:

• nl [on|off] - Toggle natural language mode
• reset - Clear conversation history
• mode <remote|local> - Switch operation mode
• status - Show current status
• clear - Clear screen
• history [search] - Show command history
• help, ?, h - Show help
• exit, quit, q - Exit REPL

🏥 Health Monitoring

Check AI endpoint health and fallback status:

lrepl health

Output:

- Checking AI endpoints...
✔ Health check complete: 2/3 healthy

LZero Primary:    ✓ Healthy   (45ms)
LZero Backup:     ✓ Healthy   (120ms)
Local Pattern:    ✓ Available

Status: All systems operational

🔍 Logging & Validation

Real-time Logging

# Capture session logs
lrepl start 2>&1 | tee session.log

# Watch for LZero processing
grep "\[LZero\]" session.log

Log Output:

[LZero] Processing request...
[LZero] ✓ Processed (145ms)

OR (backup active):
[LZero] Using enhanced mode (5000ms)
  → Switching to backup intelligence...
[LZero] Backup intelligence active

Analyze Logs

# Count primary vs backup usage
echo "Primary: $(grep -c '\[LZero\] ✓ Processed' session.log)"
echo "Backup: $(grep -c 'Backup' session.log)"

🛡️ Vendor Abstraction

Per organization blueprint, all AI routing is handled by LZero:

• Users see "LZero" branding (not vendor names)
• Fallback shown as "backup intelligence"
• Vendor isolation maintained
• No vendor identifiers in logs

🔐 Authentication

OAuth 2.1 (Recommended)

lrepl login

Passwordless OTP

lrepl login --otp

Lonasis/Supabase

lrepl login --lonasis

Check Status

lrepl auth-status
# or
lrepl whoami

Logout

lrepl logout
lrepl logout --revoke  # Revoke on server first

⚙️ Configuration

Config File

Location: ~/.lanonasis/repl-config.json

{
  "apiUrl": "https://api.lanonasis.com",
  "aiRouterUrl": "https://ai.vortexcore.app",
  "useMCP": false,
  "maxHistorySize": 1000,
  "nlMode": true
}

Environment Variables

# Authentication
export LANONASIS_API_KEY="your-key"
export MEMORY_API_KEY="your-key"

# AI Configuration
export AI_ROUTER_API_KEY="lano_xxx"
export AI_ROUTER_URL="https://ai.vortexcore.app"
export OPENAI_API_KEY="sk-xxx"
export OPENAI_MODEL="gpt-4o-mini"

# Debug Logging
export DEBUG=lanonasis:*
export LOG_LEVEL=debug

📊 AI Fallback Flow

User Query
    ↓
LZero Primary (ai.vortexcore.app) ← Default
    ↓ ✗ Failed?
LZero Backup (api.openai.com) ← Automatic fallback
    ↓ ✗ Failed?
Local Pattern Matching ← Final fallback

Validation: See AI_ROUTER_VALIDATION.md and QUICK_REFERENCE.md

📚 Documentation

| File | Description | |------|-------------| | CLI_COMMANDS.md | Complete command reference | | AI_ROUTER_VALIDATION.md | AI endpoint validation guide | | QUICK_REFERENCE.md | Fast lookup card | | CHANGELOG.md | Version history |

🧪 Testing

npm test

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests: npm test
5. Submit a PR

📝 License

MIT © Lanonasis Team

🔗 Links

• NPM Package
• Documentation
• Issues
• Monorepo