Quick Start
Requirements
Section titled “Requirements”- Claude Code.
- Ollama (optional). The architect runs
ollama listand prefers a local model. - For the operational commands:
curl, andkubectlpluskindfor a local cluster. See Compatibility first.
Load the plugin
Section titled “Load the plugin”Leia has no marketplace entry. Load it from a clone:
git clone https://github.com/monaccode/astromesh-leia.gitclaude --plugin-dir ./astromesh-leia--plugin-dir loads it for that session. The latest packaged release, v0.8.0, is a .zip and
a .tar.gz on the releases page.
Run /leia with no arguments to see the welcome menu. Claude Code lists the other commands
under the plugin’s namespace, for example /astromesh-leia:create.
Design an agent
Section titled “Design an agent”-
Describe it.
/leia necesito un bot de WhatsApp para mi pizzería que tome reservasThe interpreter extracts the business, the channel (WhatsApp unless you say web), the vertical (
restaurant-bookinghere) and any capabilities you named. If the intent is ambiguous it asks one question. -
Read the preview. The architect writes a full manifest and explains its choices: the name (
pizzeria-…, RFC 1123), the model and why, the pattern and why, and the assumptions you should check. It writes the file toagents/<name>.yaml. -
Answer
yes,nooredit. Withedit, say what to change and it redesigns.
Prefer questions to a sentence? /leia create with no arguments runs a wizard: template,
channel, business name, description, and two or three questions specific to the template.
Get it onto Nexus
Section titled “Get it onto Nexus”Answering yes publishes the agent to your Nexus (0.26–0.28.x with Leia 0.10 or later; 0.3.x clusters need Leia 0.7 or
earlier) and confirms it registered. If the manifest publishes the agent over A2A, it also
fetches its Agent Card and makes one smoke call. Then:
/leia status/leia test pizzeria-reservas/leia logs pizzeria-reservas --followYou can also publish the file Leia wrote with Cortex or the API:
curl -X POST "$NEXUS_URL/api/v1/agents" \ -H "X-API-Key: $NEXUS_API_KEY" -H "Content-Type: application/yaml" \ --data-binary @agents/pizzeria-reservas.yamlConnection contexts
Section titled “Connection contexts”Leia keeps connections in ~/.astromesh-leia/config.yaml:
current-context: localcontexts: local: nexus-url: http://localhost:8080 api-key: nxk_... cluster-type: kind # kind | remote cluster-name: nexus-local nexus-repo: ~/astromesh-nexus # only for kinddefaults: channel: whatsapp model-provider: auto tenant: default/leia config add <name> adds a context interactively and /leia config use <name> switches.
The API key is stored in that file in plain text.