Soku AIThere are two ways to work with Soku, and they're built for different moments:
- The web app — you collaborate with the Soku agent in chat, with a dashboard, automations, and a skill marketplace. This is the main product, and where most people start.
- The Soku CLI — you give your own shell-based AI agent (Claude Code, Cursor, Codex, and similar) access to Soku. Connect once, and that agent can read your data, use Soku skills, and call covered APIs from the terminal.
They're not either/or — the same workspace, brands, and connected accounts power both.
At a glance
| Web app | Soku CLI | |
|---|---|---|
| Who drives | You, chatting with the Soku agent | Your own coding agent, in its terminal |
| Where it runs | Browser (soku.ai) | Your shell, alongside Claude Code / Cursor / Codex |
| Best for | Day-to-day marketing work, reports, dashboards | Embedding Soku's data + skills into an external agent workflow |
| Setup | Sign up, connect accounts | npm i -g @soku-ai/cli, device login, pick a workspace |
| Interface | Chat, Dashboard, Automations, Marketplace | Typed commands (soku ads, soku ga4, soku posthog, soku egress…) |
| Skills | Install from the Marketplace, @mention in chat | Install with soku skill install, used by your agent |
When to use the web app
Use the web app for the everyday work — it's the full product with a UI:
- You want to chat with the agent, review its output, and iterate.
- You need the Dashboard to see spend, trends, and KPIs across accounts.
- You want to schedule recurring reports with Automations.
- You're inviting teammates and managing brands, roles, and billing.
If you're not sure which to use, use the web app. See The workspace for a tour.
When to use the Soku CLI
Use the CLI when you already work in a shell-based AI agent and want it to reach Soku's data and skills directly:
- You run Claude Code, Cursor, or Codex and want it to pull ads, GA4, and PostHog data without leaving the terminal.
- You want your agent to use Soku-authored skills (playbooks) as part of a larger workflow it's running.
- You need it to call covered third-party APIs (Ahrefs, DataForSEO, and more) with credentials injected server-side via
soku egress. - You're managing SEO Hosting content or scripting repeatable data pulls.
Connect once with device login, select the remote org and brand to operate on, and your agent has the Soku surfaces it needs. Write actions that change account state are review-gated — your agent requests them, and you approve.
Install from npm with Node.js 20 or newer (
npm i -g @soku-ai/cli). Full setup and the ready-to-paste agent prompt live on the CLI page.