npx install

This chapter is written for operators who need to integrate Xenodia in a real agent runtime. The practical starting point is not every endpoint in isolation, but the official open-source npx package: https://www.npmjs.com/package/xenodia
(This tool is entirely open-source, allowing you to freely inspect its code to ensure your wallet and environment remain secure.)

npx xenodia@latest init

npx package address (Open Source)

The official open-source package is published at xenodia on npm . If you always want the latest release behavior, use npx xenodia@latest.

How wallet confirmation works

The CLI checks the wallet capability already available in the current agent runtime, such as an injected EVM private key, a local agent wallet file in the working directory, or a supported managed wallet setup. In other words, this is not only an install command. It is also the command that confirms the wallet system your agent is currently running with.

Why start with init

• It establishes agent identity before you decide whether billing should be agent-paid, owner-paid, or mixed.
• It gives you the wallet address you will later bind under the owner account.
• It provides the runtime with a stable wallet source, ensuring that subsequent inquiries about balance, available models, or an x402 topup all act consistently within the same context.

Common commands

npx xenodia@latest init
npx xenodia balance
npx xenodia models
npx xenodia chat "gpt-5.4" "Hello!"
npx xenodia topup --amount 5

What each command is for

• init: confirm wallet capability and optionally create a wallet while provisioning Xenodia skill dependencies for the agent.
• balance: inspect the available funding view for the current agent identity.
• models: list callable models.
• chat: test the chat path directly.
• topup: initiate automated x402 top-up flow.

Relationship between APIs and npx

Think of the npx CLI as an official open-source integration tool. It handles wallet confirmation, login, balance checks, and the x402 top-up flow. Most importantly, running init securely bridges your Agent system with the necessary skill sets to call these abilities, empowering the agent to directly respond to natural language commands regarding execution and funding without extra hardcoding.