@bluevs/vhcli

Vision Hub CLI — a command-line interface for the Vision Hub platform. Query projects and resources, and operate ads across media platforms. Designed for both developers and AI Agents.

Installation

npm install -g @bluevs/vhcli

The correct binary for your platform (macOS, Linux, Windows / x64, arm64) is resolved automatically.

Verify the install:

vhcli --help

Getting Started

Log in via your browser:

vhcli auth login

Then run any command. For example, list your projects:

vhcli project list

Commands

| Command | Description | | --------------- | -------------------------------------------------------- | | auth | Authentication (browser login) | | authorization | Manage media-account authorizations | | project | Query projects, resources, accounts, and campaigns | | media | Ad operations across Google, Meta, and TikTok | | schema | Inspect available endpoints and parameters | | config | Show current configuration |

Run vhcli <command> --help for details on any command.

Media operations

Media commands operate on a specific authorized account. Find your authorization IDs with:

vhcli authorization list

Then pass --auth-id to any media command:

vhcli media google --auth-id <id> ...

Output Formats

Every command supports --format (-f):

vhcli project list --format table
vhcli project list --format json    # default
vhcli project list --format csv

Global Flags

| Flag | Description | | ---------------- | ------------------------------------------------- | | -f, --format | Output format: json (default), table, csv | | -s, --server | Vision Hub server URL | | -c, --config | Config file path (default ~/.vhcli/config.yaml) |

For AI Agents

vhcli schema returns a machine-readable description of available commands and parameters, allowing agents to discover the CLI surface at runtime:

vhcli schema
vhcli schema project

Requirements

• Node.js >= 16

License

MIT