xapi-to

Agent-friendly command-line interface for xAPI — discover and call capabilities and APIs from your terminal or AI agent.

Installation

# Via npx (no install needed)
npx xapi-to --help

# Or install globally with npm
npm install -g xapi-to

# Or from source
cd xapi-cli && bun install

The published CLI runs on Node.js 18+. Bun is only required for local source development and tests.

Quick Start

# 1. Register a new account (apiKey saved automatically)
xapi-to register

# 1b. Or register with an inviter's referral code (please replace xapito to your referral code)
xapi-to register --referral-code xapito

# 2. Or set an existing key
xapi-to config set apiKey=sk-xxx

# 3. Or via env var
export XAPI_KEY=sk-xxx

# 4. Verify connectivity
xapi-to config health

Usage

xapi-to <command> [args] [flags]

Action Commands

Unified interface for capabilities (built-in) and APIs (third-party). Use --source capability|api to filter.

xapi-to list                                            # list all actions
xapi-to list --source capability                        # only built-in capabilities
xapi-to list --source api --category DeFi               # filter by source and category
xapi-to list --page 2 --page-size 20                    # pagination
xapi-to list --service-id <id>                          # filter by service

xapi-to search "twitter"                                # search by keyword
xapi-to search "token price" --source api               # search APIs only

xapi-to categories                                      # list all categories
xapi-to categories --source capability                  # categories for capabilities only

xapi-to services                                        # list all services
xapi-to services --category Social --page-size 10       # filter and paginate

xapi-to get twitter.tweet_detail                        # get action schema
xapi-to call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'  # execute

OAuth

Bind third-party OAuth accounts (e.g. Twitter) to your API key.

xapi-to oauth bind --provider twitter                   # bind Twitter account
xapi-to oauth status                                    # list current bindings
xapi-to oauth unbind <binding-id>                       # remove a binding
xapi-to oauth providers                                 # list available providers

Account

xapi-to register                                        # create account, saves apiKey automatically
xapi-to register --referral-code xapito                 # register with an inviter's referral code (please replace xapito to your referral code)
xapi-to register xapito                                 # positional shorthand for --referral-code
xapi-to balance                                         # show USD balance
xapi-to topup                                           # generate payment URL
xapi-to topup --method stripe --amount 10               # stripe, $10
xapi-to topup --method x402                             # x402 (USDC on Base)

Config

xapi-to config show                                     # show current config
xapi-to config set apiKey=sk-xxx                        # save API key
xapi-to config health                                   # check backend connectivity

Workflow: Always GET before CALL

Before calling any action, always read its schema first to understand required parameters:

# 1. Find the action
xapi-to search "twitter"

# 2. Read its schema
xapi-to get twitter.tweet_detail

# 3. Call with correct parameters
xapi-to call twitter.tweet_detail --input '{"tweet_id":"1234567890"}'

Output Formats

All output is JSON by default — designed for agent consumption.

xapi-to list --format json                              # default, machine-readable
xapi-to list --format pretty                            # pretty-printed JSON
xapi-to list --format table                             # human-readable table

Environment Variables

| Variable | Description | |---|---| | XAPI_KEY | API key (overrides config file) | | XAPI_ACTION_HOST | Action service host (default: action.xapi.to) | | XAPI_OUTPUT | Default output format (json|pretty|table) |

Config is stored at ~/.xapi/config.json.

Built-in Capabilities

| ID | Description | |---|---| | twitter.tweet_detail | Get tweet details and replies | | twitter.user_by_screen_name | Get user profile by username | | twitter.user_by_screen_names | Batch get user profiles by usernames | | twitter.user_tweets | Get tweets from a user | | twitter.user_media | Get media posts from a user | | twitter.following | Get user following list | | twitter.followers | Get user followers | | twitter.retweeters | Get tweet retweeters | | twitter.search_timeline | Search tweets, users, photos, videos | | ai.text.chat.fast | Fast AI chat completion | | ai.text.chat.reasoning | Advanced reasoning chat | | ai.text.summarize | Summarize long text | | ai.text.rewrite | Rewrite text with different styles | | ai.embedding.generate | Generate vector embeddings | | web.search | Web search | | web.search.realtime | Realtime web search with time filters | | news.search.latest | Latest news search | | crypto.token.price | Crypto token price and changes | | crypto.token.metadata | Crypto token metadata |

Security

• NEVER send your API key to any domain other than *.xapi.to
• The key is stored at ~/.xapi/config.json — do not expose this file
• topup outputs a payment URL containing the API key — do not share publicly

License

MIT