lua-cli 3.5.0-alpha.3 → 3.5.0-beta.1

package/README.md

@@ -1,32 +1,31 @@
-# Lua CLI
+# lua-cli
 
 > Build, test, and deploy AI agents with custom tools, webhooks, and scheduled jobs
 
 [![npm version](https://img.shields.io/npm/v/lua-cli.svg)](https://www.npmjs.com/package/lua-cli)
-[![License](https://img.shields.io/npm/l/lua-cli.svg)](https://github.com/heylua/lua-cli/blob/main/LICENSE)
+[![License](https://img.shields.io/npm/l/lua-cli.svg)](https://github.com/lua-ai-global/lua-cli/blob/main/LICENSE)
 
-**Lua CLI** is a command-line interface for building intelligent AI agents on the Lua AI platform. Create custom tools, integrate with external APIs, schedule automated tasks, and deploy to production—all from your terminal.
+**lua-cli** is the official command-line tool for building intelligent AI agents on the Lua platform. Create custom tools, integrate with external APIs, schedule automated tasks, and deploy to production—all from your terminal.
 
 ---
 
-## ✨ Features
+## Features
 
 - 🤖 **LuaAgent** - Unified agent configuration with persona, skills, webhooks, and jobs
-- 🛒 **Marketplace** - Publish and install verified skills from the community
 - 🛠️ **Custom Tools** - Build TypeScript tools with full type safety and Zod validation
 - 🪝 **Webhooks** - HTTP endpoints for external integrations (Stripe, Shopify, etc.)
 - ⏰ **Scheduled Jobs** - Cron-based and one-time background tasks
 - 📥 **Preprocessors** - Filter and route messages before they reach your agent
 - 📤 **Postprocessors** - Transform and format agent responses
 - 💬 **Streaming Chat** - Real-time chat interface with typing indicators
-- 🧪 **Local Testing** - Test tools, webhooks, and jobs before deploying
+- 🧪 **Local Testing** - Test tools, webhooks, and jobs in sandbox before deploying
 - 🚀 **Batch Deployment** - Push all components with one command
-- 🔄 **Auto-Sync** - YAML and code stay synchronized automatically
+- 🛒 **Marketplace** - Publish and install verified skills from the community
 - 🌐 **CI/CD Ready** - Environment variable support for automated deployments
 
 ---
 
-## 📦 Installation
+## Installation
 
 ### Global Installation (Recommended)
 
@@ -34,12 +33,6 @@
 npm install -g lua-cli
 ```
 
-### Project Installation
-
-```bash
-npm install lua-cli
-```
-
 ### Verify Installation
 
 ```bash
@@ -48,7 +41,7 @@ lua --version
 
 ---
 
-## 🚀 Quick Start
+## Quick Start
 
 ### 1. Authenticate
 
@@ -56,48 +49,60 @@ lua --version
 lua auth configure
 ```
 
-Enter your API key when prompted (get one at https://admin.heylua.ai).
+Enter your API key when prompted (get one at [admin.heylua.ai](https://admin.heylua.ai)).
 
 ### 2. Initialize Project
 
 ```bash
-mkdir my-agent
-cd my-agent
+mkdir my-agent && cd my-agent
 lua init
 ```
 
-Follow the prompts to:
-- Select or create an agent
-- Configure persona and welcome message
-- Set up your project
+Follow the prompts to configure your agent.
 
-### 3. Test Your Agent
+### 3. Create a Tool
 
-```bash
-# Test individual tools
-lua test
+Create `src/skills/tools/WeatherTool.ts`:
 
-# Chat with your agent
-lua chat
+```typescript
+import { LuaTool } from 'lua-cli/skill';
+import { z } from 'zod';
+
+export default class WeatherTool implements LuaTool {
+  name = 'get_weather';
+  description = 'Get current weather for any city';
+
+  inputSchema = z.object({
+    city: z.string()
+  });
+
+  async execute(input: z.infer<typeof this.inputSchema>) {
+    return { temperature: 72, condition: 'sunny' };
+  }
+}
 ```
 
-### 4. Deploy to Production
+### 4. Test Locally
 
 ```bash
-# Interactive deployment
-lua push
+lua test      # Test individual tools
+lua chat      # Interactive chat with your agent
+```
+
+### 5. Deploy to Production
 
-# Or batch deployment
+```bash
+lua compile
 lua push all --force --auto-deploy
 ```
 
----
+Your agent is now live! 🎉
 
-## 🎯 Core Concepts
+---
 
-### LuaAgent
+## Core Concepts
 
-The unified configuration for your AI agent:
+### LuaAgent - Unified Configuration
 
 ```typescript
 import { LuaAgent, LuaSkill, LuaWebhook, LuaJob } from 'lua-cli';
@@ -105,617 +110,145 @@ import { LuaAgent, LuaSkill, LuaWebhook, LuaJob } from 'lua-cli';
 export const agent = new LuaAgent({
   name: 'my-assistant',
   persona: 'You are a helpful AI assistant...',
-  
   skills: [customerSupportSkill, productSkill],
   webhooks: [paymentWebhook],
-  jobs: [dailyReportJob],
-  preProcessors: [messageFilter],
-  postProcessors: [responseFormatter]
+  jobs: [dailyReportJob]
 });
 ```
 
-### Skills
-
-Group related tools together:
+### Skills - Tool Collections
 
 ```typescript
 import { LuaSkill } from 'lua-cli';
 
-const weatherSkill = new LuaSkill({
+export default new LuaSkill({
   name: 'weather-skill',
   description: 'Weather information tools',
-  context: 'Use these tools to get weather data for any location',
-  tools: [
-    new GetWeatherTool(),
-    new GetForecastTool()
-  ]
-});
-```
-
-### Tools
-
-Individual functions your agent can use:
-
-```typescript
-import { LuaTool } from 'lua-cli/skill';
-import { z } from 'zod';
-
-export default class GetWeatherTool implements LuaTool {
-  name = 'get_weather';
-  description = 'Get current weather for a city';
-  
-  inputSchema = z.object({
-    city: z.string()
-  });
-  
-  async execute(input: z.infer<typeof this.inputSchema>) {
-    // Your logic here
-    return { temperature: 72, condition: 'sunny' };
-  }
-}
-```
-
-### Webhooks
-
-Receive HTTP requests from external systems:
-
-```typescript
-import { LuaWebhook } from 'lua-cli';
-import { z } from 'zod';
-
-export default new LuaWebhook({
-  name: 'payment-webhook',
-  description: 'Handle payment notifications',
-  
-  bodySchema: z.object({
-    orderId: z.string(),
-    amount: z.number(),
-    status: z.string()
-  }),
-  
-  execute: async ({ body, headers, query }) => {
-    // Process payment event
-    return {
-      status: 200,
-      body: { received: true }
-    };
-  }
-});
-```
-
-### Jobs
-
-Schedule automated tasks:
-
-```typescript
-import { LuaJob } from 'lua-cli';
-
-export default new LuaJob({
-  name: 'daily-cleanup',
-  description: 'Clean up old data daily',
-  
-  schedule: {
-    type: 'cron',
-    pattern: '0 0 * * *'  // Midnight every day
-  },
-  
-  execute: async (job) => {
-    // Cleanup logic
-    return { success: true, deleted: 42 };
-  }
+  tools: [new GetWeatherTool(), new GetForecastTool()]
 });
 ```
 
----
-
-## 📚 Available APIs
+### Runtime APIs
 
-Access powerful APIs in your tools and jobs:
+Access powerful APIs in your tools:
 
-### User API
 ```typescript
-import { User } from 'lua-cli';
+import { User, Products, Data, Orders } from 'lua-cli';
 
+// User data
 const user = await User.get();
-await user.update({ preferences: 'dark-mode' });
 await user.send([{ type: 'text', text: 'Hello!' }]);
-```
-
-### Products API
-```typescript
-import { Products } from 'lua-cli';
 
+// Products
 const products = await Products.get();
-const product = await Products.create({ name: 'Widget', price: 29.99 });
-await product.update({ price: 24.99 });
-await product.delete();
-```
+await Products.create({ name: 'Widget', price: 29.99 });
 
-### Baskets API
-```typescript
-import { Baskets } from 'lua-cli';
-
-const basket = await Baskets.create();
-await basket.addItem({ productId: '123', quantity: 2 });
-await basket.placeOrder();
-```
-
-### Orders API
-```typescript
-import { Orders } from 'lua-cli';
-
-const orders = await Orders.get();
-await Orders.updateStatus('confirmed', orderId);
-```
-
-### Custom Data API
-```typescript
-import { Data } from 'lua-cli';
-
-const movies = await Data.get('movies');
-await Data.create('movies', { title: 'Inception', year: 2010 });
-const results = await Data.search('movies', 'action thriller');
-```
-
-### Jobs API
-```typescript
-import { Jobs } from 'lua-cli';
-
-const job = await Jobs.create({
-  name: 'remind-user',
-  metadata: { message: 'Meeting in 1 hour' },
-  schedule: {
-    type: 'once',
-    executeAt: new Date(Date.now() + 3600000)
-  },
-  execute: async (job) => {
-    const user = await job.user();
-    await user.send([{ type: 'text', text: job.metadata.message }]);
-    return { success: true };
-  }
-});
+// Custom data storage
+await Data.create('notes', { text: 'Hello' });
+const results = await Data.search('notes', 'query');
 ```
 
 ---
 
-## 🛠️ CLI Commands
-
-### Project Setup
+## Key Commands
 
 ```bash
-lua auth configure          # Set up API key
+# Project Setup
 lua init                    # Initialize new project
-```
-
-### Marketplace
-
-```bash
-lua marketplace             # Access the skills marketplace (Creator & Installer)
-```
-
-### Development
-
-```bash
-lua compile                 # Compile TypeScript to deployable format
-lua test                    # Test tools/webhooks/jobs interactively
-lua chat                    # Interactive chat with your agent
-```
+lua compile                 # Compile TypeScript
 
-### Deployment
-
-```bash
-lua push                    # Push new version (interactive)
-lua push all --force        # Push all components without prompts
-lua deploy                  # Deploy version to production
-```
+# Development
+lua test                    # Test tools interactively
+lua chat                    # Chat with your agent
+lua dev                     # Dev server with live reload
 
-### Management
+# Deployment
+lua push                    # Push to server (interactive)
+lua push all --force        # Push all without prompts
+lua deploy                  # Deploy to production
 
-```bash
+# Management
 lua production              # View production status
 lua env                     # Manage environment variables
-lua persona                 # Update agent persona
-lua logs                    # View and filter agent logs (interactive)
-lua skills                  # Manage skills
-lua webhooks                # Manage webhooks
-lua jobs                    # Manage scheduled jobs
-lua integrations            # Connect third-party accounts (Linear, Discord, etc.)
+lua logs                    # View agent logs
+lua marketplace             # Browse and install skills
 ```
 
-### Utilities
-
-```bash
-lua admin                   # Open admin dashboard
-lua docs                    # Open documentation
-lua channels                # Manage chat channels
-```
-
----
-
-## 🔧 Advanced Features
-
-### Streaming Chat
-
-Real-time chat responses with typing indicators:
-
-```bash
-lua chat
-```
-
-- ✅ Animated typing indicator while waiting
-- ✅ Text streams character-by-character as AI generates
-- ✅ Custom welcome message from `lua.skill.yaml`
-- ✅ Sandbox and production environments
-
-### Batch Deployment
-
-Deploy all components at once:
-
-```bash
-# Push everything without prompts
-lua push all --force
-
-# Push and deploy to production
-lua push all --force --auto-deploy
-```
-
-Perfect for CI/CD pipelines:
-- ✅ Auto-bumps patch versions
-- ✅ No user interaction required
-- ✅ Handles all component types
-- ✅ Comprehensive error handling
-
-### API Key Fallback
-
-Flexible authentication for different environments:
-
-**Priority:**
-1. System keychain (macOS Keychain, Windows Credential Vault, Linux libsecret)
-2. `LUA_API_KEY` environment variable
-3. `LUA_API_KEY` in `.env` file
-
-```bash
-# CI/CD usage
-export LUA_API_KEY=your-api-key
-lua push all --force --auto-deploy
-```
-
-### Auto-Sync Configuration
-
-Your `lua.skill.yaml` and `LuaAgent` stay synchronized:
-
-- Run `lua init` → Syncs agent metadata to both YAML and code
-- Run `lua compile` → Syncs LuaAgent changes back to YAML
-- Edit either file → Changes propagate automatically
+[**→ Full CLI Reference**](docs/CLI_REFERENCE.md)
 
 ---
 
-## 📖 Example Tool
+## Documentation
 
-```typescript
-import { LuaTool, User } from 'lua-cli/skill';
-import { z } from 'zod';
-import axios from 'axios';
-
-export default class WeatherTool implements LuaTool {
-  name = 'get_weather';
-  description = 'Get current weather for any city';
-  
-  inputSchema = z.object({
-    city: z.string().describe('City name'),
-    units: z.enum(['metric', 'imperial']).optional()
-  });
-  
-  outputSchema = z.object({
-    temperature: z.number(),
-    condition: z.string(),
-    city: z.string()
-  });
-
-  async execute(input: z.infer<typeof this.inputSchema>) {
-    const response = await axios.get('https://api.weather.com/current', {
-      params: {
-        city: input.city,
-        units: input.units || 'metric',
-        apiKey: process.env.WEATHER_API_KEY
-      }
-    });
-    
-    return {
-      temperature: response.data.temp,
-      condition: response.data.condition,
-      city: input.city
-    };
-  }
-}
-```
-
----
-
-## 🏗️ Project Structure
-
-```
-your-project/
-├── src/
-│   ├── index.ts              # LuaAgent configuration
-│   ├── skills/               # Tool collections
-│   │   ├── tools/           # Individual tools
-│   │   └── *.skill.ts       # Skill definitions
-│   ├── webhooks/            # HTTP endpoints
-│   ├── jobs/                # Scheduled tasks
-│   ├── preprocessors/       # Message filters
-│   ├── postprocessors/      # Response formatters
-│   └── services/            # Shared utilities
-├── lua.skill.yaml           # Agent metadata
-├── .env                     # Environment variables
-├── package.json
-└── tsconfig.json
-```
-
----
-
-## 🔐 Security
-
-### API Keys
-
-- ✅ Stored securely in system keychain
-- ✅ Never committed to version control
-- ✅ Environment variable fallback for CI/CD
-- ✅ Per-environment configuration
-
-### Webhooks
-
-- ✅ Signature validation support
-- ✅ Request body validation with Zod
-- ✅ HTTPS endpoints only
-- ✅ Rate limiting ready
-
-### User Data
-
-- ✅ Encrypted at rest
-- ✅ Scoped to authenticated users
-- ✅ GDPR-compliant deletion
-- ✅ Privacy-first design
-
----
-
-## 🧪 Testing
-
-### Test Individual Components
-
-```bash
-# Test a tool
-lua test
-# Select: Tool → get_weather
-# Input: { city: "London" }
-# Output: { temperature: 15, condition: "cloudy" }
-
-# Test a webhook
-lua test
-# Select: Webhook → payment-webhook
-# Input body, headers, query
-# See response
-
-# Test a job
-lua test
-# Select: Job → daily-cleanup
-# Execute immediately
-# See results
-```
-
-### Interactive Chat Testing
+### Getting Started
+- [**Getting Started Guide**](docs/GETTING_STARTED.md) - Complete step-by-step tutorial
+- [**CLI Reference**](docs/CLI_REFERENCE.md) - All available commands
+- [**API Reference**](docs/API_REFERENCE.md) - Platform API overview
 
-```bash
-lua chat
-# Select environment: Sandbox or Production
-# Chat with your agent
-# See tools in action
-```
+### API Documentation
+- [LuaAgent](docs/api/LuaAgent.md) - Agent configuration
+- [LuaSkill](docs/api/LuaSkill.md) - Tool collections
+- [LuaTool](docs/api/LuaTool.md) - Creating tools
+- [LuaWebhook](docs/api/LuaWebhook.md) - HTTP endpoints
+- [LuaJob](docs/api/LuaJob.md) - Scheduled tasks
+- [User API](docs/api/User.md) - User data management
+- [Products API](docs/api/Products.md) - Product catalog
+- [Data API](docs/api/Data.md) - Custom data storage
+- [Jobs API](docs/api/Jobs.md) - Dynamic job creation
+- [AI API](docs/api/AI.md) - AI text generation
+
+[**→ Complete API Documentation**](docs/README.md)
 
 ---
 
-## 🚀 Deployment
-
-### Development Workflow
-
-```bash
-# 1. Make changes to your code
-vim src/skills/tools/MyTool.ts
-
-# 2. Test locally
-lua test
-
-# 3. Test with chat
-lua chat  # Sandbox mode
-
-# 4. Compile
-lua compile
-
-# 5. Push to server
-lua push
-
-# 6. Deploy to production
-lua deploy
-```
+## CI/CD Integration
 
-### CI/CD Workflow
+Perfect for automated deployments:
 
 ```yaml
 # .github/workflows/deploy.yml
 - name: Deploy Agent
-  run: lua push all --force --auto-deploy
+  run: lua push all --ci --force --auto-deploy
   env:
     LUA_API_KEY: ${{ secrets.LUA_API_KEY }}
 ```
 
----
-
-## 📝 Configuration
-
-### lua.skill.yaml
-
-Central configuration file:
-
-```yaml
-agent:
-  agentId: your-agent-id
-  orgId: your-org-id
-
-skills:
-  - name: general-skill
-    version: 1.0.0
-    skillId: skill-id-123
-
-webhooks:
-  - name: payment-webhook
-    version: 1.0.0
-    webhookId: webhook-id-456
-
-jobs:
-  - name: daily-cleanup
-    version: 1.0.0
-    jobId: job-id-789
-```
-
-State-only: YAML tracks names, IDs, and server versions. Persona, env vars, and schedules live in code (for sandbox) or on the server (for production).
-
-### Environment Variables
-
-```.env
-# Lua Platform
-LUA_API_KEY=your-lua-api-key    # Optional: for CI/CD
-
-# External Services
-OPENAI_API_KEY=sk-...
-STRIPE_SECRET_KEY=sk_live_...
-PINECONE_API_KEY=...
-
-# Custom Configuration
-BASE_URL=https://api.example.com
-```
-
----
-
-## 🎓 Documentation
-
-### Getting Started
-- **[Quick Start Guide](template/QUICKSTART.md)** - Complete step-by-step tutorial
-- **[Template README](template/README.md)** - Comprehensive project guide
-- **[CLI Reference](#cli-commands)** - All available commands
-
-### API Documentation
-- **[Complete API Reference](docs/README.md)** - Full API documentation
-- **[API Index](docs/API_INDEX.md)** - Quick reference table
-- **Core APIs:**
-  - [LuaAgent](docs/api/LuaAgent.md) - Agent configuration
-  - [LuaSkill](docs/api/LuaSkill.md) - Tool collections
-  - [LuaTool](docs/api/LuaTool.md) - Creating tools
-- **Runtime APIs:**
-  - [AI API](docs/api/AI.md) - AI text generation and analysis
-  - [User API](docs/api/User.md) - User data management
-  - [Products API](docs/api/Products.md) - Product catalog
-  - [Data API](docs/api/Data.md) - Custom data storage
-  - [Jobs API](docs/api/Jobs.md) - Dynamic job creation
-
-### Advanced Topics
-- [Webhooks & Jobs Guide](WEBHOOKS_JOBS_USAGE_GUIDE.md) - External integrations
-- [Processors Guide](PROCESSORS_GUIDE.md) - Message processing
-- [Dynamic Jobs](DYNAMIC_JOB_CREATION_API.md) - Creating jobs programmatically
-- [Agent Configuration](LUAAGENT_IMPLEMENTATION.md) - LuaAgent deep dive
-
-### Examples
-- [Template Project](template/) - Full working example with 30+ tools
-- [Example Skills](template/src/skills/) - Organized skill examples
-- [Example Webhooks](template/src/webhooks/) - Webhook patterns
-- [Example Jobs](template/src/jobs/) - Scheduled task examples
+**Global `--ci` flag**: Fails loudly on missing required flags instead of silently canceling in non-TTY environments.
 
 ---
 
-## 💻 Development
-
-### Prerequisites
-
-- Node.js 16+
-- npm or yarn
-- TypeScript 5+
-
-### Building from Source
-
-```bash
-# Clone repository
-git clone https://github.com/heylua/lua-cli.git
-cd lua-cli
+## Example: E-commerce Agent
 
-# Install dependencies
-npm install
-
-# Build
-npm run build
-
-# Link globally
-npm link
+```typescript
+import { LuaAgent, LuaSkill } from 'lua-cli';
+import { Products, Baskets, Orders } from 'lua-cli';
 
-# Run tests
-npm test
-```
+const productSkill = new LuaSkill({
+  name: 'product-skill',
+  description: 'Product browsing and search',
+  tools: [new SearchProductsTool(), new GetProductTool()]
+});
 
-### Project Scripts
+const orderSkill = new LuaSkill({
+  name: 'order-skill',
+  description: 'Order management',
+  tools: [new PlaceOrderTool(), new TrackOrderTool()]
+});
 
-```bash
-npm run build          # Compile TypeScript
-npm run build:react    # Build web interface
-npm run clean          # Clean dist folder
-npm test               # Run test suite
+export const agent = new LuaAgent({
+  name: 'ecommerce-assistant',
+  persona: 'You are an e-commerce assistant helping customers browse products and place orders.',
+  skills: [productSkill, orderSkill],
+  webhooks: [orderWebhook],
+  jobs: [inventoryCheckJob]
+});
 ```
 
 ---
 
-## 🌟 What's New in v3.0.0
-
-### Major Features
-
-#### LuaAgent - Unified Configuration
-- ✅ Single source of truth for all agent components
-- ✅ Cleaner, more intuitive API
-- ✅ Automatic sync with `lua.skill.yaml`
-
-#### Streaming Chat Interface
-- ✅ Real-time text streaming as AI generates responses
-- ✅ Animated typing indicators
-- ✅ Custom welcome messages from YAML
-- ✅ Improved user experience
-
-#### Batch Deployment
-- ✅ `lua push all --force` - Deploy everything at once
-- ✅ Auto-bump patch versions
-- ✅ `--auto-deploy` flag for production
-- ✅ Perfect for CI/CD pipelines
-
-#### Enhanced Bundling
-- ✅ Optimized bundle sizes (excludes lua-cli internals)
-- ✅ Better import resolution
-- ✅ Faster compilation
-- ✅ Reduced deployment size
-
-#### Improved Authentication
-- ✅ Multi-source API key loading
-- ✅ Environment variable support
-- ✅ `.env` file fallback
-- ✅ CI/CD friendly
-
-### Breaking Changes from v2.x
-
-- **LuaAgent required** - Use `new LuaAgent()` instead of exporting individual skills
-- **Streaming endpoints** - Chat uses `/chat/stream` instead of `/chat/generate`
-- **Jobs.create signature** - Metadata field recommended for passing data
-
-See [CHANGELOG.md](CHANGELOG.md) for complete list of changes.
-
----
+## Contributing
 
-## 🤝 Contributing
-
-We welcome contributions! Please see our contributing guidelines:
+We welcome contributions!
 
 1. Fork the repository
 2. Create a feature branch
@@ -726,140 +259,55 @@ We welcome contributions! Please see our contributing guidelines:
 ### Development Setup
 
 ```bash
-git clone https://github.com/heylua/lua-cli.git
+git clone https://github.com/lua-ai-global/lua-cli.git
 cd lua-cli
 npm install
 npm run build
 npm link
+npm test
 ```
 
 ---
 
-## 📊 Use Cases
+## Architecture
 
-### Customer Support
-- Handle product queries
-- Process returns and refunds
-- Escalate complex issues
-- Track support tickets
+lua-cli is part of a distributed platform:
 
-### E-commerce
-- Product recommendations
-- Shopping cart management
-- Order processing
-- Payment integration
+- **lua-cli** - Developer tool (this repo)
+- **lua-api** - API gateway
+- **lua-agents** - Business logic service (CRUD, MongoDB)
+- **lua-core** - Agent runtime (Mastra, VM sandbox, streaming)
+- **lua-auth** - Authentication service
 
-### Data Analysis
-- Query databases
-- Generate reports
-- Visualize data
-- Schedule analytics jobs
-
-### Automation
-- Scheduled reminders
-- Data synchronization
-- Health monitoring
-- Batch processing
+[**→ Architecture Details**](CLAUDE.md)
 
 ---
 
-## 🆘 Support
-
-### Getting Help
-
-- **Documentation:** https://docs.heylua.ai
-- **Email:** support@heylua.ai
-- **GitHub Issues:** https://github.com/heylua/lua-cli/issues
-- **Community:** https://community.heylua.ai
-
-### Common Issues
-
-**Q: How do I get an API key?**
-Visit https://admin.heylua.ai and create an account.
-
-**Q: Can I use this in production?**
-Yes! v3.0.0 is production-ready with comprehensive testing and error handling.
+## Support
 
-**Q: How do I update to the latest version?**
-```bash
-npm install -g lua-cli@latest
-```
-
-**Q: Does this work with TypeScript?**
-Yes! Full TypeScript support with type definitions included.
-
-**Q: Can I deploy from CI/CD?**
-Yes! Use environment variables and `lua push all --force --auto-deploy`.
+- **Documentation**: [docs.heylua.ai](https://docs.heylua.ai)
+- **Email**: support@heylua.ai
+- **GitHub Issues**: [github.com/lua-ai-global/lua-cli/issues](https://github.com/lua-ai-global/lua-cli/issues)
+- **Admin Dashboard**: [admin.heylua.ai](https://admin.heylua.ai)
 
 ---
 
-## 📜 License
+## License
 
 MIT License - see [LICENSE](LICENSE) file for details.
 
 ---
 
-## 🙏 Acknowledgments
-
-Built with:
-- [TypeScript](https://www.typescriptlang.org/)
-- [Zod](https://zod.dev/) - Schema validation
-- [esbuild](https://esbuild.github.io/) - Fast bundling
-- [Commander.js](https://github.com/tj/commander.js/) - CLI framework
-- [Inquirer](https://github.com/SBoudrias/Inquirer.js/) - Interactive prompts
-
----
-
-## 🔗 Links
+## Links
 
-- **Website:** https://heylua.ai
-- **Documentation:** https://docs.heylua.ai
-- **Admin Dashboard:** https://admin.heylua.ai
-- **npm Package:** https://www.npmjs.com/package/lua-cli
-- **GitHub:** https://github.com/heylua/lua-cli
-
----
-
-## 📈 Roadmap
-
-### Coming Soon
-- 🔄 Real-time collaboration tools
-- 📊 Built-in analytics dashboard
-- 🎨 Visual skill builder
-- 🔌 More integration templates
-- 📱 Mobile SDK
-
-### In Progress
-- ✅ Enhanced error reporting
-- ✅ Performance optimizations
-- ✅ More example templates
-- ✅ Improved documentation
-
----
-
-## 💬 Community
-
-Join the Lua community:
-
-- **Discord:** Coming soon
-- **Twitter:** @heylua_ai
-- **Blog:** https://heylua.ai/blog
-
-Share your agents, get help, and learn from others!
+- **Website**: [heylua.ai](https://heylua.ai)
+- **Documentation**: [docs.heylua.ai](https://docs.heylua.ai)
+- **npm Package**: [npmjs.com/package/lua-cli](https://www.npmjs.com/package/lua-cli)
+- **GitHub**: [github.com/lua-ai-global/lua-cli](https://github.com/lua-ai-global/lua-cli)
 
 ---
 
 *Made with ❤️ by the Lua team*
 
-**Version:** 3.0.0  
-**Last Updated:** October 2025
-
----
-
-## Quick Links
-
-- [Quick Start →](template/QUICKSTART.md)
-- [API Documentation →](API_REFERENCE.md)
-- [Template Examples →](template/)
-- [Changelog →](CHANGELOG.md)
-
+**Version:** 3.5.0-alpha.3
+**Last Updated:** February 2026