AIUSD Core

AIUSD Core is a unified trading toolkit that lets agents trade across venues, manage perpetual futures, access prediction markets, earn yield by staking, and manage funds — all through a single CLI.

CLI entry point

All commands in this skill use npx -y aiusd-core as the CLI prefix. This works without any global installation — npx resolves the package from npm automatically.

If aiusd-core is already in PATH (via npm install -g aiusd-core), you may use aiusd-core directly instead.

NEVER use dist/cli.js — it is a library module, not an entry point.

When to use this skill

Trigger this skill when the user wants to:

• Trade — buy, sell, or swap any asset across supported venues
• Perpetual futures — long, short, or close positions with leverage, TP/SL
• Prediction markets — trade on event outcomes, search markets, manage positions
• Account & funds — check balances, deposit, withdraw, stake AIUSD for yield
• Market intelligence — trending assets, price feeds, holder analysis
• Automated trading — monitor signals, set conditional execution rules

Authentication

When a user wants to get started or is not yet logged in, present 2 options:

1. Create new account — set up a fresh wallet
2. Browser login — sign in with an existing account via browser

Map the user's choice to the corresponding CLI flag:

• Create new account → npx -y aiusd-core login --new-wallet. The CLI creates a wallet, authenticates, and prints a JSON auth_event with the wallet address.
• Browser login → two-step flow:

1. Run npx -y aiusd-core login --browser. The CLI prints a JSON with url and session_id, then exits immediately. Send the url to the user — NEVER fabricate or guess it.
2. After sending the URL, run npx -y aiusd-core login --poll-session . This blocks until the user signs in, then saves the token and exits with "Login successful".
• Restore from backup → npx -y aiusd-core login --restore . Only use when the user explicitly asks to restore from a mnemonic file.

To switch account: npx -y aiusd-core logout, then npx -y aiusd-core login --browser (or --new-wallet).

Capabilities

Before executing commands in a domain, run npx -y aiusd-core guide to get the latest commands, parameters, and workflows. Follow the guide exactly.

Fallback: if npx -y aiusd-core guide is unreachable, refer to static files in skills/ directory.

Domain Knowledge

AIUSD is not a token

AIUSD is a centralized balance pegged 1:1 to USDT. It is not a tradeable token — there is no contract address or on-chain balance to query. AIUSD can be used to trade any asset on supported venues. The conversion path is handled internally by the CLI; do not attempt to orchestrate it manually.

Always guide before operate

Do not guess command syntax or parameters from memory. Before executing commands in any domain, run npx -y aiusd-core guide to get the current reference. Guides may change between CLI versions.

Asset names can be ambiguous

The same asset symbol may exist on multiple venues. When the user's intent is ambiguous, ask which venue before executing. If the user has a clear preference from context (e.g., "buy SOL" implies Solana), proceed without asking.

Follow next_steps, don't re-confirm

When a command returns action_required with next_steps, execute those steps directly. The user has already confirmed the intent — do not ask again unless the next step involves a different action than what was originally requested.

Rules

1. Always confirm trades with the user before executing.
2. Never expose internal details (JSON responses, tool names, file paths) to users.
3. Present results in clear, conversational language.