Xenodia Agent CLI

The official Node.js command-line tool for interacting with the Xenodia Multimodal AI Gateway.

Quickstart

Run directly without installing via npx:

# Generate a local agent wallet
npx xenodia init

# Check balance
npx xenodia balance

# List available models
npx xenodia models

# Test a chat completion
npx xenodia chat "gpt-4o" "Hello!"

# Get a static API Key to put in your agent's config file
npx xenodia get-api-key

Running npx xenodia init now also installs the bundled xenodia skill into detected agent runtimes, including:

• ~/.openclaw/skills/xenodia
• ~/.openclaw/workspace/skills/xenodia
• ~/.agents/skills/xenodia

It also installs the bundled xenodia-media skill for image and video generation workflows.

Documentation

If the installed skill text is not enough for the agent to make a safe API call, open the online docs directly:

• Docs home: https://xenodia.xyz/docs
• Quickstart: https://xenodia.xyz/docs/quickstart
• Chat completions: https://xenodia.xyz/docs/traditional-api/chat-completions
• Model discovery: https://xenodia.xyz/docs/traditional-api/model-discovery
• Image generation: https://xenodia.xyz/docs/traditional-api/image-generation
• Task retrieval: https://xenodia.xyz/docs/traditional-api/task-retrieval

Rule: if a parameter, enum value, or endpoint is not clearly documented, do not guess it. Read the online docs first.

GitHub Upload Prep

This folder is ready to be uploaded as a standalone GitHub repository.

Included:

• bin/xenodia.js CLI entrypoint
• package.json and package-lock.json
• README.md
• SKILL.md
• .gitignore and .npmignore
• LICENSE

Excluded from Git and npm publish:

• .xenodia_agent_key
• node_modules/

Before publishing the new GitHub repo, you may want to update:

• author in package.json
• repository metadata after your GitHub repo URL exists

Setup & Publishing

Since you created this package, to make it public on npm so everyone can use npx xenodia, simply run:

npm publish --access public