luna-agents-cli

🌙 Luna CLI — AI Agent Platform for the Full SDLC

Run 28+ specialized AI agents from your terminal — code review, testing, security audits, documentation, deployment, and more. Powered by LunaOS.

Quick Start

# Install globally
npm i -g @luna-agents/cli

# Initialize in your project
luna init

# Run your first agent
luna run code-review

Features

• 🤖 28+ AI Agents — specialists for every stage of the software development lifecycle
• 🔗 Agent Chains — multi-agent workflows (e.g., review → test → document)
• 📚 RAG Indexing — index your codebase for context-aware analysis
• 🌐 Multi-Provider — Anthropic, OpenAI, Google, DeepSeek, Groq, Mistral, and more
• ☁️ Cloud Mode — optional cloud execution via LunaOS API
• 🎨 Custom Agents — create your own agent personas

Commands

Command	Description
luna init	Initialize LunaOS in your project
luna list	List all available agents
luna run <agent>	Run an agent on your project
luna chain <preset>	Run a multi-agent chain
luna index	Index project for RAG context
luna config	View and manage configuration
luna keys	Manage API keys
luna create-agent	Scaffold a custom agent
luna status	Show project status

Agent Categories

Category	Agents
Code Quality	Code Review, Refactoring, Performance, Accessibility
Testing	Testing & Validation, Security Scanner, Load Testing
Documentation	Documentation, API Generator, Changelog
Deployment	Deployment, CI/CD Generator, Infrastructure
Design	Design Architect, UX Analyzer, Design System
Data	Database Architect, Data Pipeline, Migration
DevOps	Monitoring, Incident Response, Cost Optimizer
Planning	Requirements Analyzer, Sprint Planner, Tech Debt

Preset Chains

Run multi-agent pipelines with a single command:

luna chain full-review       # Code Review → Testing → Documentation
luna chain new-feature       # Requirements → Design → Planning → Execution
luna chain deploy            # Code Review → Testing → Deployment
luna chain security-audit    # Security Scan → Code Review
luna chain api-design        # API Generator → Database → Documentation

Configuration

# Set provider and model
luna config set provider openai
luna config set model gpt-4o

# Manage API keys
luna keys add anthropic
luna keys add openai
luna keys test anthropic

# Cloud mode
luna init --cloud            # Sign up / log in
luna run code-review --cloud # Run via cloud API

Config Locations

File	Scope	Purpose
~/.luna/config.yaml	Global	Default provider, model
.luna/config.yaml	Project	Project-specific overrides
~/.luna/credentials.yaml	Global	API keys (chmod 600)

Custom Agents

Create your own agent personas:

luna create-agent my-reviewer --category code-quality
luna create-agent security-scan --category security --global
luna run my-reviewer

Cloud Mode

Connect to LunaOS Cloud for:

• Remote agent execution (no local API key needed)
• Agent chains with SSE streaming
• RAG-enhanced analysis with cloud indexing

luna init --cloud
luna run code-review --cloud
luna chain full-review
luna index --cloud

Requirements

• Node.js ≥ 18.0.0
• npm ≥ 8
• An API key from any supported provider (or LunaOS Cloud account)

License

MIT © Shachar Solomon

Built with ❤️ by LunaOS