@easysociable/cli 0.1.2 → 0.1.3

package/README.md

@@ -1,7 +1,6 @@
 # EasySociable CLI
 
-Agent-first CLI and MCP host for EasySociable Template and Slideshow V1.
-Gateway-only: no Local API, SQLite, or local renderer.
+Agent-first CLI for EasySociable: local Content Engine, Template, Slideshow, and MCP.
 
 ```bash
 npm i -g @easysociable/cli
@@ -9,25 +8,41 @@ npm i -g @easysociable/cli
 curl -fsSL https://easysociable.com/install.sh | bash
 ```
 
-Requires Node.js 20+.
+Requires Node.js 20+. Content Engine workbench also needs `python3`.
 
 ## Quick start
 
 ```bash
+# Visual skills + MCP for Codex / Claude Code
 easysociable install --yes
-# Tell your Agent what to make.
-# Sign up and run auth login only when Gateway asks for it.
+
+# Local content engine (markdown + workbench) — no Agent host required
+easysociable engine init --root /workspace --yes
+easysociable engine serve --engine /workspace/Content Engine --no-open
 ```
 
-Default `install` copies **Template + Slideshow** Skills and registers the
-unified MCP for Codex / Claude Code. Opt into the Obsidian Content Skill later:
+Then tell the Agent to follow `Content Engine/CLAUDE.md`.
+
+Optional pointer skill for hosts that discover work via SKILL.md:
 
 ```bash
-easysociable install --skills content --yes
+easysociable install --skills content,template,slideshow --yes
 ```
 
-Lazy-auth guidance for Agents lives in the package at `skills/ONBOARDING.md`
-(also installed into your host skills directory by `easysociable install`).
+Lazy-auth guidance lives in the package at `skills/ONBOARDING.md`.
+
+## Content Engine
+
+| Command | Purpose |
+|---------|---------|
+| `easysociable engine init [--root] [--yes] [--serve]` | Scaffold starter (never overwrites) |
+| `easysociable engine serve [--engine] [--no-open]` | Build + start workbench on `:8765` |
+| `easysociable engine build [--engine]` | Rebuild `workbench/index.html` |
+| `easysociable engine detect` | Find engines under search roots |
+| `easysociable engine validate --root …` | Starter completeness |
+| `easysociable engine validate --run …` | Run / pack checks before render |
+
+Default `--root` / `--engine` parent is `/workspace` when that directory exists, otherwise the current working directory.
 
 ## Authentication
 
@@ -38,26 +53,19 @@ easysociable templates list --json
 easysociable mcp serve --transport stdio
 ```
 
-Human-readable diagnostics go to stderr. With `--json`, stdout is only the
-versioned JSON envelope.
-
-## Common commands
+## Other commands
 
 | 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 brands …` | Workspace Brands |
+| `easysociable slideshows …` | Slideshow Runs |
 | `easysociable renders …` | Single-page final render jobs |
 | `easysociable mcp serve --transport stdio` | Unified MCP server |
 
-`--skills` accepts comma-separated short names: `content`, `template`,
-`slideshow` (default: `template,slideshow`).
+`--skills` accepts: `content`, `template`, `slideshow` (default: `template,slideshow`).
 
 ## License