@rerout/cli 0.1.0 → 0.2.0

package/README.md

@@ -39,6 +39,10 @@ rerout webhooks ls
 rerout webhooks create --name "Orders" --url https://example.com/hook \
   --events link.created,link.clicked
 rerout webhooks rm wh_...
+rerout tags ls                                  # tags with link counts
+rerout tags create "Spring 2026" --color teal
+rerout tags update tag_... --name "Spring '26"
+rerout tags rm tag_...
 ```
 
 Add `--json` to any command for raw, machine-readable output.
@@ -56,8 +60,6 @@ The reusable pieces (config, client factory, formatting) are exported from
 `@rerout/cli/core` so other surfaces — like the planned Raycast extension — can
 share one engine instead of re-implementing auth and rendering.
 
-> Note: tag management is not yet exposed here; it lands once `@rerout/sdk` adds
-> a `tags` namespace for the `/v1/projects/me/tags` endpoints.
 
 ## Publishing
 

package/dist/cli.js

@@ -8,6 +8,7 @@ import { createLink, getLink, listLinks, removeLink, updateLink, } from './comma
 import { linkStats, projectStats, whoami } from './commands/project.js';
 import { qr } from './commands/qr.js';
 import { createWebhook, listWebhooks, removeWebhook } from './commands/webhooks.js';
+import { createTag, listTags, removeTag, updateTag } from './commands/tags.js';
 const program = new Command();
 program
     .name('rerout')
@@ -152,6 +153,43 @@ webhooks
     .action(async (endpointId, opts) => {
     await removeWebhook(createClient(), endpointId, opts, consoleIO);
 });
+const tags = program.command('tags').description('Manage project tags.');
+tags
+    .command('ls')
+    .alias('list')
+    .description('List tags with their link counts.')
+    .option('--json', 'Output raw JSON')
+    .action(async (opts) => {
+    await listTags(createClient(), opts, consoleIO);
+});
+tags
+    .command('create')
+    .description('Create a tag.')
+    .argument('<name>', 'Tag name')
+    .option('--color <color>', 'Tag color (server validates; defaults to teal)')
+    .option('--json', 'Output raw JSON')
+    .action(async (name, opts) => {
+    await createTag(createClient(), name, opts, consoleIO);
+});
+tags
+    .command('update')
+    .description('Update a tag.')
+    .argument('<tag_id>', 'Tag id')
+    .option('--name <name>', 'New tag name')
+    .option('--color <color>', 'New tag color')
+    .option('--json', 'Output raw JSON')
+    .action(async (tagId, opts) => {
+    await updateTag(createClient(), tagId, opts, consoleIO);
+});
+tags
+    .command('rm')
+    .alias('delete')
+    .description('Delete a tag.')
+    .argument('<tag_id>', 'Tag id')
+    .option('--json', 'Output raw JSON')
+    .action(async (tagId, opts) => {
+    await removeTag(createClient(), tagId, opts, consoleIO);
+});
 async function main() {
     try {
         await program.parseAsync(process.argv);

package/dist/commands/tags.d.ts

@@ -0,0 +1,19 @@
+import type { Rerout } from '@rerout/sdk';
+import { type IO } from '../core/format.js';
+export declare function listTags(client: Rerout, opts: {
+    json?: boolean;
+}, io: IO): Promise<void>;
+export interface CreateTagOptions {
+    color?: string;
+    json?: boolean;
+}
+export declare function createTag(client: Rerout, name: string, opts: CreateTagOptions, io: IO): Promise<void>;
+export interface UpdateTagOptions {
+    name?: string;
+    color?: string;
+    json?: boolean;
+}
+export declare function updateTag(client: Rerout, tagId: string, opts: UpdateTagOptions, io: IO): Promise<void>;
+export declare function removeTag(client: Rerout, tagId: string, opts: {
+    json?: boolean;
+}, io: IO): Promise<void>;

package/dist/commands/tags.js

@@ -0,0 +1,44 @@
+import { formatTagsTable } from '../core/format.js';
+export async function listTags(client, opts, io) {
+    const result = await client.tags.list();
+    if (opts.json) {
+        io.json(result);
+        return;
+    }
+    io.out(formatTagsTable(result.tags));
+}
+export async function createTag(client, name, opts, io) {
+    const input = { name };
+    if (opts.color !== undefined)
+        input.color = opts.color;
+    const tag = await client.tags.create(input);
+    if (opts.json) {
+        io.json(tag);
+        return;
+    }
+    io.out(`Created ${tag.name} (${tag.id})`);
+}
+export async function updateTag(client, tagId, opts, io) {
+    const input = {};
+    if (opts.name !== undefined)
+        input.name = opts.name;
+    if (opts.color !== undefined)
+        input.color = opts.color;
+    if (input.name === undefined && input.color === undefined) {
+        throw new Error('Nothing to update. Pass at least one of --name or --color.');
+    }
+    const tag = await client.tags.update(tagId, input);
+    if (opts.json) {
+        io.json(tag);
+        return;
+    }
+    io.out(`Updated ${tag.name} (${tag.id})`);
+}
+export async function removeTag(client, tagId, opts, io) {
+    const result = await client.tags.delete(tagId);
+    if (opts.json) {
+        io.json(result);
+        return;
+    }
+    io.out(result.deleted ? `Deleted ${tagId}.` : `Nothing deleted for ${tagId}.`);
+}

package/dist/core/format.d.ts

@@ -1,4 +1,4 @@
-import type { Link } from '@rerout/sdk';
+import type { Link, TagSummary } from '@rerout/sdk';
 /** Sink for command output so commands stay testable (no direct console use). */
 export interface IO {
     out(line: string): void;
@@ -13,3 +13,5 @@ export declare function formatTimestamp(seconds: number | null | undefined): str
 export declare function formatLinkLine(link: Link): string;
 /** Compact, aligned table of links for `rerout ls`. */
 export declare function formatLinksTable(links: Link[]): string;
+/** Compact, aligned table of tags for `rerout tags ls`. */
+export declare function formatTagsTable(tags: TagSummary[]): string;

package/dist/core/format.js

@@ -33,3 +33,18 @@ export function formatLinksTable(links) {
 function truncate(value, max) {
     return value.length > max ? `${value.slice(0, max - 1)}…` : value;
 }
+/** Compact, aligned table of tags for `rerout tags ls`. */
+export function formatTagsTable(tags) {
+    if (tags.length === 0)
+        return 'No tags yet.';
+    const rows = tags.map((t) => [
+        t.name,
+        t.color,
+        String(t.link_count),
+        t.id,
+    ]);
+    const headers = ['NAME', 'COLOR', 'LINKS', 'ID'];
+    const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+    const render = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join('  ').trimEnd();
+    return [render(headers), ...rows.map(render)].join('\n');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rerout/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Command-line interface for Rerout — branded short links, QR codes, and analytics from your terminal.",
   "license": "MIT",
   "type": "module",
@@ -38,7 +38,7 @@
     "cli"
   ],
   "dependencies": {
-    "@rerout/sdk": "^0.3.0",
+    "@rerout/sdk": "^0.5.0",
     "commander": "^12.1.0"
   },
   "devDependencies": {