Soku for shell-based agents

Install Soku CLI

Use Soku's ads and GA4 capabilities from any terminal, CI job, or AI coding agent. Sign in once, choose an organization and brand, then run typed data commands without hosting an MCP server.

Start installation Open device login

Quick start

npm i -g @soku-ai/cli
soku auth login
soku org use <slug|id>
soku brand use <slug|id>
soku ads --help

MCP hosts needed

JSON

agent-ready output

skill bundles

Installation

Four commands to get a working session

The CLI stores an org-agnostic Soku session. Workspace selection is sent per request, so one login can safely move across brands you can access.

Install the package

Install once with npm. The binary is named soku.

npm i -g @soku-ai/cli

Sign in from the browser

The CLI prints a device code and opens Soku. Approve the request in your browser.

soku auth login

Choose your workspace

Pick the organization and brand your agent should read from.

soku org use <slug|id>
soku brand use <slug|id>

Discover available commands

Every data capability is exposed as a typed command with shell help.

soku --help
soku ads --help
soku ga4 --help

For Claude Code, Codex, and Cursor

Install Soku skills into your agent

The bundled meta skill teaches your agent how to call the CLI. Business skills are downloaded from Soku's skill catalog, verified by sha256, and installed into your local agent skills directory.

Claude Code
Codex
Cursor

Agent setup

soku skill install --global
soku skill list
soku skill install account-audit ads-report

Browser device login

soku auth login opens a browser approval flow. Agents can use --no-wait to hand the URL to a human and resume later.

Typed data commands

Commands are generated from Soku's capability registry, so shell help shows the available namespaces, actions, and flags.

Server-side credentials

Third-party egress keeps provider keys on Soku's servers. Your terminal gets the upstream response, not raw credentials.

Ready to connect?

Install the CLI, approve the device request, and give your agent a clean way to query Soku data from the terminal.

Open device login Browse skills