Meridian CLI

Talk to your Meridian visa assistant from the terminal.

npm install -g @usemeridian/cli
meridian login
meridian requirements NG-GB

Commands

| Command | Auth | Description | |---------|------|-------------| | meridian login | — | Sign in via browser (OAuth device flow + magic link). | | meridian whoami | yes | Show the signed-in account. | | meridian requirements <origin-destination> | — | Visa requirements for a corridor (e.g. NG-GB). MCP-backed legacy form. | | meridian requirements get | — | Sectioned envelope via REST /api/requirements. SSOT contract. | | meridian check <origin-destination> | yes | Run a readiness check against your vault. | | meridian feedback <text> | — | Send a quick note to the Meridian team. |

requirements get

# Single corridor
meridian requirements get --passport NG --destination DE --purpose tourism

# Multi-leg trip
meridian requirements get --passport NG --legs LOS-CPH:2,CPH-LOS:2 --purpose tourism

# Reciprocity (residence-based)
meridian requirements get --passport NG --destination DE --residence DK

# Filter to specific sections
meridian requirements get --passport NG --destination DE --sections visa,documents

# Machine-readable
meridian requirements get --passport NG --destination DE --format json

# Pin a schema version (Stripe-style; otherwise server applies latest)
meridian requirements get --passport NG --destination DE --version 2026-06-01

--destination and --legs are mutually exclusive. The envelope shape is the canonical Requirements::Schema contract; same shape as the MCP tool's structuredContent.

Add --json to any command to get machine-readable output.

Authentication

meridian login runs OAuth 2.0 Device Authorization Grant (RFC 8628). The CLI shows you a code, opens your browser to https://usemeridian.app/device, and you confirm the code matches before approving. No password required; new users get a magic-link bootstrap on the same page.

Tokens live at ~/.config/meridian/credentials.json (mode 0600). Override per-invocation with --token, per-shell with MERIDIAN_TOKEN, or pick a named profile with MERIDIAN_PROFILE=local.

Configuration

| Env var | Default | Purpose | |---------|---------|---------| | MERIDIAN_API_URL | https://usemeridian.app | Base URL for API + OAuth. | | MERIDIAN_TOKEN | — | Bypass the credentials file. | | MERIDIAN_PROFILE | default | Select a profile from the credentials file. |

Development

cd cli/
npm install
npm run dev -- requirements NG-GB
npm test