Skip to content
Back to search

soku

Official Soku plugin marketplace

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/About-Intelligence/soku-cli with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/About-Intelligence/soku-cli'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/about-intelligence--soku-cli/badge.svg)](/listings/about-intelligence--soku-cli)

HTML

<a href="/listings/about-intelligence--soku-cli"><img src="/api/listings/about-intelligence--soku-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Let your AI agent set it up (recommended)

Paste this into Claude Code, Codex, Cursor, or another coding agent:

Read https://soku.ai/cli/skill.md, install or update Soku CLI, sign in,
select my workspace, and install all business skills.

The agent guide walks the agent through installation, device login, workspace selection, skill installation, and a first capability check.

Set it up manually

# Install globally (Node.js 20+)
npm install -g @soku-ai/cli

# Sign in with the browser-based device flow
soku auth login

# Find and select a Soku brand workspace
soku workspace resolve <brand>
soku workspace use-brand <brand>
soku workspace status

# See everything available to you
soku --help

No global install needed? Start with `npx @soku-ai/cli --help`.

Install as a plugin

This repository is also a marketplace plugin for Claude Code, Cursor, and Codex. The plugin teaches the agent how to install, sign in to, and use the Soku CLI; it does not bundle the CLI itself, so `npm install -g @soku-ai/cli` still runs on your machine (the plugin's skill walks the agent through it).

# Claude Code
claude plugin marketplace add About-Intelligence/soku-cli
claude plugin install soku@soku

- **Claude Cowork**: the Claude plugin also registers Soku's remote MCP server (`https://api.soku.ai/mcp`), so hosts without a shell can still read, research and prepare review-gated changes. Sign in when Cowork asks to authorize the `soku` connector. - **Cursor**: open **Customize → Plugins**, import `https://github.com/About-Intelligence/soku-cli`, and install `soku` at user or project scope. - **Codex / ChatGPT**: clone this repository; its `.agents/plugins/marketplace.json` registers the `soku` plugin in the local Plugins Directory.

Business skills (`soku-ads-report`, `soku-google-ads`, …) are not part of the plugin. Install them on demand with `soku skill install <slug>`; `soku update skills` keeps them current.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 42 lines
  1. {
  2. "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
  3. "name": "soku",
  4. "description": "Official Soku plugin marketplace",
  5. "owner": {
  6. "name": "About Intelligence",
  7. "url": "https://soku.ai"
  8. },
  9. "plugins": [
  10. {
  11. "name": "soku",
  12. "source": "./",
  13. "description": "Soku is the AI marketing agent for ads and creatives. This plugin brings it into your coding agent: analyze performance across Google, Meta, TikTok and ChatGPT Ads, GA4 and PostHog, audit spend, research competitors, publish SEO pages, and prepare campaign changes for your approval.",
  14. "version": "0.1.0-alpha.27",
  15. "author": {
  16. "name": "About Intelligence"
  17. },
  18. "homepage": "https://soku.ai/cli",
  19. "repository": "https://github.com/About-Intelligence/soku-cli",
  20. "license": "MIT",
  21. "category": "productivity",
  22. "keywords": [
  23. "soku",
  24. "marketing",
  25. "ai-marketing-agent",
  26. "ads",
  27. "ad-creatives",
  28. "google-ads",
  29. "meta-ads",
  30. "tiktok-ads",
  31. "chatgpt-ads",
  32. "ga4",
  33. "posthog",
  34. "seo",
  35. "media-plan",
  36. "competitor-research",
  37. "analytics",
  38. "cli"
  39. ]
  40. }
  41. ]
  42. }
README.md · README · 252 lines
  1. # Soku CLI
  2. **Give any AI agent a secure command line to your growth stack.**
  3. Query marketing data, manage campaigns, publish SEO content, and automate
  4. recurring work from Claude Code, Codex, Cursor, or any terminal.
  5. [![npm version](https://img.shields.io/npm/v/@soku-ai/cli?color=ff6b00&label=npm)](https://www.npmjs.com/package/@soku-ai/cli)
  6. [![Node.js 20 or newer](https://img.shields.io/badge/Node.js-%3E%3D20-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
  7. [![MIT license](https://img.shields.io/badge/license-MIT-black.svg)](./LICENSE)
  8. [Website](https://soku.ai) · [Agent guide](https://soku.ai/cli/skill.md) · [npm](https://www.npmjs.com/package/@soku-ai/cli) · [Contributing](./CONTRIBUTING.md)
  9. ---
  10. Soku CLI turns the tools and data already connected to your Soku workspace into
  11. typed, discoverable commands. An agent can move from a question to an answer—or
  12. from a plan to a human-approved action—without you copying data between tabs,
  13. sharing API keys, or running an MCP host.
  14. ## Why Soku CLI?
  15. - **One interface for your growth stack.** Work with Google Ads, Meta Ads,
  16. ChatGPT Ads, GA4, PostHog, SEO Hosting, automations, Context Hub, and more.
  17. - **Built for agents, useful in a shell.** Commands are self-documenting, and
  18. non-interactive output uses a stable JSON envelope that agents and scripts can
  19. parse reliably.
  20. - **Credentials stay out of prompts.** Soku handles authentication and can inject
  21. connected third-party credentials server-side.
  22. - **Writes have a human gate.** Delivery-changing ads operations create a review
  23. request before anything goes live.
  24. - **New capabilities arrive automatically.** The typed command tree is generated
  25. from Soku's capability registry, with `soku call` as a forward-compatible
  26. escape hatch.
  27. ## Quick start
  28. ### Let your AI agent set it up (recommended)
  29. Paste this into Claude Code, Codex, Cursor, or another coding agent:
  30. ```text
  31. Read https://soku.ai/cli/skill.md, install or update Soku CLI, sign in,
  32. select my workspace, and install all business skills.
  33. ```
  34. The agent guide walks the agent through installation, device login, workspace
  35. selection, skill installation, and a first capability check.
  36. ### Set it up manually
  37. ```bash
  38. # Install globally (Node.js 20+)
  39. npm install -g @soku-ai/cli
  40. # Sign in with the browser-based device flow
  41. soku auth login
  42. # Find and select a Soku brand workspace
  43. soku workspace resolve <brand>
  44. soku workspace use-brand <brand>
  45. soku workspace status
  46. # See everything available to you
  47. soku --help
  48. ```
  49. No global install needed? Start with `npx @soku-ai/cli --help`.
  50. ### Install as a plugin
  51. This repository is also a marketplace plugin for Claude Code, Cursor, and Codex.
  52. The plugin teaches the agent how to install, sign in to, and use the Soku CLI;
  53. it does not bundle the CLI itself, so `npm install -g @soku-ai/cli` still runs on
  54. your machine (the plugin's skill walks the agent through it).
  55. ```bash
  56. # Claude Code
  57. claude plugin marketplace add About-Intelligence/soku-cli
  58. claude plugin install soku@soku
  59. ```
  60. - **Claude Cowork**: the Claude plugin also registers Soku's remote MCP server (`https://api.soku.ai/mcp`), so hosts without a shell can still read, research and prepare review-gated changes. Sign in when Cowork asks to authorize the `soku` connector.
  61. - **Cursor**: open **Customize → Plugins**, import `https://github.com/About-Intelligence/soku-cli`, and install `soku` at user or project scope.
  62. - **Codex / ChatGPT**: clone this repository; its `.agents/plugins/marketplace.json` registers the `soku` plugin in the local Plugins Directory.
  63. Business skills (`soku-ads-report`, `soku-google-ads`, …) are not part of the
  64. plugin. Install them on demand with `soku skill install <slug>`; `soku update
  65. skills` keeps them current.
  66. ## What can you do with it?
  67. ### Turn ad data into answers
  68. Start with cached, normalized reporting across supported ad platforms:
  69. ```bash
  70. soku ads list-ad-accounts --platform google
  71. soku ads query-single-dimension \
  72. --platform google \
  73. --account-id <account_id> \
  74. --dimension campaign \
  75. --date-start 2026-06-01 \
  76. --date-end 2026-06-30
  77. ```
  78. Use the same workflow for Meta, TikTok, or ChatGPT Ads, or reach for Google Ads
  79. GAQL when you need a custom breakdown.
  80. ### Understand acquisition and product behavior together
  81. ```bash
  82. # Website acquisition and conversion
  83. soku ga4 list-properties
  84. soku ga4 get-property-overview --property-id <property_id>
  85. soku ga4 list-traffic-sources --property-id <property_id>
  86. # Product behavior
  87. soku posthog list-projects
  88. soku posthog query \
  89. --project-id <project_id> \
  90. --tool execute-sql \
  91. --arguments '{"query":"SELECT count() FROM events WHERE event = '\''$pageview'\''"}'
  92. ```
  93. This makes it possible for an agent to investigate the path from campaign spend
  94. to site traffic to in-product behavior without asking you to export CSV files.
  95. ### Create campaign changes with a human in control
  96. ```bash
  97. soku ads meta campaign create \
  98. --account-id <meta_account_id> \
  99. --name "Launch Test" \
  100. --objective OUTCOME_TRAFFIC \
  101. --summary "Create paused Meta traffic campaign Launch Test"
  102. ```
  103. Delivery-changing writes return a review ID instead of executing immediately:
  104. ```bash
  105. soku review show <review_id>
  106. soku review approve <review_id>
  107. ```
  108. An agent can prepare the exact change and explain it; a human still decides
  109. whether it runs.
  110. ### Publish and automate growth work
  111. ```bash
  112. # Publish a complete HTML page through Soku SEO Hosting
  113. soku seo-hosting pages put \
  114. --section blog \
  115. --slug launch-notes \
  116. --title "Launch notes" \
  117. --html-file page.html
  118. soku seo-hosting pages publish --section blog --slug launch-notes
  119. # Schedule a recurring agent task
  120. soku automation create \
  121. --name "Weekly account health" \
  122. --prompt "Review paid acquisition performance and flag anomalies" \
  123. --cron "0 9 * * 1" \
  124. --timezone America/Los_Angeles
  125. # Add source material to the workspace Context Hub
  126. soku context upload ./campaign-brief.pdf --dir research
  127. ```
  128. ## Agent-native by design
  129. In a non-interactive shell, every command returns a predictable JSON envelope:
  130. ```json
  131. {"ok":true,"data":{"...":"..."}}
  132. ```
  133. Errors use the same shape and a non-zero exit code:
  134. ```json
  135. {"ok":false,"error":{"code":"...","message":"..."}}
  136. ```
  137. Install Soku's agent skills to give your agent the workflows and guardrails
  138. behind the commands—not just their names:
  139. ```bash
  140. soku skill install --all --global
  141. soku skill list
  142. soku skill status
  143. ```
  144. The bundled meta skill is available at [`skills/soku/SKILL.md`](./skills/soku/SKILL.md).
  145. ## Command map
  146. | Area | Start here | Typical use |
  147. | --- | --- | --- |
  148. | Authentication | `soku auth --help` | Sign in, sign out, and check session state |
  149. | Workspace | `soku workspace --help` | Resolve and switch organization/brand context |
  150. | Advertising | `soku ads --help` | Query reporting data and prepare reviewed writes |
  151. | Analytics | `soku ga4 --help`, `soku posthog --help` | Analyze acquisition, conversion, and product behavior |
  152. | SEO Hosting | `soku seo-hosting --help` | Stage, publish, and manage SEO pages and domains |
  153. | Automations | `soku automation --help` | Schedule and inspect recurring agent work |
  154. | Context Hub | `soku context --help` | Organize files an agent can use as context |
  155. | Secure egress | `soku egress --help` | Call supported third-party APIs without exposing keys |
  156. | Reviews | `soku review --help` | Inspect and decide on gated operations |
  157. | Skills | `soku skill --help` | Install and update Soku workflows for AI agents |
  158. Run `soku <namespace> <action> --help` before an unfamiliar call. Typed command
  159. names use kebab-case; raw capability names used with `soku call` use snake_case.
  160. ## How it works
  161. The CLI talks to Soku over `/api/cli/*`; it does not require an MCP host. Its
  162. typed commands are generated from
  163. [`src/generated/capabilities.json`](./src/generated/capabilities.json), which is
  164. synced automatically from the Soku backend. Do not edit that file by hand.
  165. If a newly released capability does not yet have an ergonomic typed command,
  166. you can still discover it and call it directly:
  167. ```bash
  168. soku call ads list_ad_accounts -p platform=google
  169. soku call <namespace> <action> --help
  170. ```
  171. ## Development
  172. ```bash
  173. pnpm install
  174. pnpm typecheck
  175. pnpm test
  176. pnpm build
  177. ```
  178. The project is TypeScript with ESM and `NodeNext` module resolution. Tests are
  179. colocated as `*.test.ts` files and run with Node's built-in test runner.
  180. `keytar` is optional; when it is unavailable, credential storage falls back to
  181. a file-backed store.
  182. ## Contributing
  183. Issues and pull requests are welcome. Read [CONTRIBUTING.md](./CONTRIBUTING.md)
  184. and our [Code of Conduct](./CODE_OF_CONDUCT.md) before contributing. Please use
  185. [SECURITY.md](./SECURITY.md) to report security issues.
  186. ## License
  187. [MIT](./LICENSE) © About Intelligence

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.