shiply-cli 0.20.1 → 0.21.0

package/dist/clients.js

@@ -0,0 +1,48 @@
+import { api, resolveBase } from './publish.js';
+import { loadApiKey } from './config.js';
+const hdr = (apiKey) => ({
+    'content-type': 'application/json',
+    ...(apiKey ? { authorization: `Bearer ${apiKey}` } : {}),
+});
+/** Turn a `--client "<name-or-email>"` flag into the API's client object.
+ *  An '@' means email (create-or-find by it); otherwise a display name. */
+export function parseClientArg(value) {
+    const v = value?.trim();
+    if (!v)
+        return undefined;
+    return v.includes('@') ? { clientEmail: v } : { clientName: v };
+}
+/** `shiply client ls | show <id>` — read-only view of your clients. */
+export async function runClient(args, opts) {
+    const sub = args[0] ?? 'ls';
+    const base = resolveBase(opts.base);
+    const apiKey = opts.key ?? (await loadApiKey());
+    if (!apiKey)
+        throw new Error('`shiply client` needs an API key — run `shiply login` or pass --key');
+    if (sub === 'ls') {
+        const { clients } = await api(`${base}/api/v1/clients`, { headers: hdr(apiKey) });
+        if (clients.length === 0) {
+            console.log('  no clients yet — pass --client on publish or create an intake to add one');
+            return;
+        }
+        for (const c of clients) {
+            const meta = [c.company, c.email].filter(Boolean).join(' · ');
+            console.log(`  ${c.id}  ${c.name}${meta ? `  (${meta})` : ''}  [${c.status}]`);
+        }
+        return;
+    }
+    if (sub === 'show') {
+        const id = args[1];
+        if (!id)
+            throw new Error('usage: shiply client show <id>');
+        const r = await api(`${base}/api/v1/clients/${encodeURIComponent(id)}`, { headers: hdr(apiKey) });
+        console.log(`${r.client.name}${r.client.company ? ` · ${r.client.company}` : ''}`);
+        if (r.client.email)
+            console.log(`  ${r.client.email}`);
+        console.log(`  sites    (${r.sites.length}): ${r.sites.map((s) => s.slug).join(', ') || '—'}`);
+        console.log(`  folders  (${r.drives.length}): ${r.drives.map((d) => d.name).join(', ') || '—'}`);
+        console.log(`  projects (${r.projects.length}): ${r.projects.map((p) => `${p.label} [${p.status}]`).join(', ') || '—'}`);
+        return;
+    }
+    throw new Error(`unknown client command '${sub}' — try: ls, show <id>`);
+}

package/dist/index.js

@@ -16,6 +16,7 @@ import { dbAttach, dbBranch, dbBranches, dbCreate, dbDelete, dbDeleteBranch, dbL
 import { driveGet, driveLs, drivePublish, drivePut, driveRm } from './drive.js';
 import { domainAdd, domainConnect, domainLs, domainPrimary, domainSubAdd, domainSync } from './domain.js';
 import { runProject } from './projects.js';
+import { runClient, parseClientArg } from './clients.js';
 import { runListing } from './listings.js';
 import { runSendingDomain } from './sending-domains.js';
 import { contractAmend, contractDraft, contractList, contractPdf, contractRetract, contractSend, contractShow, } from './contract.js';
@@ -82,6 +83,9 @@ Usage:
                                               Customer-intake projects + AI brief generator
   shiply project create <label> [--customer-email <e>] [--customer-name <n>]
                                               Returns the intake URL to share with the customer
+  shiply client <ls|show <id>>                Your clients (freelancer view): customer-360 roll-up
+  shiply publish <dir> --client "<name|email>"
+                                              Group the site under a client (create-or-finds by email)
   shiply listing <ls|create|rm>               Marketplace listings (sell built sites)
   shiply listing create <site-slug> --price <cents> --jurisdiction "<region>"
                                               Requires Stripe Connect onboarding (see MCP get_connect_status)
@@ -257,6 +261,7 @@ async function main() {
             'no-notify': { type: 'boolean' },
             'notify-to': { type: 'string' },
             from: { type: 'string' },
+            client: { type: 'string' },
             help: { type: 'boolean', short: 'h' },
             version: { type: 'boolean', short: 'v' },
         },
@@ -347,6 +352,8 @@ async function main() {
                     slug,
                     attachDatabaseId,
                     previewBranchDbId,
+                    // Group under a client (owned publishes only). --client "<name|email>"
+                    client: apiKey ? parseClientArg(values.client) : undefined,
                 });
                 await writeState(stateDir, {
                     slug: res.slug,
@@ -734,6 +741,10 @@ async function main() {
             await runProject(positionals.slice(1));
             break;
         }
+        case 'client': {
+            await runClient(positionals.slice(1), { base: values.base, key: values.key });
+            break;
+        }
         case 'listing': {
             await runListing(positionals.slice(1));
             break;

package/dist/publish.js

@@ -42,6 +42,7 @@ export async function publish(dir, opts = {}) {
             ...(opts.slug ? { slug: opts.slug } : {}),
             ...(opts.attachDatabaseId ? { attachDatabaseId: opts.attachDatabaseId } : {}),
             ...(opts.previewBranchDbId ? { previewBranchDbId: opts.previewBranchDbId } : {}),
+            ...(opts.client ? { client: opts.client } : {}),
         }),
     });
     await uploadAll(dir, created.upload.uploads);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shiply-cli",
-  "version": "0.20.1",
+  "version": "0.21.0",
   "description": "Publish static sites to shiply.now from the command line — instant web hosting for agents.",
   "license": "MIT",
   "type": "module",

package/skill/SKILL.md

@@ -18,7 +18,7 @@ description: "shiply is the production backend for anything an agent builds —
 > fresh — your cached copy may be missing features like databases, projects,
 > marketplace, or sending domains.
 >
-> **Last updated: 2026-06-27**
+> **Last updated: 2026-06-28**
 
 ---
 
@@ -64,14 +64,25 @@ POST https://shiply.now/api/v1/auth/device/poll
 ```
 
 The response is one of `{status:"pending"}` (keep polling at `interval`s),
-`{status:"approved", api_key:"shp_...", slug_claimed:"..."}` (save the key as
-`SHIPLY_API_KEY`, the site is now permanent — Allow does both jobs in one
-click), `{status:"expired"|"denied"|"consumed"}` (stop). Cap your polling at
+`{status:"approved", api_key:"shp_...", slug_claimed:"..."}` (PERSIST the key —
+see "Save the key" below — the site is now permanent; Allow does both jobs in
+one click), `{status:"expired"|"denied"|"consumed"}` (stop). Cap your polling at
 the announced `expires_in` and respect `interval` — don't tight-loop.
 
 After approval, every future publish uses `Authorization: Bearer <api_key>`
 and the user's dashboard shows their sites without any further claiming.
 
+### Save the key — so EVERY future site is seamless (do this once)
+
+Write the key to **`~/.shiply/credentials`** as `{"apiKey":"shp_..."}` (chmod
+600) — the exact file the shiply CLI reads. This is what makes "one Allow, ever"
+work: from then on every publish (any site, any project, ANY FUTURE SESSION)
+sends `Authorization: Bearer <key>` automatically and lands owned in the user's
+dashboard — no re-authorizing, no claim step, zero clicks. An env var alone
+(`SHIPLY_API_KEY`) works for the current shell but does NOT survive a new
+session — the credentials file is what makes it permanent. `shiply login` writes
+this file for you; if you publish over raw HTTP, write it yourself.
+
 ## When the user pastes you something shiply-shaped, do this
 
 These are the patterns you will see. Match the input, run the action — do not
@@ -94,10 +105,11 @@ ask the user to repeat themselves or explain.
   as `https://shiply.now/claim/<slug>?token=<claimToken>` from those fields.
   Either way, also suggest `shiply login` so future publishes mint to their
   account directly — that's the long-term fix and how the dashboard works.
-- **User says "I have an API key now, use it from now on"** → save it as
-  `SHIPLY_API_KEY` in your environment / config and send
-  `Authorization: Bearer <key>` on every future publish. All future sites
-  are then permanent and appear in their dashboard automatically.
+- **User says "I have an API key now, use it from now on"** → persist it to
+  `~/.shiply/credentials` (`{"apiKey":"shp_..."}`, chmod 600 — see "Save the
+  key" above), then send `Authorization: Bearer <key>` on every future publish.
+  All future sites are then permanent and appear in their dashboard
+  automatically — across sessions, with no re-authorizing.
 - **User opens an `https://shiply.now/auth/XXXX-YYYY` URL you printed** → no
   action from you; they're on the device-flow consent screen. Keep polling
   `poll_url` (see "First publish on a new machine" above). The poll response
@@ -646,6 +658,21 @@ CLI: `shiply project ls · shiply project create <label> [--customer-email <e>]
 
 Docs: https://shiply.now/docs/projects
 
+**Group work by client (optional, for freelancers).** Building sites for
+clients? Pass an optional `client` (a name or email) on any `publish_site`,
+`create_drive`, or `create_project` call — shiply create-or-finds the client
+by email and files everything you ship for them (sites, drop-box, intake,
+contracts) under one customer view in the dashboard. A project's customer **is**
+the site's client (same email-keyed identity), so `create_project` already
+links automatically whenever you pass `customerEmail` — no extra step. There is
+no `create_client` tool and never a CRM step: the client record self-assembles
+from the calls you already make. `publish_site` echoes the `resolvedClientId` —
+reuse it across the session so drive/intake/contract all land under the same
+client. List calls take an optional `clientId` filter
+(`list_sites`/`list_drives`/`list_projects`). Omit `client` for personal
+projects; shiply works identically. CLI: `--client "<name-or-email>"` on
+publish/drive/project, plus `shiply client ls|show`.
+
 ## Contracts — draft, sign, amend (extends Projects)
 
 Once a project reaches `brief_ready`, the dev drafts a signed contract from