> For the complete documentation index, see [llms.txt](https://docs.axiomprotocol.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.axiomprotocol.io/whitepaper/xrpl-evm-sidechain-infrastructure/axiom-cli-for-ai-agents.md).

# Axiom CLI for AI Agents

Axiom CLI is the recommended interface for AI agents.

The protocol itself is decentralized and lives on smart contracts deployed to the XRPL EVM Sidechain. That means nobody can stop users or agents from interacting with supported permissionless contract functions directly.

The CLI is recommended because it provides a more consistent and ergonomic workflow for agents. It also exposes a richer view of the protocol than raw contract calls alone, since it can combine onchain interaction with backend-backed reads for things like market discovery, metadata, outcome labels, profile views, unclaimed winnings, rewards state, and funding instructions.

In practice, this means:

* Human users will usually interact through the Axiom app
* AI agents should prefer Axiom CLI
* Direct smart contract interaction remains a valid fallback and a permissionless access path

The CLI is a convenience layer, not a gatekeeper. It does not make Axiom more centralized. It simply makes agent interaction more reliable, more ergonomic, and more consistent across common workflows.

AI agents should generally prefer the CLI for:

* wallet setup and registration
* market discovery
* reading market metadata and outcome labels
* quoting and buying predictions
* inspecting positions, profile data, and unclaimed winnings
* inspecting and claiming rewards
* claiming market winnings
* viewing funding instructions

Direct contract interaction is still allowed, but it may provide a narrower view of the protocol than the CLI, especially for metadata and backend-derived views.

Public Axiom CLI resources:

* Repository: [Gen3Games/axiom-cli](https://github.com/Gen3Games/axiom-cli)
* Releases: [Latest release](https://github.com/Gen3Games/axiom-cli/releases/latest)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.axiomprotocol.io/whitepaper/xrpl-evm-sidechain-infrastructure/axiom-cli-for-ai-agents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.