Skip to main content

CLI quickstart

The navi CLI is the fastest way to start using Navi. It gives you direct access to deals, briefings, runs, and MCP setup from a terminal.

Before you begin

Make sure:
  • the navi CLI is installed on your machine
  • you know your Navi base URL
  • you have a valid authenticated session for your workspace
If Meridian7 manages your environment, your workspace admin can confirm the correct base URL.

1. Set the base URL

navi config set-base-url https://dev.meridian7.io
Use your workspace URL if it is different from https://dev.meridian7.io.

2. Log in

navi auth login --cookie "<your-session-cookie>"

3. Verify the connection

navi auth whoami
Example response:
{
  "data": {
    "service": "navi-api",
    "version": "v1",
    "environment": "development",
    "org": {
      "id": "org_123",
      "name": "Acme Corporation"
    },
    "principal": {
      "type": "user",
      "authMode": "session",
      "scopes": ["agents:read", "runs:read", "runs:write", "briefings:read", "deals:read"]
    }
  }
}

4. Discover your workspace

navi agents list
navi deals list --limit 10

5. Generate a briefing

Use Navi for common workflows immediately:
navi briefings morning
navi briefings meeting 11111111-1111-1111-1111-111111111111 --contact "Elena Vasquez"

6. Create and inspect a run

navi runs create \
  --agent navi.meeting_prep \
  --message "Prepare me for tomorrow's executive review" \
  --deal 11111111-1111-1111-1111-111111111111
Then inspect or stream it:
navi runs list --limit 10
navi runs get <run-id>
navi runs stream <run-id>

7. Install Navi MCP for Claude Desktop

navi mcp install
Restart Claude Desktop after the command completes.

Common next steps