Package Exports

lua-cli
lua-cli/skill
lua-cli/types

Readme

Lua CLI

A command-line interface for the Lua AI platform that helps you manage agents, organizations, and skills with ease.

Installation

npm install -g lua-cli

Usage

After installation, you can use the lua command:

lua --help

Features

🔐 Secure Authentication: Support for both API key and email-based OTP authentication
🏢 Organization Management: Select and manage multiple organizations
🤖 Agent Management: Choose from available agents within your organizations
🛠️ Skill Development: Initialize new Lua skills with proper configuration
🔑 API Key Management: Securely store, view, and manage your API keys
📦 Template System: Quick project setup with pre-configured templates

Quick Start

Configure your authentication:
```
lua configure
```
Choose between API key or email authentication methods.
Initialize a new skill project:
```
lua init
```
Select your organization and agent, then provide skill details.
View your API key:
```
lua apiKey
```
List your agents:
```
lua agents
```
Delete your stored credentials:
```
lua destroy
```

Commands

`lua configure`

Set up your authentication credentials. You can choose between:

API Key: Direct API key input
Email: Email-based OTP authentication

lua configure

`lua init`

Initialize a new Lua skill project in the current directory.

lua init

This command will:

Fetch your organizations and agents from the API
Let you select an organization by name
Let you choose an agent from the selected organization
Prompt for skill name and description
Create a lua.skill.toml configuration file
Copy template files to the current directory

`lua apiKey`

Display your stored API key (with confirmation prompt).

lua apiKey

`lua agents`

Fetch and display your agents from the HeyLua API.

lua agents

`lua destroy`

Delete your stored API key and credentials.

lua destroy

Configuration File

The lua.skill.toml file is created when you run lua init:

[agent]
agentId = "your-agent-id"
orgId = "your-organization-id"

[skill]
name = "Your Skill Name"
description = "Description of your skill"

Authentication Methods

API Key Authentication

Run lua configure
Select "API Key"
Enter your API key when prompted
The key is validated and stored securely

Email Authentication

Run lua configure
Select "Email"
Enter your email address
Check your email for the OTP code
Enter the 6-digit OTP code
An API key is automatically generated and stored

Security

All API keys are stored securely using your system's credential manager
Email authentication uses OTP (One-Time Password) for secure verification
Confirmation prompts prevent accidental exposure of sensitive information
No credentials are stored in plain text

Requirements

Node.js 16.0.0 or higher
Valid Lua AI platform account

Development

To contribute to this project:

Clone the repository
Install dependencies: npm install
Build the project: npm run build
Make your changes
Test your changes
Submit a pull request

License

MIT License - see LICENSE file for details.

Support

For support and questions:

Create an issue on GitHub
Contact: stefan@heylua.ai

Changelog

1.1.0

Major Refactoring: Complete codebase reorganization into modular structure
Email Authentication: Added OTP-based email authentication
API Key Display: New lua apiKey command
TypeScript Types: Comprehensive type definitions
Improved Architecture: Separated commands, services, and utilities

1.0.0

Initial release
API key authentication
Organization and agent management
Skill project initialization
Secure credential storage