> For the complete documentation index, see [llms.txt](https://docs.vishwalab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vishwalab.com/vishwa-cli/quickstart.md).

# 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:

```bash
node --version
npm --version
```

## Install 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.md
```

The agent will:

1. **Check prerequisites** - confirms Node.js and npm are present.
2. **Install the CLI globally** via npm (`vishwa-cli`).
3. **Sign you in:**

   ```bash
   vishwa-cli login
   ```

   This 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](broken://pages/bc3ffecb5021d68f2932ceaea8e3e094006d6963).

## Your first session

Once constraints are set:

```
get my wallet
show me the polymarket hot events
```

From there, open a market by name, place a trade, and review positions - all in plain English. See [Using the CLI](broken://pages/5c925d7a4f4e7a002b70a10feb9e64c7ed1a5050) for the full walkthrough.