AIUSD Pro

Chat with AIUSD using natural language. This skill delegates to a backend
AI agent — you do NOT need to understand AIUSD internals or construct
specific commands.

CLI entry point

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

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

When to use

Use when the user wants anything related to AIUSD or trading
through natural conversation. Examples:

• "What are my balances?"
• "Buy 100 USDC worth of SOL"
• "Stake 500 AIUSD"
• "Long ETH 5x on HyperLiquid"
• "Show trending tokens"

Authentication

If npx -y aiusd-pro send fails with auth error, run login:

1. npx -y aiusd-pro login --browser → prints JSON with url and session_id
2. Send the url to the user (NEVER fabricate it)
3. npx -y aiusd-pro login --poll-session <session_id> → waits for sign-in

Usage

Send a message (background mode)

Backend agent operations take 10-300 seconds (tool calls, reasoning, trading,
transaction confirmation). Always use background mode to avoid exec
timeout cutting off output:

bash background:true command:"npx -y aiusd-pro send 'user request here'"

Returns a sessionId. Then poll for completion and retrieve output:

process action:poll sessionId:<id>
process action:log sessionId:<id>

Complete pattern:

1. Start: bash background:true command:"npx -y aiusd-pro send 'What are my balances?'"
   → returns sessionId: abc123
2. Wait & poll: process action:poll sessionId:abc123
   → returns running or exited
3. Get output: process action:log sessionId:abc123
   → returns the agent's full response text
4. Relay output to user as-is

Multi-turn conversation

Session context is maintained automatically across send calls.
The backend agent remembers all previous messages in the session.

Confirmation flow example:

1. bash background:true command:"npx -y aiusd-pro send 'Buy 100 USDC worth of SOL'"
2. Poll + log → agent responds: "Will buy ~0.65 SOL at $153. Confirm?"
3. Relay to user, user says "yes"
4. bash background:true command:"npx -y aiusd-pro send 'yes'"
5. Poll + log → agent responds: "Done. TX: abc123..."
6. Relay to user

Follow-up questions work the same way — just send the user's
response. The backend has full conversation history.

To start a fresh conversation:

bash command:"npx -y aiusd-pro session reset"

Cancel

bash command:"npx -y aiusd-pro cancel"

Session management

bash command:"npx -y aiusd-pro session new"
bash command:"npx -y aiusd-pro session list"
bash command:"npx -y aiusd-pro session reset"

Rules

1. Always use background:true for send — agent responses take 10-300s.
2. Pass user intent as natural language — do NOT interpret or construct
   specific trading commands.
3. Backend agent handles all domain knowledge, tool selection, and
   multi-step reasoning.
4. Relay stdout to user as-is — already formatted for humans.
   The output includes a browser link at the end (e.g. https://aiusd.ai/chat/<session-id>).
   Always include this link when relaying the response — it lets browser-login users
   continue the conversation in the web UI.
5. If response asks for confirmation or more info, relay to user,
   then send their reply back (same session, same pattern).
6. Run commands sequentially — only one active send per session.
7. Short commands (session reset, cancel, login) can run foreground
   (no background:true needed).