@easysociable/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EasySociable
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# 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
+
+```bash
+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.
+
+After publish, `install.sh` installs `@easysociable/cli@0.1.0` (override with
+`EASYSOCIABLE_VERSION`).
+
+## Monorepo development
+
+From the repository root:
+
+```bash
+pnpm install
+pnpm --filter @easysociable/cli build
+pnpm exec easysociable --help
+```
+
+Equivalent scoped invocation:
+
+```bash
+pnpm --filter @easysociable/cli exec easysociable --help
+```
+
+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
+
+Build the bundle and authenticate once:
+
+```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
+```
+
+Human-readable diagnostics are written to stderr. With `--json`, stdout contains only the versioned JSON envelope.
+
+## Build output
+
+`pnpm --filter @easysociable/cli build` emits:
+
+- `dist/easysociable.js` — bundled ESM executable (`bin` target)
+
+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.
+
+## Public installer script
+
+Source: [`../../scripts/install.sh`](../../scripts/install.sh) (host at
+`https://easysociable.com/install.sh`).

package/bin/easysociable.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { existsSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const bundlePath = join(dirname(fileURLToPath(import.meta.url)), '..', 'dist', 'easysociable.js')
+
+if (!existsSync(bundlePath)) {
+  process.stderr.write(
+    'EasySociable CLI bundle is missing. Run: pnpm --filter @easysociable/cli build\n',
+  )
+  process.exit(1)
+}
+
+await import(bundlePath)