@easysociable/cli 0.1.0 → 0.1.2

package/README.md

@@ -1,95 +1,64 @@
 # EasySociable CLI
 
-Gateway-only client for the V1 Template and Slideshow product. The package does
-not start a Local API, open SQLite, or ship a renderer.
-
-## End-user onboarding
+Agent-first CLI and MCP host for EasySociable Template and Slideshow V1.
+Gateway-only: no Local API, SQLite, or local renderer.
 
 ```bash
+npm i -g @easysociable/cli
+# or
 curl -fsSL https://easysociable.com/install.sh | bash
-easysociable install --yes
-# Tell your Agent what to make; auth login when Gateway asks for it.
-```
-
-Default `install` copies **Template + Slideshow** Skills only. Opt into Obsidian
-Content later:
-
-```bash
-easysociable install --skills content --yes
-```
-
-Lazy-auth guidance for Agents: [`../../skills/ONBOARDING.md`](../../skills/ONBOARDING.md).
-
-## Publishing to npm
-
-The package is **`@easysociable/cli`** on the public npm registry (`0.1.0+`).
-`prepack` copies `skills/` into the tarball so `easysociable install` works after
-a global install.
-
-Before the first publish:
-
-1. Log in: `npm login --registry=https://registry.npmjs.org/`
-2. Ensure the `@easysociable` scope exists on npm (org or user scope).
-3. Package is MIT-licensed (`LICENSE` in this directory).
-
-Dry-run the tarball:
-
-```bash
-pnpm easysociable:cli:pack
-```
-
-Publish (from repo root; runs `prepack` → build → upload):
-
-```bash
-pnpm easysociable:cli:publish
 ```
 
-Monorepo `.npmrc` may point at a mirror; `publishConfig.registry` in
-`apps/cli/package.json` forces **registry.npmjs.org** for this package only.
+Requires Node.js 20+.
 
-After publish, `install.sh` installs `@easysociable/cli@0.1.0` (override with
-`EASYSOCIABLE_VERSION`).
-
-## Monorepo development
-
-From the repository root:
+## Quick start
 
 ```bash
-pnpm install
-pnpm --filter @easysociable/cli build
-pnpm exec easysociable --help
+easysociable install --yes
+# Tell your Agent what to make.
+# Sign up and run auth login only when Gateway asks for it.
 ```
 
-Equivalent scoped invocation:
+Default `install` copies **Template + Slideshow** Skills and registers the
+unified MCP for Codex / Claude Code. Opt into the Obsidian Content Skill later:
 
 ```bash
-pnpm --filter @easysociable/cli exec easysociable --help
+easysociable install --skills content --yes
 ```
 
-After `pnpm install`, the workspace links `easysociable` into `node_modules/.bin`. Always invoke it through `pnpm exec easysociable` (or the scoped form above) unless you have globally linked the package.
-
-## Authentication and smoke flow
+Lazy-auth guidance for Agents lives in the package at `skills/ONBOARDING.md`
+(also installed into your host skills directory by `easysociable install`).
 
-Build the bundle and authenticate once:
+## Authentication
 
 ```bash
-pnpm --filter @easysociable/cli build
-pnpm exec easysociable auth login --api-key "$EASYSOCIABLE_API_KEY" --gateway-url http://127.0.0.1:8787
-pnpm exec easysociable templates list --json
-pnpm exec easysociable mcp serve --transport stdio
+easysociable auth login --api-key <key> --gateway-url https://gateway.easysociable.com
+easysociable auth status
+easysociable templates list --json
+easysociable mcp serve --transport stdio
 ```
 
-Human-readable diagnostics are written to stderr. With `--json`, stdout contains only the versioned JSON envelope.
-
-## Build output
+Human-readable diagnostics go to stderr. With `--json`, stdout is only the
+versioned JSON envelope.
 
-`pnpm --filter @easysociable/cli build` emits:
+## Common commands
 
-- `dist/easysociable.js` — bundled ESM executable (`bin` target)
+| Command | Purpose |
+|---------|---------|
+| `easysociable install [--yes] [--skills list]` | Install Skills + MCP |
+| `easysociable update [--yes] [--skills list]` | Update Skills + MCP |
+| `easysociable auth login --api-key <key>` | Store Gateway credentials |
+| `easysociable templates …` | Page Template drafts / catalog |
+| `easysociable brands …` | Workspace Brands (fonts, colors, logo) |
+| `easysociable profiles …` | Deprecated — use `brands` |
+| `easysociable themes …` | Deprecated — use `brands` |
+| `easysociable slideshows …` | List, create, update and render Slideshow Runs |
+| `easysociable renders …` | Single-page final render jobs |
+| `easysociable mcp serve --transport stdio` | Unified MCP server |
 
-The committed launcher at `bin/easysociable.js` loads the bundle after build. If the bundle is missing, it prints a build hint and exits non-zero.
+`--skills` accepts comma-separated short names: `content`, `template`,
+`slideshow` (default: `template,slideshow`).
 
-## Public installer script
+## License
 
-Source: [`../../scripts/install.sh`](../../scripts/install.sh) (host at
-`https://easysociable.com/install.sh`).
+MIT. See `LICENSE` in this package.