CLI Commands
Complete reference for all Aura OS command-line interface commands.
Quick Reference
aura setup Initialize Aura OS by securely storing your wallet's private key. The key is encrypted using AES-256 encryption and stored locally on your device.
Interactive Onboarding
aura chat "message" The primary way to interact with Aura. Uses a self-correcting AI brain to execute your natural language commands.
aura gas Real-time gas price monitoring across all supported L1 and L2 networks. Results are automatically synced to your dashboard.
aura tx <hash> [--json] Forensic transaction analysis. Provides status, gas consumption, event logs, and detailed breakdown of any transaction.
aura script [list|create] The automation engine. Create custom TypeScript scripts that have access to Aura's AI and Blockchain executors.
aura status Quickly check the health of your local system, vault, and cloud synchronization.
aura research [topic] Performs deep, AI-powered research on any crypto project or ecosystem. Aggregates data from 25+ trusted sources including Messari, CoinDesk, and The Block.
aura news [topic]
Fetch the latest trending news and alpha. Use aura watch to keep the alpha stream running in the background.
aura analyze [address] A forensic tool for smart contracts. Supports **Trader Mode** (Risk assessment/Red flags) and **Developer Mode** (Bytecode analysis/Forensics).
aura reset-password Manage your Vault's security. Change your master password or recover access using your private key if forgotten.
All inputs are Invisible (Linux-style) for your protection. No characters will appear as you type.
Supported Actions
The AI Interpreter recognizes these actions from your natural language commands:
CHECK_BALANCE Query token balance for connected wallet
Triggers: "check", "balance", "how much"
SEND_TOKEN Transfer tokens to another address
Triggers: "send", "transfer", "gửi"
SWAP_TOKEN Swap between supported tokens
Triggers: "swap", "exchange", "convert"
RESEARCH Generate comprehensive project reports
Triggers: "research", "analyze", "deep dive"
NEWS Get real-time market updates
Triggers: "news", "happening", "latest"
PORTFOLIO Show all holdings across chains
Triggers: "portfolio", "holds", "tài sản"
Error Handling
Aura OS provides clear error messages when something goes wrong:
❌ Error: Message is required You called aura chat without a message. Add your command in quotes.
⚠ Wallet not configured Run aura setup first to configure your wallet.
⚠ OpenAI API key not found Set OPENAI_API_KEY in your .env file.
aura stake <amount> <protocol> [--info]
Stake ETH directly into liquid staking protocols — Lido (stETH, ~3.8% APR) or Rocket Pool (rETH, ~3.6% APR). Runs on Ethereum mainnet only. Use --info to view existing positions.
aura export <address> [--format csv|json] [--output <dir>]
Export complete transaction history as CSV or JSON. Fetches both native and ERC-20 transfers, deduplicates by hash, and sorts chronologically. Compatible with Koinly, CoinTracker, TaxBit, and CryptoTaxCalc. Requires ETHERSCAN_API_KEY.
aura pnl <address> Calculate on-chain profit & loss by introspecting transaction history. Shows total ETH invested, current portfolio value, unrealized gains/losses, and overall ROI.
aura swap Swap ERC-20 tokens via the Uniswap V3 router directly from the vault-secured CLI. Shows a transaction preview with expected output and slippage before execution.
aura multicall Execute multiple smart contract view/pure function calls in a single RPC request using the Multicall3 standard (0xcA11...). Dramatically reduces latency for multi-data queries.
aura decode <calldata> [--abi <file>]
Decode raw transaction calldata into a human-readable function signature and argument list. Resolves ABI automatically from Etherscan, or accepts a local --abi my.json file.
aura logs <address> [--event <name>] [--blocks <n>]
Fetch and display on-chain event logs for any contract. Filter by event signature (--event Transfer), block window (--blocks 1000), or raw topic hash.
aura gashistory [--blocks <n>] Displays historical gas price trends by sampling blocks over the specified window. Useful for planning transactions during off-peak hours.
aura alert Set real-time on-chain alerts for price thresholds, gas prices, or wallet balance changes. Fires an instant terminal notification when conditions are met.
aura risk <token-address> Rapid risk scoring for any ERC-20 token. Evaluates liquidity depth, top-holder supply concentration, proxy/upgrade risk, and verified source status. Returns a 0-100 risk score with a verdict.