shiply-cli 0.20.2 → 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.2",
+  "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**
 
 ---
 
@@ -658,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