EdgeCLI Documentation

AI-powered CLI tool for intelligent log analysis and incident triage using Google Gemini API.

Installation

Requirements

• Node.js >= 18.0.0
• npm or yarn package manager
• Google Gemini API key (Get one here)
• ElevenLabs API key (optional, for voice alerts)

Install from npm

Install EdgeCLI globally with a single command:

npm install -g @ceasermikes/edgecli

That's it! No cloning, no setup - just install and go.

Getting Started

Step 1: Initial Setup

Run the interactive setup wizard to configure your API keys:

edgecli init

The wizard will guide you through:

• Entering your Gemini API key (securely)
• Selecting a Gemini model
• Optionally configuring ElevenLabs voice alerts
• Choosing a voice and severity threshold

Step 2: Test the Installation

Run the simulation mode to verify everything works:

edgecli simulate

Step 3: Start Monitoring

Watch a log file or pipe output from your application:

# Watch a log file
edgecli watch app.log

# Watch live output
npm run dev 2>&1 | edgecli watch --stdin

Language Support

EdgeCLI is language-agnostic - it works with ANY programming language!

Supported Languages

Beyond Application Code

EdgeCLI also works with:

Real-World Examples

$ python manage.py runserver 2>&1 | edgecli watch --stdin --voice

# Django outputs:
django.db.utils.OperationalError: FATAL: password authentication failed

# EdgeCLI triages:
SEVERITY: CRITICAL
Hypothesis: PostgreSQL authentication failure
Root Cause: Database password mismatch in settings.py
Suggested Fix: Update DATABASES configuration

$ ./mvnw spring-boot:run 2>&1 | edgecli watch --stdin --voice

# Spring outputs:
NoSuchBeanDefinitionException: No qualifying bean of type 'UserService'

# EdgeCLI triages:
SEVERITY: HIGH
Hypothesis: Spring dependency injection failure
Root Cause: Missing @Service annotation
Suggested Fix: Add @Service to UserService class

$ go run main.go 2>&1 | edgecli watch --stdin --voice

# Go outputs:
panic: runtime error: nil pointer dereference

# EdgeCLI triages:
SEVERITY: CRITICAL
Hypothesis: Nil pointer dereference
Root Cause: Variable not initialized before use
Suggested Fix: Check for nil before dereferencing

Commands

edgecli init

# Watch a file
edgecli watch app.log

# Watch stdin
npm run dev 2>&1 | edgecli watch --stdin

# Enable voice alerts
edgecli watch app.log --voice

# Disable voice alerts
edgecli watch app.log --no-voice

edgecli suggest --file src/auth.js

edgecli simulate

edgecli stats

# Interactive configuration
edgecli voice

# Quick enable/disable
edgecli voice --enable
edgecli voice --disable

# Test voice output
edgecli voice --test

edgecli uninstall

Features

Two-Stage Triage System

EdgeCLI uses a sophisticated two-stage approach to incident analysis:

Severity Levels

Voice Alerts

Professional AI voice notifications powered by ElevenLabs.

Voice Models

Available Voices

Choose from 30+ professional voices with various accents and styles:

Severity Thresholds

Control which alerts trigger voice notifications:

• Info and above: All alerts (development/learning)
• Warning and above ⭐: Recommended for production
• Error and above: High-traffic systems
• Critical only: Mission-critical systems

Configuration

Configuration File Location

EdgeCLI stores configuration in your system's config directory:

• macOS: ~/Library/Preferences/edgecli-nodejs/
• Linux: ~/.config/edgecli-nodejs/
• Windows: %APPDATA%\edgecli-nodejs\Config\

Configuration Structure

{
  "apiKey": "your-gemini-api-key",
  "model": "gemini-2.5-flash",
  "elevenlabs": {
    "apiKey": "your-elevenlabs-api-key",
    "enabled": true,
    "model": "eleven_multilingual_v2",
    "voiceId": "JBFqnCBsd6RMkjVDRZzb",
    "severityThreshold": "warning",
    "streaming": true
  }
}

Environment Variables

Override configuration with environment variables:

# Linux/macOS
export GEMINI_API_KEY="your-gemini-key"
export ELEVENLABS_API_KEY="your-elevenlabs-key"

# Windows PowerShell
$env:GEMINI_API_KEY="your-gemini-key"
$env:ELEVENLABS_API_KEY="your-elevenlabs-key"

Available Gemini Models

• gemini-2.5-flash ⭐ (Recommended) - Latest flash model, fast and efficient
• gemini-2.5-pro - Most capable 2.5 model for complex analysis
• gemini-2.0-flash - Stable 2.0 flash model
• gemini-3-flash - Next-gen flash model
• gemini-3-pro - Next-gen pro model with maximum capability

Examples

Basic Log Monitoring

# Watch a log file
edgecli watch /var/log/app.log

# Watch with voice alerts
edgecli watch /var/log/app.log --voice

Development Workflow

# Monitor your dev server
npm run dev 2>&1 | edgecli watch --stdin --voice

# Monitor tests
npm test 2>&1 | edgecli watch --stdin

Production Monitoring

# Monitor production logs with critical-only alerts
edgecli voice
# Set threshold to "Critical only"

edgecli watch /var/log/production.log --voice

CI/CD Integration

# In your CI pipeline
npm run build 2>&1 | edgecli watch --stdin --no-voice

# Generate patch suggestions
edgecli suggest --file src/problematic-file.js

Troubleshooting

No Audio from Voice Alerts

API Key Issues

edgecli init

export GEMINI_API_KEY="your-key"

Model Errors

edgecli init
# Select gemini-2.5-flash (recommended)

Windows Audio Issues

API Reference

Triage Result Structure

{
  "severity": "MEDIUM" | "LOW" | "HIGH" | "CRITICAL",
  "hypothesis": "Description of the issue",
  "confidence": 0.90,  // 0-1 scale
  "needs_deeper": false
}

Deep Analysis Result Structure

{
  "root_cause": "Detailed explanation",
  "affected_files": ["file1.js", "file2.js"],
  "patch": "--- a/file.js\n+++ b/file.js\n..."
}

Session Statistics

{
  "duration": "21s",
  "total_triages": 1,
  "severity_breakdown": {
    "low": 0,
    "medium": 1,
    "high": 0,
    "critical": 0
  },
  "deep_analyses": 1,
  "time_saved": "~0 minutes"
}

Exit Codes

Uninstall

Complete Removal

EdgeCLI provides a single command to completely remove everything:

edgecli uninstall

This command will:

1. Show you exactly what will be removed
2. Display your current configuration
3. Ask for confirmation (twice for safety)
4. Remove all configuration files and data
5. Uninstall the EdgeCLI npm package

⚠️ This is a complete uninstall. After running this command, EdgeCLI will be completely removed from your system. You'll need to run npm install -g @ceasermikes/edgecli to use it again.

What Gets Removed

• Configuration file: Contains your Gemini and ElevenLabs API keys
• Voice settings: All voice alert preferences
• Session statistics: Historical usage data
• Configuration directory: The entire config folder
• npm package: The globally installed EdgeCLI package

Why One Command?

We designed edgecli uninstall to handle everything because:

• Convenience: No need to remember multiple commands
• Completeness: Ensures nothing is left behind
• Safety: Double confirmation prevents accidents
• Transparency: Shows exactly what will be removed before doing it

Reinstalling

To reinstall EdgeCLI after uninstalling:

# Install the package
npm install -g @ceasermikes/edgecli

# Run setup wizard
edgecli init