CLI 与 Skills
npx 安装
使用 Xenodia CLI 完成钱包设置、skill 安装、API key 发现和 agent workflow。
当你需要 agent-friendly setup flow，而不是只看 raw HTTP integration 时，使用 CLI。
npx xenodia@latest initCLI 应帮助完成：
- Wallet readiness checks。
- Skill package installation。
- API key discovery or setup。
- Model listing。
- Top-up 或 balance workflow。
Wallet detection
init 应先检查本地环境是否已有可用 owner 或 agent wallet。如果没有，进入 setup mode，让 operator 选择 wallet path：
| Wallet path | Environment |
|---|---|
| Existing local key | Local development 或 controlled server runtime。 |
| Hosted or provider wallet | Managed operator setup。 |
| CDP wallet | Coinbase Developer Platform based agent 或 server runtime。 |
Local-key development 推荐使用 scoped env file，不要提交 private key：
XENODIA_API_KEY=...
XENODIA_OWNER_WALLET=0x...
XENODIA_AGENT_PRIVATE_KEY=...CDP-backed setup：
CDP_API_KEY_ID=...
CDP_API_KEY_SECRET=...Local mode：
npx xenodia@latest init --localCommon commands
| Command | Purpose |
|---|---|
npx xenodia@latest init | 设置 API key、wallet readiness 和 skill instructions。 |
npx xenodia@latest models | 列出可用 model IDs 和 public capabilities。 |
npx xenodia@latest chat | 通过 gateway 发送小型 text request。 |
npx xenodia@latest balance | 在 billing 启用时检查 wallet 或 account balance。 |
npx xenodia@latest topup | 启动 top-up flow。 |
When to use it
本地开发、agent runtime setup、operator workflow 使用 npx xenodia。
构建 backend service、product integration 或 custom SDK 时，优先使用 raw HTTP docs。
Package source
npm package 应保持小而开放：setup scripts、skill files 和指向 https://docs.xenodia.xyz 的链接。完整 API reference 属于这个 docs project，而不是 npm package。