npx Install
Use the Xenodia CLI for wallet authentication, skill installation, model discovery, balance checks, chat, and explicit top-ups.
Use the CLI path when you want an agent-friendly setup flow rather than a raw HTTP-only integration.
npx xenodia@latest initThe current CLI supports:
- Local-key or managed-wallet signing.
- Xenodia skill installation in detected agent directories.
- Model listing, balance checks, and direct chat calls.
- One-hour access tokens and long-term API key retrieval.
- Explicit x402-compatible top-ups.
Wallet setup
init displays the available setup path and installs skills. init --local creates a new local agent wallet only when no wallet already exists. It does not bind the wallet to an owner and does not create an API key.
| Wallet path | Environment |
|---|---|
| Existing local key | Local development or controlled server runtime. |
| Managed wallet credentials | An agent or server runtime that uses the CLI's supported managed signer. |
For local-key development, prefer a scoped environment file and avoid committing private keys:
XENODIA_API_KEY=...
EVM_PRIVATE_KEY=...
# Or point to an existing protected key file:
XENODIA_KEY_FILE=/absolute/path/to/agent.keyFor CDP-backed setup, provide:
CDP_API_KEY_ID=...
CDP_API_KEY_SECRET=...
CDP_WALLET_SECRET=...
# Optional: CDP_WALLET_NAME=...Use local mode when the agent should bind a wallet from the current machine:
npx xenodia@latest init --localCommon commands
| Command | Purpose |
|---|---|
npx xenodia@latest init | Show wallet setup instructions and install detected skill integrations. |
npx xenodia@latest init --local | Create a local agent wallet if a new identity is intended. |
npx xenodia@latest models | List available model IDs and public capabilities. |
npx xenodia@latest chat gpt-6-astra "Hello" | Send a text request with a current model ID. |
npx xenodia@latest balance | Check the bound agent account's credit balance. |
npx xenodia@latest get-token | Print a one-hour access token; capture it privately. |
npx xenodia@latest get-api-key | Retrieve or create the bound agent account's long-term API key; capture it privately. |
npx xenodia@latest topup --amount 5 | Start an explicit 5 USDC compatible top-up with the active wallet. |
Commands other than plain init sign a wallet challenge. The wallet must already be bound to a Xenodia account. models performs authentication even though the raw GET /v1/models endpoint is public.
When to use it
Use npx xenodia for local development, agent runtime setup, and operator workflows.
Use raw HTTP docs when building a backend service, product integration, or custom SDK.
Package source
The package contains setup commands and lightweight skill files. Use https://docs.xenodia.xyz for the current API reference and model-specific behavior.
Relationship to online docs
Installed skill instructions should link back to https://docs.xenodia.xyz instead of duplicating large API reference content inside the skill package.