Build agents with real TypeScript.

Full control over your agent logic. Write TypeScript tools, test locally, deploy globally. No YAML configs, no vendor lock-in.

Get started

~/customer-support — lua

A modern developer experience.

Everything you expect from a modern framework. TypeScript, testing, live reload, and one-command deployments.

Real TypeScript.

Not YAML or JSON configs. Actual code with full IDE support.

tools/support-tools.ts

import { LuaTool, Data } from "lua-cli";

import { z } from "zod";

export class SearchKnowledgeBase implements LuaTool {

name = "search_knowledge_base";

description = "Search help articles";

inputSchema = z.object({

query: z.string().describe("User’s question"),

});

async execute(input: z.infer<typeof this.inputSchema>) {

const results = await Data.search(

"help_articles", input.query, 5, 0.7

);

return { articles: results, count: results.length };

}

Zod validation.

Schema validation built-in. Parameters are type-safe at runtime.

tools/create-ticket.ts

// Parameters are validated before execute() runs

inputSchema = z.object({

subject: z.string().describe("Ticket subject"),

description: z.string(),

priority: z.enum(["low", "normal", "high", "urgent"])

.default("normal"),

customerEmail: z.string().email(),

customerName: z.string(),

});

async execute(input: z.infer<typeof this.inputSchema>) {

const key = env("ZENDESK_API_KEY");

// input is fully typed here

…

}

Test interactively.

Run any tool with real inputs from the CLI, then chat with the agent in a sandbox — before anything ships.

One-command deploy.

Push to production with a single command. We handle the rest.

A small set of primitives. A whole agent.

Skills, tools, jobs, webhooks, MCP servers, and message processors — every piece is a typed class, and every agent ships with the platform APIs built in.

LuaSkill

Group tools with the context that steers them.

new LuaSkill({ name, context, tools })

LuaTool

A typed capability — schema in, work out.

class CheckOrder implements LuaTool { … }

LuaJob

Scheduled work. No conversation required.

schedule: { type: "cron", expression: "0 9 * * *" }

LuaWebhook

HTTP endpoints your agent reacts to.

new LuaWebhook({ name, execute })

LuaMcpServer

Mount MCP servers as native tools.

new LuaMcpServer({ … })

PreProcessor / PostProcessor

Shape every message on the way in and out.

new PreProcessor({ priority, execute })

Batteries included — platform APIs on every agent:

DataUserAIProductsOrdersBasketsCDNVoiceTemplatesenv()

await Data.search("movies", "mind-bending thriller", 10, 0.7)

Write the tool once. Ship it everywhere.

Channels are the front doors to your agent. Connect one and the rest are configuration, not code.

Instagram

Messenger

Slack

Web widget

HTTP API

SMS · Teams · Discord · Telegram — coming soon

Start from a working agent.

Open examples you can clone, edit, and deploy — support desks to WhatsApp OTP flows.

lua-customer-support

Zendesk ticketing over a vector-searched help center.

lua-shopping-assistant

Catalog, baskets, and checkout on the commerce APIs.

lua-hotel-agent

Bookings, upsells, and concierge flows.

lua-whatsapp-flow-otp

WhatsApp Flows with OTP verification.

lua-financial-services

Balances, transfers, and account servicing.

lua-real-estate

Listing search and viewing scheduling.

lua-employee-onboarding

HR onboarding with documents and checklists.

lua-auto-proposal-generation

Drafts proposals from pipeline context.

lua-discord-moderator

Community moderation on autopilot.

Start building today.

Comprehensive documentation, examples, and community support to help you ship faster.

docs/getting-started.md

Quickstart guide.

Get from zero to your first deployed agent in minutes.

docs/api-reference.md

API reference.

Complete reference for all Lua CLI tools and methods.

Ready to start building?

Get from zero to your first deployed agent in under 5 minutes.

Start building

lua chat

$lua init my-agent

$lua chat

You:What's the weather in SF?

Agent:Let me check that for you...

→ get_weather(city: "SF")

Agent:It's 68°F and sunny in San Francisco!