Lua documentation

Lua is a hosted agent platform: write an agent in TypeScript, test it locally, and release it with the lua CLI to the channels your end users already use.

Build an agent
Build with Claude Code
Call an agent

npm install -g lua-cli
lua auth configure
mkdir my-agent && cd my-agent && lua init

/plugin marketplace add lua-ai-global/claude-code-lua-plugin
/plugin install lua-agent-builder@claude-code-lua-plugin

curl -X POST "https://api.heylua.ai/chat/generate/<<YOUR_AGENT_ID>>" \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"type":"text","text":"Hello"}]}'

New here → Quickstart · Building with a coding agent → Build with AI · Not a developer → For operators

Get started

Install, build one tool, and release it in ten minutes.

For operators

Run an agent from the admin dashboard, and know what needs an engineer.

Concepts

Understand agents, skills, tools, channels, releases, and the runtime.

Automation

Pick the right primitive: tool, webhook, job, trigger, or workflow.

Build

Add tools, webhooks, jobs, workflows, knowledge, and MCP servers.

Channels

Connect the web widget, WhatsApp, Slack, Teams, email, SMS, and voice.

Integrations

Connect SaaS tools through Unified.to and act on their events.

Devices

Give the agent hardware to command and that can wake it.

Ship and operate

Test, release, roll back, automate, and read logs.

Security and data

How credentials, secrets, and production are protected, and what the platform keeps.

Marketplace

Publish or install agent templates and skills.

Examples

Five complete agents to copy into a project.

Build with AI

Give Claude Code or any coding agent context and guardrails.

Reference

Every SDK export, CLI command, and REST endpoint.

What’s new

2026-09-10, v3.33.0: per-device lua auth logout and lua auth sessions; agent template publishes update consenting installs; triggers can start workflows.
2026-09-05, Workflows: declared connection keys, goals from chat, and composing workflows from chat.
2026-09-02, v3.30.0: sends return a deliveryId and status; delivery events on every channel; idempotent retries.
2026-08-31, v3.29.1: email sign-in saves the user session; agent selection past 100 organizations.