aero

Aero CLI

Aerodrome and Velodrome from your terminal. Swap, manage liquidity, and build stock indices with commands or an interactive TUI.

Open stocks → View on GitHub ↗ Watch the demo ↓
Blender clay terminal, two coins, and three chart columns in Aero colors.

What you can do

Quote & swap

Preview routes and price impact before reviewing your swap.

  • Preview swap routes and price impact without sending a transaction.
  • Swap tokens with configurable slippage, approvals, and a transaction review.
  • Use command flags or guided TUI forms and token pickers.

Pools & liquidity

Choose your pool and put liquidity to work.

  • Browse and filter pools, inspect reserves, liquidity, and emissions.
  • Create pools or add liquidity to existing basic and concentrated pools.
  • Choose concentrated liquidity ranges, view positions, and withdraw all or part of a position.

Staking & rewards

Stake, unstake, and collect what your positions earn.

  • Stake positions in gauges and unstake them.
  • Claim gauge emissions and trading fees.
  • Inspect the latest voting epoch or a pool's historical votes, fees, emissions, and incentives.

Tokenized stocks & indices

Build a stock basket with your own target weights.

  • Browse supported tokenized stocks on Base, buy with USDC, sell, and inspect holdings.
  • Create, list, inspect, edit, or delete saved allocation recipes.
  • Set target percentages and preview current versus target holdings before rebalancing the basket.

Indices are local wallet allocation recipes, not separate funds.

veNFT locks

Turn AERO or VELO into locked voting power.

  • Lock AERO on Base or VELO on Optimism for voting power.
  • Choose the amount and lock duration, then review the unsigned plan before signing.

Voting, lock extensions, merges, splits, delegation, and voting-reward claims are SDK APIs. They are not dedicated CLI or TUI actions.

Terminal analytics

Explore protocol economics without leaving the TUI.

  • Explore the TUI's Health, Flywheel, Trade, Token, and Arena views.
  • Read charts for volume, fees, liquidity, token supply, voting economics, and protocol comparisons.
  • Browse cached snapshots while fresh data loads. Dune-backed charts need a Dune API key.

Wallets & transaction review

Connect your wallet. Inspect every transaction.

  • Connect a browser wallet or WalletConnect wallet, inspect its status, and disconnect.
  • Create or restore an encrypted local wallet and remove it when no longer needed.
  • Inspect unsigned plans with --dry-run. Use the CLI execution journal to inspect saved plans, resume eligible steps, or cancel unsent steps.

CLI workflows & automation

Run commands, watch liquidity ranges, and recover interrupted workflows.

  • Get JSON reads, command help, interactive --wizard prompts, guides, and shell completions.
  • Configure the self-hosted liquidity manager, inspect position ranges, and run a dry-run pass or watcher with aero serve.
  • Inspect interrupted liquidity-management cycles and reconcile receipts before manual recovery.

ALM execution requires an explicit opt-in and a local wallet. It remains experimental. Safe execution is disabled in 0.1.

Availability depends on the chain, wallet, and version you run. The CLI and TUI share transaction actions; analytics are visual TUI screens, while the watcher and execution-recovery commands run in the CLI.

See it in the terminal

Francesco's walkthrough of the CLI and TUI.

Highly experimental. Use at your own risk.

Aero is early beta software built with AI coding agents. Expect bugs, incomplete features, incorrect or stale data, and breaking changes. Commands, transaction plans, and wallet flows may behave unexpectedly. Do not treat it as production-ready or assume it has passed an independent security audit.

Wallet-connected actions can sign and broadcast real transactions. A mistake in an amount, token address, approval, network, or transaction can permanently lose funds. A preview or successful simulation is not a guarantee that execution is safe or will succeed.

Start with read-only commands. Review unsigned plans with --dry-run, then independently check the network, contract addresses, amounts, slippage, and spending approvals before signing. Use a separate wallet with only small amounts you can afford to lose. Never share your seed phrase or private key.

Independent and unofficial.

Aero is not affiliated with, endorsed by, sponsored by, or maintained by Aerodrome Finance, Velodrome Finance, Dromos Labs, or Mellow Protocol. It is not an official product or support channel for any of those teams.

Protocol names describe compatibility or source attribution only. All trademarks belong to their respective owners. Original contributions and third-party material have different license terms. Read the repository's licensing review and NOTICE before reuse or redistribution.