npx Install
Install the Xenodia CLI path for wallet setup, skill installation, API key discovery, and agent workflows.
Use the CLI path when you want an agent-friendly setup flow rather than a raw HTTP-only integration.
npx xenodia@latest initThe CLI should help with:
- Wallet readiness checks.
- Skill package installation.
- API key discovery or setup.
- Model listing.
- Top-up or balance workflows when enabled.
Wallet detection
init should first check whether the local environment already has a usable owner or agent wallet. If it cannot find one, continue in setup mode and ask the operator to choose a wallet path:
| Wallet path | Environment |
|---|---|
| Existing local key | Local development or controlled server runtime. |
| Hosted or provider wallet | Managed operator setup. |
| CDP wallet | Coinbase Developer Platform based agent or server runtime. |
For local-key development, prefer a scoped environment file and avoid committing private keys:
XENODIA_API_KEY=...
XENODIA_OWNER_WALLET=0x...
XENODIA_AGENT_PRIVATE_KEY=...For CDP-backed setup, provide:
CDP_API_KEY_ID=...
CDP_API_KEY_SECRET=...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 | Set up API key, wallet readiness, and skill instructions. |
npx xenodia@latest models | List available model IDs and public capabilities. |
npx xenodia@latest chat | Send a small text request through the gateway. |
npx xenodia@latest balance | Check wallet or account balance when billing is enabled. |
npx xenodia@latest topup | Start a top-up flow when supported. |
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 should stay small and open-source friendly: setup scripts, skill files, and links to https://docs.xenodia.xyz; the API reference belongs in this docs project rather than inside the npm package.
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.