npx Install
Xenodia CLI で wallet authentication、Skill installation、model discovery、balance、chat、明示的な top-up を行う。
raw HTTP integration ではなく agent-friendly setup flow が必要な場合に CLI を使います。
npx xenodia@latest init現在の CLI がサポートすること：
- Local key または managed wallet signing。
- 検出した Agent directory への Xenodia Skills installation。
- Model listing、balance check、direct chat。
- 1-hour access token と long-term API key の取得。
- 明示的な x402-compatible top-up。
Wallet setup
init は利用可能な setup path を表示し、Skills をインストールします。新しい identity が必要な場合だけ init --local で local Agent wallet を作成します。このコマンドは owner との紐付けや API key の作成を行いません。
| Wallet path | Environment |
|---|---|
| Existing local key | Local development または controlled server runtime。 |
| Managed wallet credentials | CLI が対応する managed signer を使う Agent または server runtime。 |
Local-key development では scoped env file を使い、private key を commit しないでください：
XENODIA_API_KEY=...
EVM_PRIVATE_KEY=...
# または保護された既存 key file を明示：
XENODIA_KEY_FILE=/absolute/path/to/agent.keyCDP-backed setup：
CDP_API_KEY_ID=...
CDP_API_KEY_SECRET=...
CDP_WALLET_SECRET=...
# Optional: CDP_WALLET_NAME=...Local mode：
npx xenodia@latest init --localCommon commands
| Command | Purpose |
|---|---|
npx xenodia@latest init | Wallet setup を表示し、検出した Skill integration をインストール。 |
npx xenodia@latest init --local | 新しい identity が必要な場合のみ local Agent wallet を作成。 |
npx xenodia@latest models | 利用可能な model IDs と public capabilities を表示。 |
npx xenodia@latest chat gpt-6-astra "Hello" | 現在の model ID で text request を送る。 |
npx xenodia@latest balance | 紐付け済み Agent account の Credits を確認。 |
npx xenodia@latest get-token | 1-hour access token を出力。安全に受け取る。 |
npx xenodia@latest get-api-key | Long-term API key を取得または作成。安全に受け取る。 |
npx xenodia@latest topup --amount 5 | Active wallet で明示的に 5 USDC を top up。 |
通常の init 以外のコマンドは wallet challenge に署名します。Wallet は Xenodia account に紐付け済みである必要があります。Raw GET /v1/models は public ですが、CLI の models は認証を行います。
When to use it
local development、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 に置きます。