Quickstart
Vishwa CLI is an agent-native console for on-chain finance on Solana. You never type flags or memorize commands - you describe what you want, and every action is verified against your constraints before it executes.
Prerequisites
Node.js 18+ and npm
A terminal
A Vishwa account - created during sign-in
Check Node is installed:
node --version
npm --versionInstall and sign in
Vishwa ships as an agent skill. Point your agent at the install guide and it handles the rest:
Install Vishwa from https://api.vishwalab.com/skills/vishwa-cli/skill.mdThe agent will:
Check prerequisites - confirms Node.js and npm are present.
Install the CLI globally via npm (
vishwa-cli).Sign you in:
vishwa-cli loginThis opens your browser to
vishwalab.com/auth/login. Approve the session and the CLI is connected to the Vishwa gateway. Your agent wallet is created or linked automatically.
When this finishes you have a working CLI bound to your Vishwa wallet, with every request routed through the gateway into the control layer.
Before you trade: set your constraints
Do not skip this. Before the agent can move anything, define the guardrails the control layer will enforce - allowed operations, venues, and spend caps. See Setting Your Constraints.
Your first session
Once constraints are set:
From there, open a market by name, place a trade, and review positions - all in plain English. See Using the CLI for the full walkthrough.