@cmo-so/cli 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +44 -2
  2. package/dist/cmo.mjs +21953 -0
  3. package/package.json +53 -5
package/README.md CHANGED
@@ -1,3 +1,45 @@
1
- # Temporary Holding Version
1
+ # @cmo-so/cli
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ [CMO.so](https://cmo.so) on the command line. Check results, review your LinkedIn queue, manage blog post ideas and drafts, and script it all in CI. Everything Maggie can do in the app is one command away.
4
+
5
+ ```sh
6
+ npx @cmo-so/cli login # sign in in your browser
7
+ npx @cmo-so/cli inbox # what needs you now
8
+ ```
9
+
10
+ Or install it: `npm i -g @cmo-so/cli`, then use `cmo`.
11
+
12
+ ## Commands
13
+
14
+ ```text
15
+ cmo login | logout | whoami
16
+ cmo init sign in check + pick your default website
17
+ cmo workspaces [ls] | workspaces use <domain>
18
+ cmo inbox
19
+ cmo results [--period 7d|30d]
20
+ cmo ideas [ls] | add <url|text> | generate [-n 5] [--brief …] | import-sitemap [-n 10] [--sitemap <url>]
21
+ cmo ideas plan|discard|restore <id>
22
+ cmo posts [ls] [--status planned|draft|published] | show <id> | publish <id> | delete <id>
23
+ cmo social [ls] | approve <id…> | skip <id> | restore <id> | draft "<topic>" | pause | resume
24
+ cmo autopilot [status] | pause | resume
25
+ cmo keys [ls] cmo apps cmo open [path]
26
+ cmo connect api-pull [--key aicmo_…] [--write-env .env]
27
+ cmo tools every action, then: cmo run <tool> key=value…
28
+ cmo mcp local MCP server (stdio)
29
+ ```
30
+
31
+ Options for every command: `--json` (machine-readable), `-w, --workspace <domain>`, `-y, --yes` (don't ask before changes), `--dry-run` (show what a change would do).
32
+
33
+ Commands that change something show what will happen and ask first. In scripts, pass `--yes`; without a terminal and without `--yes`, nothing is changed.
34
+
35
+ Exit codes: `0` done · `2` wrong input · `3` not signed in · `4` plan, permission or daily limit · `5` server problem.
36
+
37
+ ## Signing in
38
+
39
+ - `cmo login` uses a device code: open the link, check the code, approve. The sign-in is stored in `~/.config/cmo/credentials.json` (readable only by you) and renews itself. `cmo logout` disconnects it; you can also remove it under Connected apps in your account.
40
+ - For CI, create an API key in your account settings and set `CMO_API_KEY`. It takes priority over `cmo login`. A read-only key can only run reads.
41
+ - `CMO_WORKSPACE` sets the default website for a script.
42
+
43
+ ## MCP
44
+
45
+ `cmo mcp` runs CMO.so as a local MCP server for Claude Desktop, Cursor, VS Code and others, signed in with `cmo login` or `CMO_API_KEY`. See [@cmo-so/mcp](https://www.npmjs.com/package/@cmo-so/mcp) for client configs, or connect the hosted server at `https://mcp.cmo.so/mcp` without installing anything.