Documentation Index
Fetch the complete documentation index at: https://docs.heylua.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
lua marketplace is the CLI surface for the Lua skill marketplace. It has two role modes:
- Creator — publish and manage your own skills for others to install.
- Installer — search the marketplace and install skills into your agent.
Running lua marketplace with no arguments prompts you to pick a role.
lua marketplace # Interactive: pick role
lua marketplace create # Creator menu
lua marketplace install # Installer menu
Creator Mode
For publishing and managing your own marketplace listings.
Actions
| Action | What it does |
|---|
list | Create a marketplace listing for one of your skills. |
publish | Publish a specific version to the marketplace. |
update | Update listing metadata (display name, description). |
unlist | Hide the listing — no new installs, but existing installers keep working. |
unpublish | Remove a specific version from the marketplace. |
view | View your listed skills. |
Creator Options
| Option | Description |
|---|
--skill-name <name> | Skill name (for list). |
--display-name <name> | Display name shown in the marketplace (for list/update). |
--marketplace-id <id> | Marketplace skill ID (returned after list). |
--version-id <id> | Version ID (for publish/unpublish). |
--changelog <text> | Changelog text shown to installers (for publish). |
--env-vars-json <json> | JSON describing required env vars (for publish). |
--force | Skip confirmation prompts. |
--json | Output as JSON (for view). |
Creator Examples
# Interactive creator menu
lua marketplace create
# View my listed skills
lua marketplace create view
lua marketplace create view --json | jq
# Create a new marketplace listing
lua marketplace create list \
--skill-name mySkill \
--display-name "My Skill"
# Publish a specific version with a changelog
lua marketplace create publish \
--marketplace-id mkt_xyz \
--version-id v1 \
--changelog "Adds support for European VAT"
# Update display name
lua marketplace create update \
--marketplace-id mkt_xyz \
--display-name "My Skill (Pro)"
# Unlist (existing installers unaffected)
lua marketplace create unlist --marketplace-id mkt_xyz --force
# Unpublish a specific version
lua marketplace create unpublish \
--marketplace-id mkt_xyz \
--version-id v1 \
--force
Installer Mode
For discovering and installing skills published by others.
Actions
| Action | What it does |
|---|
search | Search the marketplace by free-text query. |
view | Show the detail page for a specific marketplace listing. |
install | Install a specific version of a skill into your agent. |
update | Update an installed skill (e.g. to a newer version or different env vars). |
uninstall | Remove an installed skill. |
installed | List skills you’ve installed. |
Installer Options
| Option | Description |
|---|
--marketplace-id <id> | Marketplace skill ID. |
--version-id <id> | Version ID to install or update to. |
--env-vars <pairs> | Comma-separated key=value pairs for required env vars. |
--query <text> | Search query. |
--page <n> | Page number for paginated search. |
--limit <n> | Results per page. |
--skill-name <name> | Installed-skill name (for update/uninstall). |
--force | Skip confirmation prompts. |
--json | Output as JSON. |
Installer Examples
# Interactive installer menu
lua marketplace install
# Search the marketplace
lua marketplace install search --query "CRM"
lua marketplace install search --query "CRM" --page 2 --limit 20
# View a specific listing
lua marketplace install view --marketplace-id mkt_xyz
lua marketplace install view --marketplace-id mkt_xyz --json
# Install a specific version
lua marketplace install install \
--marketplace-id mkt_xyz \
--version-id v1 \
--force
# Install with env vars
lua marketplace install install \
--marketplace-id mkt_xyz \
--version-id v1 \
--env-vars "STRIPE_KEY=sk_xxx,WEBHOOK_SECRET=whsec_yyy" \
--force
# List installed skills
lua marketplace install installed
lua marketplace install installed --json
# Update an installed skill to a newer version
lua marketplace install update \
--skill-name myCRMSkill \
--version-id v2
# Update env vars on an installed skill
lua marketplace install update \
--skill-name myCRMSkill \
--env-vars "STRIPE_KEY=sk_new"
# Uninstall
lua marketplace install uninstall --skill-name myCRMSkill --force
| Flag | Purpose | Format |
|---|
--env-vars-json | Creator — declare what your skill needs. | JSON array of objects [{"name":"STRIPE_KEY","required":true,"description":"..."}] |
--env-vars | Installer — provide values when installing. | Comma-separated key=value pairs |
