epismo 0.5.0 → 0.7.0

package/dist/program.js

@@ -9,8 +9,8 @@ import { deleteAlias, getAlias, listAliases, upsertAlias } from "./aliases.js";
 import { creditBalance, creditCheckout } from "./credits.js";
 import { CliError } from "./errors.js";
 import { addAgents, listAgents, removeAgents } from "./agents.js";
-import { createWorkspace, deleteWorkspaceMember, getWorkspaceCheckout, listWorkspaceMembers, updateWorkspace, upsertWorkspaceMember } from "./workspaces.js";
-import { addProjectMember, createProject, deleteProject, deleteProjectMember, listProjectMembers, listProjects, updateProject } from "./projects.js";
+import { createWorkspace, deleteWorkspaceMembers, getWorkspaceCheckout, listWorkspaceMembers, updateWorkspace, upsertWorkspaceMembers } from "./workspaces.js";
+import { addProjectMembers, createProject, deleteProject, deleteProjectMembers, listProjectMembers, listProjects, updateProject } from "./projects.js";
 import { createToken } from "./token.js";
 const TRACK_TYPES = ["task", "goal"];
 const PACK_TYPES = ["workflow", "context"];
@@ -31,15 +31,53 @@ function getExplicitOptionOverride(command, optionName, value) {
     }
     return value;
 }
-function buildSharingTargets(command, options) {
-    const targets = mergeDefined({}, {
-        projectIds: getExplicitOptionOverride(command, "projectIds", parseStringArrayInput(options.projectIds, "--project-ids")),
-        userIds: getExplicitOptionOverride(command, "userIds", parseStringArrayInput(options.userIds, "--user-ids")),
-        emails: getExplicitOptionOverride(command, "emails", parseStringArrayInput(options.emails, "--emails"))
-    });
-    return Object.keys(targets).length > 0
-        ? targets
-        : undefined;
+function buildScopeOption(command, options) {
+    const personalExplicit = getExplicitOptionOverride(command, "personal", options.personal);
+    const projectsExplicit = getExplicitOptionOverride(command, "projects", parseStringArrayInput(options.projects, "--projects"));
+    if (personalExplicit !== undefined && projectsExplicit !== undefined) {
+        throw new CliError({
+            code: "INVALID_INPUT",
+            message: "--personal and --projects cannot be combined."
+        });
+    }
+    if (personalExplicit === true) {
+        return { type: "personal" };
+    }
+    if (projectsExplicit !== undefined) {
+        const ids = projectsExplicit;
+        if (ids.length === 0) {
+            throw new CliError({
+                code: "INVALID_INPUT",
+                message: "--projects requires at least one project id."
+            });
+        }
+        return { type: "projects", ids };
+    }
+    return undefined;
+}
+function buildSharedWithOption(command, options) {
+    const values = getExplicitOptionOverride(command, "shareWith", parseStringArrayInput(options.shareWith, "--share-with"));
+    if (values === undefined) {
+        return undefined;
+    }
+    const emails = [];
+    const userIds = [];
+    for (const value of values) {
+        if (value.includes("@")) {
+            emails.push(value);
+        }
+        else {
+            userIds.push(value);
+        }
+    }
+    const result = {};
+    if (userIds.length > 0) {
+        result.userIds = userIds;
+    }
+    if (emails.length > 0) {
+        result.emails = emails;
+    }
+    return result;
 }
 function buildSearchTargets(command, options) {
     const targets = mergeDefined({}, {
@@ -104,9 +142,9 @@ Examples:
   epismo alias list
   epismo track search --query "bug"
   epismo pack search --query "meeting notes"
-  epismo pack get --id <id> --block-id b001
-  epismo pack get --alias @myproject
-  epismo pack get --alias @handle/myproject`);
+  epismo pack get <id> --block-id b001
+  epismo pack get @myproject
+  epismo pack get @handle/myproject`);
     program
         .command("login")
         .description("log in to Epismo; default flow uses email + OTP, or open a browser to sign in")
@@ -181,13 +219,13 @@ Example:
     workspace
         .command("use")
         .description("set the default workspace")
-        .requiredOption("--workspace-id <workspaceId>", "workspace id to set as default")
-        .action(async (options) => {
-        printJson(await useWorkspace({ workspaceId: options.workspaceId }));
+        .argument("<workspace-id>", "workspace id to set as default")
+        .action(async (workspaceId) => {
+        printJson(await useWorkspace({ workspaceId }));
     });
     workspace.commands.at(-1)?.addHelpText("after", `
 Example:
-  epismo workspace use --workspace-id <workspace-id>`);
+  epismo workspace use <workspace-id>`);
     workspace
         .command("clear")
         .description("clear the saved workspace (reverts to personal space)")
@@ -223,25 +261,25 @@ Examples:
     workspace
         .command("checkout")
         .description("get the billing URL for a workspace (to complete or retry payment)")
-        .requiredOption("--id <id>", "workspace id")
-        .action(async (options) => {
+        .argument("<workspace-id>", "workspace id")
+        .action(async (workspaceId) => {
         const context = await resolveContext();
-        printJson(await getWorkspaceCheckout(context, options.id));
+        printJson(await getWorkspaceCheckout(context, workspaceId));
     });
     workspace.commands.at(-1)?.addHelpText("after", `
 Examples:
-  epismo workspace checkout --id <workspace-id>`);
+  epismo workspace checkout <workspace-id>`);
     workspace
         .command("update")
         .description("update a workspace you own (PATCH — omitted fields are unchanged)")
+        .argument("<workspace-id>", "workspace id to update")
         .option("--input <input>", "JSON object, @file, or - for stdin")
-        .requiredOption("--id <id>", "workspace id to update")
         .option("--name <name>", "updated workspace name")
         .addOption(new Option("--plan <plan>", "basic | pro").choices(["basic", "pro"]))
-        .action(async (options) => {
+        .action(async (workspaceId, options) => {
         const payload = await resolveInput({ input: options.input }, { name: options.name, plan: options.plan });
         const context = await resolveContext();
-        printJson(await updateWorkspace(context, options.id, payload));
+        printJson(await updateWorkspace(context, workspaceId, payload));
     });
     const workspaceMember = workspace.command("member").description("manage workspace members");
     workspaceMember
@@ -254,34 +292,35 @@ Examples:
     workspaceMember
         .command("upsert")
         .description("add a workspace member or update the member role")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--user-id <userId>", "user id")
-        .addOption(new Option("--role <role>", "owner | admin | member").choices([
-        "owner",
-        "admin",
-        "member"
-    ]))
-        .action(async (options) => {
+        .argument("<user-ids>", "user id(s); comma-separated for multiple")
+        .addOption(new Option("--role <role>", "owner | admin | member")
+        .choices(["owner", "admin", "member"])
+        .makeOptionMandatory())
+        .action(async (userIdsArg, options) => {
+        const userIds = parseStringArrayInput(userIdsArg, "<user-ids>") ?? [];
+        if (userIds.length === 0) {
+            throw new CliError({
+                code: "INVALID_INPUT",
+                message: "At least one user id is required."
+            });
+        }
         const context = await resolveContext();
-        const payload = await resolveInput({ input: options.input }, {
-            workspaceId: context.workspaceId,
-            userId: options.userId,
-            role: options.role
-        });
-        printJson(await upsertWorkspaceMember(context, payload));
+        printJson(await upsertWorkspaceMembers(context, userIds, options.role));
     });
     workspaceMember
         .command("delete")
         .description("remove a workspace member")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--user-id <userId>", "user id")
-        .action(async (options) => {
+        .argument("<user-ids>", "user id(s); comma-separated for multiple")
+        .action(async (userIdsArg) => {
+        const userIds = parseStringArrayInput(userIdsArg, "<user-ids>") ?? [];
+        if (userIds.length === 0) {
+            throw new CliError({
+                code: "INVALID_INPUT",
+                message: "At least one user id is required."
+            });
+        }
         const context = await resolveContext();
-        const payload = await resolveInput({ input: options.input }, {
-            workspaceId: context.workspaceId,
-            userId: options.userId
-        });
-        printJson(await deleteWorkspaceMember(context, payload));
+        printJson(await deleteWorkspaceMembers(context, userIds));
     });
     const project = program.command("project").description("manage workspace projects");
     project
@@ -308,29 +347,25 @@ Examples:
     project
         .command("update")
         .description("update a project you can access (PATCH — omitted fields are unchanged)")
+        .argument("<project-id>", "project id to update")
         .option("--input <input>", "JSON object, @file, or - for stdin")
-        .requiredOption("--id <id>", "project id to update")
         .option("--name <name>", "updated project name")
         .option("--description <description>", "updated project description")
-        .action(async (options) => {
+        .action(async (projectId, options) => {
         const payload = await resolveInput(options, {
             name: options.name,
             description: options.description
         });
         const context = await resolveContext();
-        printJson(await updateProject(context, options.id, payload));
+        printJson(await updateProject(context, projectId, payload));
     });
     project
         .command("delete")
         .description("delete a project you can access in the selected workspace")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--id <id>", "project id")
-        .action(async (options) => {
-        const payload = await resolveInput(options, {
-            id: options.id
-        });
+        .argument("<project-id>", "project id")
+        .action(async (projectId) => {
         const context = await resolveContext();
-        printJson(await deleteProject(context, payload));
+        printJson(await deleteProject(context, projectId));
     });
     const projectMember = project.command("member").description("manage project members");
     projectMember
@@ -347,31 +382,39 @@ Examples:
     });
     projectMember
         .command("add")
-        .description("add a member to a project")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--project-id <projectId>", "project id")
-        .option("--user-id <userId>", "user id")
-        .action(async (options) => {
-        const payload = await resolveInput(options, {
-            projectId: options.projectId,
-            userId: options.userId
-        });
+        .description("add member(s) to a project")
+        .argument("<user-ids>", "user id(s); comma-separated for multiple")
+        .requiredOption("--project-id <projectId>", "project id")
+        .action(async (userIdsArg, options) => {
+        const userIds = parseStringArrayInput(userIdsArg, "<user-ids>") ?? [];
+        if (userIds.length === 0) {
+            throw new CliError({
+                code: "INVALID_INPUT",
+                message: "At least one user id is required."
+            });
+        }
         const context = await resolveContext();
-        printJson(await addProjectMember(context, payload));
+        printJson({
+            results: await addProjectMembers(context, options.projectId, userIds)
+        });
     });
     projectMember
         .command("delete")
-        .description("remove a user from a project")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--project-id <projectId>", "project id")
-        .option("--user-id <userId>", "user id")
-        .action(async (options) => {
-        const payload = await resolveInput(options, {
-            projectId: options.projectId,
-            userId: options.userId
-        });
+        .description("remove user(s) from a project")
+        .argument("<user-ids>", "user id(s); comma-separated for multiple")
+        .requiredOption("--project-id <projectId>", "project id")
+        .action(async (userIdsArg, options) => {
+        const userIds = parseStringArrayInput(userIdsArg, "<user-ids>") ?? [];
+        if (userIds.length === 0) {
+            throw new CliError({
+                code: "INVALID_INPUT",
+                message: "At least one user id is required."
+            });
+        }
         const context = await resolveContext();
-        printJson(await deleteProjectMember(context, payload));
+        printJson({
+            results: await deleteProjectMembers(context, options.projectId, userIds)
+        });
     });
     const track = program.command("track").description("manage project tracks (tasks and goals)");
     track
@@ -381,9 +424,9 @@ Examples:
         .addOption(new Option("--type <type>", "task | goal").choices(TRACK_TYPES))
         .option("--title <title>", "title")
         .option("--content <content>", "markdown content")
-        .option("--project-ids <projectIds>", "JSON array or comma-separated project ids")
-        .option("--user-ids <userIds>", "JSON array or comma-separated user ids")
-        .option("--emails <emails>", "JSON array or comma-separated email addresses")
+        .option("--personal", "keep private to the current user (mutually exclusive with --projects)")
+        .option("--projects <projects>", "JSON array or comma-separated project ids (mutually exclusive with --personal)")
+        .option("--share-with <shareWith>", "JSON array or comma-separated list of user ids and/or emails (values containing '@' are emails)")
         .option("--task <task>", 'task-specific fields as JSON object e.g. \'{"status":"todo","dueDate":"2025-12-31"}\'')
         .option("--goal <goal>", 'goal-specific fields as JSON object e.g. \'{"status":"on_track","dueDate":"2025-12-31"}\'')
         .action(async (options, command) => {
@@ -391,7 +434,8 @@ Examples:
             type: options.type,
             title: options.title,
             content: options.content,
-            targets: buildSharingTargets(command, options),
+            scope: buildScopeOption(command, options),
+            sharedWith: buildSharedWithOption(command, options),
             task: parseJsonObjectOption(options.task, "--task"),
             goal: parseJsonObjectOption(options.goal, "--goal")
         });
@@ -409,49 +453,47 @@ Examples:
     track
         .command("update")
         .description("update an existing project track (PATCH — omitted fields are unchanged)")
+        .argument("<id>", "track id to update")
         .option("--input <input>", "JSON object, @file, or - for stdin")
-        .requiredOption("--id <id>", "track id to update")
         .option("--title <title>", "updated title")
         .option("--content <content>", "updated markdown content")
-        .option("--project-ids <projectIds>", "JSON array or comma-separated project ids")
-        .option("--user-ids <userIds>", "JSON array or comma-separated user ids")
-        .option("--emails <emails>", "JSON array or comma-separated email addresses")
+        .option("--personal", "set scope to personal (mutually exclusive with --projects)")
+        .option("--projects <projects>", "JSON array or comma-separated project ids (mutually exclusive with --personal)")
+        .option("--share-with <shareWith>", "JSON array or comma-separated list of user ids and/or emails (values containing '@' are emails)")
         .option("--task <task>", 'task-specific fields as partial JSON object e.g. \'{"status":"done"}\'')
         .option("--goal <goal>", "goal-specific fields as partial JSON object e.g. '{\"progress\":50}'")
-        .action(async (options, command) => {
+        .action(async (id, options, command) => {
         const payload = await resolveInput(options, {
             title: options.title,
             content: options.content,
-            targets: buildSharingTargets(command, options),
+            scope: buildScopeOption(command, options),
+            sharedWith: buildSharedWithOption(command, options),
             task: parseJsonObjectOption(options.task, "--task"),
             goal: parseJsonObjectOption(options.goal, "--goal")
         });
         const context = await resolveContext();
-        printJson(await updateTrack(context, options.id, payload));
+        printJson(await updateTrack(context, id, payload));
     });
     track.commands.at(-1)?.addHelpText("after", `
 Notes:
   Omitted fields keep their existing value.
 
 Examples:
-  epismo track update --id <id> --title "Updated title"
-  epismo track update --id <id> --task '{"status":"done"}'
-  epismo track update --id <id> --goal '{"progress":75}'`);
+  epismo track update <id> --title "Updated title"
+  epismo track update <id> --task '{"status":"done"}'
+  epismo track update <id> --goal '{"progress":75}'`);
     track
         .command("get")
         .description("fetch one project track")
+        .argument("<id>", "track id")
         .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--id <id>", "item id")
-        .action(async (options) => {
-        const payload = await resolveInput(options, {
-            id: options.id
-        });
+        .action(async (id) => {
         const context = await resolveContext();
-        printJson(await getTrack(context, payload));
+        printJson(await getTrack(context, id));
     });
     track.commands.at(-1)?.addHelpText("after", `
 Example:
-  epismo track get --id <id>`);
+  epismo track get <id>`);
     track
         .command("search")
         .description("search project tracks")
@@ -482,28 +524,25 @@ Examples:
     track
         .command("delete")
         .description("delete one project track")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--id <id>", "item id")
-        .action(async (options) => {
-        const payload = await resolveInput(options, {
-            id: options.id
-        });
+        .argument("<id>", "track id")
+        .action(async (id) => {
         const context = await resolveContext();
-        printJson(await deleteTrack(context, payload));
+        printJson(await deleteTrack(context, id));
     });
     track.commands.at(-1)?.addHelpText("after", `
 Example:
-  epismo track delete --id <id>`);
+  epismo track delete <id>`);
     track
         .command("apply")
         .description("create, update, and delete multiple tracks in a single request")
         .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--project-ids <projectIds>", "JSON array or comma-separated project ids")
-        .option("--user-ids <userIds>", "JSON array or comma-separated user ids")
-        .option("--emails <emails>", "JSON array or comma-separated email addresses")
+        .option("--personal", "set scope to personal (mutually exclusive with --projects)")
+        .option("--projects <projects>", "JSON array or comma-separated project ids (mutually exclusive with --personal)")
+        .option("--share-with <shareWith>", "JSON array or comma-separated list of user ids and/or emails (values containing '@' are emails)")
         .action(async (options, command) => {
         const payload = await resolveInput(options, {
-            targets: buildSharingTargets(command, options)
+            scope: buildScopeOption(command, options),
+            sharedWith: buildSharedWithOption(command, options)
         });
         const context = await resolveContext();
         printJson(await applyTracks(context, payload));
@@ -527,9 +566,9 @@ Examples:
         .option("--content <content>", "markdown content")
         .option("--category <category>", "pack category")
         .addOption(new Option("--visibility <visibility>", "public | private").choices(PACK_VISIBILITIES))
-        .option("--project-ids <projectIds>", "JSON array or comma-separated project ids")
-        .option("--user-ids <userIds>", "JSON array or comma-separated user ids")
-        .option("--emails <emails>", "JSON array or comma-separated email addresses")
+        .option("--personal", "keep private to the current user (mutually exclusive with --projects)")
+        .option("--projects <projects>", "JSON array or comma-separated project ids (mutually exclusive with --personal)")
+        .option("--share-with <shareWith>", "JSON array or comma-separated list of user ids and/or emails (values containing '@' are emails)")
         .option("--steps <steps>", "workflow steps as JSON array (use --input @file.json for complex payloads)")
         .option("--blocks <blocks>", "context blocks as JSON array (for type=context; use --input @file.json for complex payloads)")
         .action(async (options, command) => {
@@ -539,7 +578,8 @@ Examples:
             content: options.content,
             category: options.category,
             visibility: options.visibility,
-            targets: buildSharingTargets(command, options),
+            scope: buildScopeOption(command, options),
+            sharedWith: buildSharedWithOption(command, options),
             steps: parseJsonArrayOption(options.steps, "--steps"),
             blocks: parseJsonArrayOption(options.blocks, "--blocks")
         });
@@ -564,29 +604,30 @@ Examples:
   epismo pack create --type context --title "My context" --blocks '[{"title":"Block 1","content":"..."}]'`);
     pack.command("update")
         .description("update an existing agent pack (PATCH semantics — omitted fields are unchanged)")
-        .requiredOption("--id <id>", "pack id to update")
+        .argument("<reference>", "pack reference: id, alias, share URL, or hub URL")
         .option("--input <input>", "JSON object, @file, or - for stdin")
         .option("--title <title>", "updated title")
         .option("--content <content>", "updated markdown content")
         .option("--category <category>", "updated pack category")
         .addOption(new Option("--visibility <visibility>", "public | private").choices(PACK_VISIBILITIES))
-        .option("--project-ids <projectIds>", "JSON array or comma-separated project ids")
-        .option("--user-ids <userIds>", "JSON array or comma-separated user ids")
-        .option("--emails <emails>", "JSON array or comma-separated email addresses")
+        .option("--personal", "set scope to personal (mutually exclusive with --projects)")
+        .option("--projects <projects>", "JSON array or comma-separated project ids (mutually exclusive with --personal)")
+        .option("--share-with <shareWith>", "JSON array or comma-separated list of user ids and/or emails (values containing '@' are emails)")
         .option("--steps <steps>", 'step operations as JSON array with op field: [{"op":"add","title":"..."},{"op":"update","id":"s001","content":"..."},{"op":"remove","id":"s002"}]')
         .option("--blocks <blocks>", 'block operations as JSON array with op field: [{"op":"add","title":"..."},{"op":"update","id":"b001","content":"..."},{"op":"remove","id":"b002"}]')
-        .action(async (options, command) => {
+        .action(async (reference, options, command) => {
         const payload = await resolveInput(options, {
             title: options.title,
             content: options.content,
             category: options.category,
             visibility: options.visibility,
-            targets: buildSharingTargets(command, options),
+            scope: buildScopeOption(command, options),
+            sharedWith: buildSharedWithOption(command, options),
             steps: parseJsonArrayOption(options.steps, "--steps"),
             blocks: parseJsonArrayOption(options.blocks, "--blocks")
         });
         const context = await resolveContext();
-        printJson(await updatePack(context, options.id, payload));
+        printJson(await updatePack(context, reference, payload));
     });
     pack.commands.at(-1)?.addHelpText("after", `
 Notes:
@@ -596,41 +637,41 @@ Notes:
   To remove all items, send a remove op for each existing item ID.
 
 Examples:
-  epismo pack update --id <id> --category ""
-  epismo pack update --id <id> --visibility public --category productivity
-  epismo pack update --id <id> --blocks '[{"op":"add","title":"New Block","content":"..."}]'
-  epismo pack update --id <id> --blocks '[{"op":"update","id":"b001","content":"updated..."}]'
-  epismo pack update --id <id> --blocks '[{"op":"remove","id":"b002"}]'
-  epismo pack update --id <id> --input @changes.json`);
+  epismo pack update <id> --category ""
+  epismo pack update @myproject --visibility public
+  epismo pack update <id> --visibility public --category productivity
+  epismo pack update <id> --blocks '[{"op":"add","title":"New Block","content":"..."}]'
+  epismo pack update <id> --blocks '[{"op":"update","id":"b001","content":"updated..."}]'
+  epismo pack update <id> --blocks '[{"op":"remove","id":"b002"}]'
+  epismo pack update <id> --input @changes.json`);
     pack.command("get")
         .description("fetch one agent pack")
+        .argument("<reference>", "pack reference: id, alias, share URL, or hub URL")
         .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--id <id>", "pack id")
-        .addOption(new Option("--alias <alias>", "pack alias (`@alias` or `@handle/alias`)").conflicts("id"))
         .option("--full", "include nested item content")
         .option("--block-id <blockId>", "context block id to extract; comma-separated or repeatable (type=context only)", collectOption)
         .option("--step-id <stepId>", "workflow step id to extract; comma-separated or repeatable (type=workflow only)", collectOption)
-        .action(async (options) => {
+        .action(async (reference, options) => {
         const payload = await resolveInput(options, {
-            id: options.id,
-            alias: options.alias,
             full: options.full ? true : undefined
         });
         const context = await resolveContext();
-        printJson(await getPack(context, payload, {
+        printJson(await getPack(context, reference, payload, {
             blockIds: options.blockId,
             stepIds: options.stepId
         }));
     });
     pack.commands.at(-1)?.addHelpText("after", `
 	Examples:
-	  epismo pack get --id <id>
-	  epismo pack get --alias @myproject
-	  epismo pack get --alias @handle/myproject
-	  epismo pack get --id <id> --full
-	  epismo pack get --id <id> --block-id b001
-	  epismo pack get --id <id> --block-id b001 --block-id b002
-	  epismo pack get --id <id> --step-id s001,s002`);
+	  epismo pack get <id>
+	  epismo pack get @myproject
+	  epismo pack get @handle/myproject
+	  epismo pack get https://epismo.ai/share/<token>
+	  epismo pack get https://epismo.ai/hub/workflows/<id>
+	  epismo pack get <id> --full
+	  epismo pack get <id> --block-id b001
+	  epismo pack get <id> --block-id b001 --block-id b002
+	  epismo pack get <id> --step-id s001,s002`);
     pack.command("search")
         .description("search agent packs")
         .option("--input <input>", "JSON object, @file, or - for stdin")
@@ -659,13 +700,12 @@ Examples:
   epismo pack search --type context --query "meeting notes"`);
     pack.command("like")
         .description("like or unlike an agent pack")
+        .argument("<reference>", "pack reference: id, alias, share URL, or hub URL")
         .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--id <id>", "pack id")
         .option("--liked", "mark as liked")
         .option("--no-liked", "remove like")
-        .action(async (options) => {
+        .action(async (reference, options) => {
         const payload = await resolveInput(options, {
-            id: options.id,
             liked: options.liked
         });
         if (typeof payload.liked !== "boolean") {
@@ -676,26 +716,25 @@ Examples:
             });
         }
         const context = await resolveContext();
-        printJson(await likePack(context, payload));
+        printJson(await likePack(context, reference, payload));
     });
     pack.commands.at(-1)?.addHelpText("after", `
 Examples:
-  epismo pack like --id <id> --liked
-  epismo pack like --id <id> --no-liked`);
+  epismo pack like <id> --liked
+  epismo pack like @myproject --liked
+  epismo pack like <id> --no-liked`);
     pack.command("delete")
         .description("delete one agent pack and any of your aliases that point to it")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--id <id>", "pack id")
-        .action(async (options) => {
-        const payload = await resolveInput(options, {
-            id: options.id
-        });
+        .argument("<reference>", "pack reference: id, alias, share URL, or hub URL")
+        .action(async (reference) => {
         const context = await resolveContext();
-        printJson(await deletePack(context, payload));
+        printJson(await deletePack(context, reference));
     });
     pack.commands.at(-1)?.addHelpText("after", `
 Examples:
-  epismo pack delete --id <id>   # also removes your aliases for that pack`);
+  epismo pack delete <id>   # also removes your aliases for that pack
+  epismo pack delete @myproject
+  epismo pack delete https://epismo.ai/share/<token>`);
     const agent = program.command("agent").description("manage agent availability");
     agent
         .command("list")
@@ -769,39 +808,35 @@ Example:
     alias
         .command("upsert")
         .description("create or update one alias")
+        .argument("<alias>", "alias name (`alias` or `@alias`; stored without `@`)")
         .option("--input <input>", "JSON object, @file, or - for stdin")
         .addOption(new Option("--type <type>", "workflow | context").choices(PACK_TYPES))
         .option("--id <id>", "target pack id")
-        .option("--alias <alias>", "alias name (`alias` or `@alias`; stored without `@`)")
-        .action(async (options) => {
+        .action(async (aliasName, options) => {
         const payload = await resolveInput(options, {
             type: options.type,
             id: options.id,
-            alias: options.alias
+            alias: aliasName
         });
         const context = await resolveContext();
         printJson(await upsertAlias(context, payload));
     });
     alias.commands.at(-1)?.addHelpText("after", `
 Examples:
-  epismo alias upsert --type workflow --id <id> --alias @myproject
-  epismo alias upsert --type context --id <id> --alias @mycontext`);
+  epismo alias upsert @myproject --type workflow --id <id>
+  epismo alias upsert @mycontext --type context --id <id>`);
     alias
         .command("get")
         .description("resolve one alias")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--alias <alias>", "alias reference (`@alias` or `@handle/alias`)")
-        .action(async (options) => {
-        const payload = await resolveInput(options, {
-            alias: options.alias
-        });
+        .argument("<alias>", "alias reference (`@alias` or `@handle/alias`)")
+        .action(async (aliasRef) => {
         const context = await resolveContext();
-        printJson(await getAlias(context, payload));
+        printJson(await getAlias(context, { alias: aliasRef }));
     });
     alias.commands.at(-1)?.addHelpText("after", `
 Examples:
-  epismo alias get --alias @myproject
-  epismo alias get --alias @handle/myproject`);
+  epismo alias get @myproject
+  epismo alias get @handle/myproject`);
     alias
         .command("list")
         .description("list your aliases")
@@ -817,18 +852,14 @@ Example:
     alias
         .command("delete")
         .description("delete one alias")
-        .option("--input <input>", "JSON object, @file, or - for stdin")
-        .option("--alias <alias>", "alias name (`alias` or `@alias`; stored without `@`)")
-        .action(async (options) => {
-        const payload = await resolveInput(options, {
-            alias: options.alias
-        });
+        .argument("<alias>", "alias name (`alias` or `@alias`; stored without `@`)")
+        .action(async (aliasName) => {
         const context = await resolveContext();
-        printJson(await deleteAlias(context, payload));
+        printJson(await deleteAlias(context, { alias: aliasName }));
     });
     alias.commands.at(-1)?.addHelpText("after", `
 Example:
-  epismo alias delete --alias @myproject`);
+  epismo alias delete @myproject`);
     const token = program.command("token").description("manage CLI tokens for CI/CD");
     token
         .command("create")