CLI Overview

lua [options] [command]

-V, --version   # Output the version number
-h, --help      # Display help for command

# Authentication & Setup
lua auth configure      # 🔑 Set up your API key
lua init               # 🚀 Initialize a new project

# Configuration (Interactive or Direct)
lua env                # ⚙️ Manage environment variables
lua env sandbox        # 🎯 Direct: manage sandbox .env file
lua env production     # 🎯 Direct: manage production env vars
lua persona            # 🤖 Manage agent persona
lua persona sandbox    # 🎯 Direct: edit sandbox persona
lua persona production # 🎯 Direct: deploy persona version
lua features           # ⚡ Manage agent capabilities (tickets, RAG, etc.)
lua resources          # 📚 Manage knowledge base
lua marketplace        # 🛒 Access skills marketplace

# Development
lua skills             # 🔧 View and manage skills
lua skills sandbox     # 🎯 Direct: view local skills
lua skills production  # 🎯 Direct: manage production skills
lua compile            # 📦 Compile your skills
lua sync               # 🔄 Check for drift between server and local
lua test               # 🧪 Test tools interactively
lua chat               # 💬 Start interactive chat

# Deployment (Interactive or Direct)
lua push               # ☁️ Push to server (choose component)
lua push skill         # 🎯 Direct: push skill
lua push persona       # 🎯 Direct: push persona
lua push mcp           # 🎯 Direct: push MCP server
lua push all --force   # 🎯 Push all components
lua deploy             # 🚀 Deploy to production

# Integration & Debugging
lua mcp                # 🔌 Manage MCP servers (list, activate, deactivate)
lua channels           # 🔌 Manage communication channels
lua logs               # 🐛 View and filter execution logs (interactive filtering)

# Utilities
lua completion bash    # ⌨️ Generate bash autocomplete
lua completion zsh     # ⌨️ Generate zsh autocomplete
lua completion fish    # ⌨️ Generate fish autocomplete
lua admin              # 🛠️ Open admin dashboard
lua evals              # 📊 Open evaluations dashboard
lua docs               # 📖 Open documentation

# Edit the tool
vim src/tools/MyTool.ts

# Test the tool
lua test

# Test conversationally
lua chat

# Push and deploy (direct mode - faster!)
lua push skill && lua deploy

--help       Show command help
--version    Show CLI version

// src/index.ts
import { LuaAgent, LuaSkill, LuaWebhook, LuaJob, LuaMCPServer } from "lua-cli";
import { mySkill } from "./skills/my-skill";
import paymentWebhook from "./webhooks/payment";
import dailyReportJob from "./jobs/daily-report";
import filesystemServer from "./mcp/filesystem";

// Export agent (v3.0.0 pattern)
export const agent = new LuaAgent({
  name: "my-agent",

  // Define personality and behavior
  persona: `You are a helpful assistant for Acme Corp.
  
Your role:
- Help customers with orders and support
- Answer product questions
- Process payments

Communication style:
- Professional yet friendly
- Clear and concise
- Patient and understanding`,

  // Skills with tools
  skills: [mySkill],

  // HTTP endpoints (optional)
  webhooks: [paymentWebhook],

  // Scheduled tasks (optional)
  jobs: [dailyReportJob],

  // MCP servers for external tools (optional)
  mcpServers: [filesystemServer],
});

my-agent/
├── src/
│   ├── index.ts              # Agent configuration (LuaAgent)
│   ├── skills/               # Skill definitions
│   │   └── my-skill.ts
│   ├── tools/                # Tool implementations
│   │   ├── OrderLookupTool.ts
│   │   └── CreateTicketTool.ts
│   ├── webhooks/             # Webhook handlers (v3.0.0)
│   │   └── payment.ts
│   ├── jobs/                 # Scheduled jobs (v3.0.0)
│   │   └── daily-report.ts
│   ├── mcp/                  # MCP server configurations
│   │   └── filesystem.ts
│   ├── preprocessors/        # Message filters (v3.0.0)
│   │   └── profanity-filter.ts
│   └── postprocessors/       # Response formatters (v3.0.0)
│       └── add-disclaimer.ts
├── lua.skill.yaml            # Auto-synced configuration
├── package.json
├── tsconfig.json
└── .env                      # Local environment variables

# Agent configuration
agent:
  agentId: agent_abc123
  orgId: org_xyz789

# Multi-skill support
skills:
  - name: my-skill
    version: 1.0.0
    skillId: skill_abc123 # Auto-created

# Webhooks (v3.0.0)
webhooks:
  - name: payment-webhook
    webhookId: webhook_abc123 # Auto-created

# Jobs (v3.0.0)
jobs:
  - name: daily-report
    jobId: job_abc123 # Auto-created (version tracked on server)

# MCP Servers
mcpServers:
  - name: filesystem
    mcpServerId: mcp_abc123 # Auto-created