@workjournal/cli 0.8.0 → 0.17.0

package/dist/help/entries-get.json

@@ -0,0 +1,12 @@
+{
+    "command": "entries get",
+    "description": "Fetch a single entry by its per-journal index. The index is the integer shown as `#N` in `entries list` output and is monotonic, never reused.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        { "name": "index", "required": true, "description": "Per-journal positive integer (≥ 1)." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal entries get acme engineering 5"],
+    "when_to_use": "Reading one specific entry by its index — useful when correlating across `entries search` results or following a reference like `entry #5`."
+}

package/dist/help/entries-last.json

@@ -0,0 +1,19 @@
+{
+    "command": "entries last",
+    "description": "Print the N most recent entries with their full body content. Defaults to 1.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        {
+            "name": "count",
+            "required": false,
+            "description": "How many entries to fetch (positive integer; default 1)."
+        }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": [
+        "workjournal entries last acme engineering",
+        "workjournal entries last acme engineering 5"
+    ],
+    "when_to_use": "Reading recent work back to recover context — the most common opening move for an agent starting a new session in an existing journal."
+}

package/dist/help/entries-list.json

@@ -0,0 +1,14 @@
+{
+    "command": "entries list",
+    "description": "List entries in a journal (newest first), slim form — no body. Use `entries last` or `entries get` to read full content.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": [
+        "workjournal entries list acme engineering",
+        "workjournal entries list acme engineering --json"
+    ],
+    "when_to_use": "Browsing what's in a journal. For a view that includes the body, use `entries last <ws> <j> N`."
+}

package/dist/help/entries-search.json

@@ -0,0 +1,15 @@
+{
+    "command": "entries search",
+    "description": "Search a journal's entries by keyword. Returns slim entries (id, index, summary, created_at) — follow up with `entries get` for the full body.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        { "name": "query", "required": true, "description": "Search string. Quote multi-word queries." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": [
+        "workjournal entries search acme engineering auth",
+        "workjournal entries search acme engineering \"refresh token\" --json"
+    ],
+    "when_to_use": "Finding past entries on a topic — file paths, feature names, error strings, decision keywords. Run several searches with different terms to find related entries."
+}

package/dist/help/entries-update.json

@@ -0,0 +1,44 @@
+{
+    "command": "entries update",
+    "description": "Patch any subset of an entry's title, summary, or body. Preserves `created_at` and the per-journal index; advances `updated_at`.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        { "name": "index", "required": true, "description": "Per-journal positive integer (≥ 1)." }
+    ],
+    "flags": [
+        {
+            "short": "-t",
+            "long": "--title",
+            "value": "<title>",
+            "description": "New title (max 80 chars). Omit to leave unchanged."
+        },
+        {
+            "short": "-s",
+            "long": "--summary",
+            "value": "<summary>",
+            "description": "New summary (max 500 chars). Omit to leave unchanged."
+        },
+        {
+            "short": "-b",
+            "long": "--body",
+            "value": "<file>|-",
+            "description": "Body source — file path, or `-` for stdin. Omit to leave unchanged."
+        },
+        {
+            "long": "--tags",
+            "value": "<a,b,c>",
+            "description": "Replace the tag set with this comma-separated list (Plus+). Pass `--tags \"\"` to clear all tags (allowed on any tier). Omit to leave unchanged. Pattern D, issue #239."
+        }
+    ],
+    "constraints": ["At least one of -t/-s/-b/--tags is required."],
+    "annotations": { "destructive": false, "idempotent": false },
+    "examples": [
+        "workjournal entries update acme engineering 5 -t \"Verified\"",
+        "workjournal entries update acme engineering 5 -b verification.md",
+        "cat note.md | workjournal entries update acme engineering 5 -b -",
+        "workjournal entries update acme engineering 5 --tags decision,blocker",
+        "workjournal entries update acme engineering 5 --tags \"\""
+    ],
+    "when_to_use": "Annotating, verifying, or fixing typos on an existing entry without delete+recreate (which would lose the original `created_at` and disrupt the entry index)."
+}

package/dist/help/entries-write.json

@@ -0,0 +1,39 @@
+{
+    "command": "entries write",
+    "description": "Create a new entry in a journal. All three content fields are required. The title is capped at 80 characters; the summary at 500. Body is the full markdown content.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." }
+    ],
+    "flags": [
+        {
+            "short": "-t",
+            "long": "--title",
+            "value": "<title>",
+            "description": "Entry title (max 80 chars). Required."
+        },
+        {
+            "short": "-s",
+            "long": "--summary",
+            "value": "<summary>",
+            "description": "Paragraph summary used by AI retrieval (max 500 chars). Required."
+        },
+        {
+            "short": "-b",
+            "long": "--body",
+            "value": "<body>",
+            "description": "Markdown body. Required. Inline only — for file/stdin sources, use `entries update` after creation."
+        },
+        {
+            "long": "--tags",
+            "value": "<a,b,c>",
+            "description": "Optional comma-separated tag names (Plus+). All names must already exist in the workspace/journal — see `tags list`. Pattern D, issue #239."
+        }
+    ],
+    "annotations": { "destructive": false, "idempotent": false },
+    "examples": [
+        "workjournal entries write acme engineering -t \"Auth migration shipped\" -s \"...\" -b \"...\"",
+        "workjournal entries write acme engineering -t \"...\" -s \"...\" -b \"...\" --tags decision,blocker"
+    ],
+    "when_to_use": "Recording work that's been completed — decisions, fixes, trade-offs. Always run `journals get` first to read the journal's `prompt.body` so the entry matches the journal's voice."
+}

package/dist/help/export.json

@@ -0,0 +1,29 @@
+{
+    "command": "export",
+    "description": "Export a journal as JSON, Markdown, or CSV. Defaults to JSON to stdout; use `-p` to write to a file. Plus/Pro tier feature on FREE workspaces.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." }
+    ],
+    "flags": [
+        {
+            "short": "-f",
+            "long": "--format",
+            "value": "<json|md|csv>",
+            "description": "Output format. Defaults to `json`."
+        },
+        {
+            "short": "-p",
+            "long": "--path",
+            "value": "<path>",
+            "description": "Write output to this file instead of stdout."
+        }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": [
+        "workjournal export acme engineering",
+        "workjournal export acme engineering -f md -p ./engineering.md",
+        "workjournal export acme engineering -f csv > engineering.csv"
+    ],
+    "when_to_use": "Backing up a journal, archiving for long-term storage, or feeding the entries into another tool. Markdown is human-readable; JSON preserves every field; CSV is for spreadsheet import."
+}

package/dist/help/invites-delete.json

@@ -0,0 +1,16 @@
+{
+    "command": "invites delete",
+    "description": "Revoke a pending invitation by id. Already-accepted invitations cannot be revoked — use `shares delete` to remove an accepted contributor.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        {
+            "name": "invitationId",
+            "required": true,
+            "description": "Invitation UUID from `invites list`."
+        }
+    ],
+    "annotations": { "destructive": true, "idempotent": true },
+    "examples": ["workjournal invites delete acme engineering 7d8e9f12-a3b4-4c5d-9e10-1f2a3b4c5d6e"],
+    "when_to_use": "Cancelling an invitation that was sent to the wrong address or to someone who shouldn't have been invited."
+}

package/dist/help/invites-list.json

@@ -0,0 +1,11 @@
+{
+    "command": "invites list",
+    "description": "List pending invitations for a journal — id, invited email, sent-at. Accepted and revoked invitations are not returned.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal invites list acme engineering"],
+    "when_to_use": "Tracking outstanding invitations before resending or revoking. The invitation `id` shown here is what `invites delete` expects."
+}

package/dist/help/invites-new.json

@@ -0,0 +1,12 @@
+{
+    "command": "invites new",
+    "description": "Create an email-based invitation to a journal. The invitee receives an email with an accept link. Subject to the workspace tier's `max_contributors_per_journal` limit.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        { "name": "email", "required": true, "description": "Invitee's email address." }
+    ],
+    "annotations": { "destructive": false, "idempotent": false },
+    "examples": ["workjournal invites new acme engineering alice@example.com"],
+    "when_to_use": "Adding a new contributor to a journal. The invitation can be revoked with `invites delete` until accepted."
+}

package/dist/help/journal.json

@@ -0,0 +1,13 @@
+{
+    "command": "journal",
+    "description": "Shortcut: print details of the currently selected journal (workspace + journal pinned via `journals select`). Errors if no journal has been selected.",
+    "flags": [
+        {
+            "long": "--verbose",
+            "description": "Print the full prompt body alongside the summary line."
+        }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal journal", "workjournal journal --verbose"],
+    "when_to_use": "Quick recap of the active journal during interactive work. For programmatic access pass `--json`."
+}

package/dist/help/journals-assign-prompt.json

@@ -0,0 +1,12 @@
+{
+    "command": "journals assign-prompt",
+    "description": "Attach a workspace prompt to a journal. The prompt's `body` is what `journals get` returns as `prompt.body` and is the writing instruction agents follow when creating entries. Plus/Pro tier feature.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        { "name": "promptSlug", "required": true, "description": "Slug from `prompts list <ws>`." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal journals assign-prompt acme engineering project-style"],
+    "when_to_use": "Customising the writing voice / structure for a specific journal. Without an assignment the journal uses the system-default prompt."
+}

package/dist/help/journals-delete.json

@@ -0,0 +1,11 @@
+{
+    "command": "journals delete",
+    "description": "Delete a journal and every entry it contains. Requires the workspace owner role. Irreversible — there is no recycle bin.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." }
+    ],
+    "annotations": { "destructive": true, "idempotent": true },
+    "examples": ["workjournal journals delete acme staging"],
+    "when_to_use": "Retiring a journal you own. To stop using a journal without deleting its entries, just stop writing to it — there is no archive flag today."
+}

package/dist/help/journals-get.json

@@ -0,0 +1,20 @@
+{
+    "command": "journals get",
+    "description": "Print details of a single journal — name, slug, description, contributor count, and the assigned prompt (custom or system default). Pass `--verbose` to also print the full prompt body.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." }
+    ],
+    "flags": [
+        {
+            "long": "--verbose",
+            "description": "Print the full prompt body alongside the summary line."
+        }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": [
+        "workjournal journals get acme engineering",
+        "workjournal journals get acme engineering --verbose"
+    ],
+    "when_to_use": "Before writing an entry, fetch the journal first — `prompt.body` in the response tells you the structure and voice the journal expects. Skipping this is the most common cause of off-format entries."
+}

package/dist/help/journals-list.json

@@ -0,0 +1,14 @@
+{
+    "command": "journals list",
+    "description": "List journals in a workspace. The workspace slug is optional if one has been pinned via `workspaces select`. Pass the special slug `shared-with-me` to list journals shared into you from workspaces you don't own.",
+    "args": [
+        {
+            "name": "workspaceSlug",
+            "required": false,
+            "description": "Slug from `workspaces list`, or `shared-with-me`. Falls back to the active workspace."
+        }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal journals list acme", "workjournal journals list shared-with-me --json"],
+    "when_to_use": "Discovering available journal slugs before any entry-scoped command. The `shared-with-me` form surfaces journals where you're a contributor in a workspace you don't own."
+}

package/dist/help/journals-new.json

@@ -0,0 +1,21 @@
+{
+    "command": "journals new",
+    "description": "Create a new journal in a workspace. Auto-generates a slug from the name; override with `--slug`. Subject to the workspace tier's `max_journals` limit.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "name", "required": true, "description": "Display name (max 20 characters)." }
+    ],
+    "flags": [
+        {
+            "long": "--slug",
+            "value": "<slug>",
+            "description": "Override the auto-generated slug. Reserved names and route-collisions are rejected."
+        }
+    ],
+    "annotations": { "destructive": false, "idempotent": false },
+    "examples": [
+        "workjournal journals new acme \"Engineering Notes\"",
+        "workjournal journals new acme \"Ops Runbook\" --slug ops"
+    ],
+    "when_to_use": "Setting up a new journal for a project, team, or topic. Each journal has its own monotonic entry index and its own prompt assignment."
+}

package/dist/help/journals-rename.json

@@ -0,0 +1,12 @@
+{
+    "command": "journals rename",
+    "description": "Change the journal's display name. The slug stays the same so existing URLs and integrations keep working.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        { "name": "newName", "required": true, "description": "New display name (max 20 characters)." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal journals rename acme staging \"Staging Notes\""],
+    "when_to_use": "Cosmetic rename — fixes typos or rebrands a journal without breaking links. Use `journals set-slug` if you need to change the URL."
+}

package/dist/help/journals-select.json

@@ -0,0 +1,11 @@
+{
+    "command": "journals select",
+    "description": "Set the active journal in project-config and global-config. Subsequent shortcut forms (`workjournal` and `workjournal journal`) resolve to this selection.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal journals select acme engineering"],
+    "when_to_use": "Pinning the journal once for the current project so subsequent commands don't need to repeat the slugs. Resource verbs like `entries`, `shares`, `invites` still take explicit slugs — `select` only enables shortcut forms."
+}

package/dist/help/journals-set-slug.json

@@ -0,0 +1,16 @@
+{
+    "command": "journals set-slug",
+    "description": "Change the journal's URL slug. WARNING: old URLs to `<workspaceSlug>/<journalSlug>` will return 404 immediately after the change. Use `journals rename` if you only want to change the human name.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Current slug." },
+        {
+            "name": "newSlug",
+            "required": true,
+            "description": "New URL slug. Reserved names and route-collisions are rejected."
+        }
+    ],
+    "annotations": { "destructive": true, "idempotent": true },
+    "examples": ["workjournal journals set-slug acme staging-notes staging"],
+    "when_to_use": "When the slug is genuinely wrong (typo, ambiguous, conflict). Coordinate with anyone who has bookmarks, scripts, or shared links — they all need updating."
+}

package/dist/help/journals-unassign-prompt.json

@@ -0,0 +1,11 @@
+{
+    "command": "journals unassign-prompt",
+    "description": "Detach the journal's currently assigned prompt and fall back to the system default. No-op if the journal already uses the default.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal journals unassign-prompt acme engineering"],
+    "when_to_use": "Reverting a custom prompt without deleting it (the prompt remains in the workspace and can be re-assigned later)."
+}

package/dist/help/prompts-delete.json

@@ -0,0 +1,11 @@
+{
+    "command": "prompts delete",
+    "description": "Delete a workspace prompt. Cascades unassignment from any journals currently using it (those journals fall back to the system default). Plus/Pro tier feature.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "promptSlug", "required": true, "description": "Slug from `prompts list`." }
+    ],
+    "annotations": { "destructive": true, "idempotent": true },
+    "examples": ["workjournal prompts delete acme project-style"],
+    "when_to_use": "Retiring a prompt you no longer want available in the workspace. Use `journals unassign-prompt` first if you only want to detach it from one journal."
+}

package/dist/help/prompts-get.json

@@ -0,0 +1,11 @@
+{
+    "command": "prompts get",
+    "description": "Print a single prompt's full details, including the body. Plus/Pro tier feature.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "promptSlug", "required": true, "description": "Slug from `prompts list`." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal prompts get acme project-style"],
+    "when_to_use": "Reading the body of a prompt before editing it, or auditing what's currently saved at a slug."
+}

package/dist/help/prompts-list.json

@@ -0,0 +1,14 @@
+{
+    "command": "prompts list",
+    "description": "List the workspace's saved prompts. Plus/Pro tier feature — Free tier surfaces a tier-rejection error from the API.",
+    "args": [
+        {
+            "name": "workspaceSlug",
+            "required": false,
+            "description": "Slug from `workspaces list`. Falls back to the active workspace."
+        }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal prompts list", "workjournal prompts list acme --json"],
+    "when_to_use": "Discovering available prompts before assigning one to a journal with `journals assign-prompt`."
+}

package/dist/help/prompts-new.json

@@ -0,0 +1,23 @@
+{
+    "command": "prompts new",
+    "description": "Create a new workspace prompt. Auto-generates a slug from the name; override with `--slug`. Plus/Pro tier feature.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "name", "required": true, "description": "Display name (max 80 characters)." }
+    ],
+    "flags": [
+        {
+            "short": "-b",
+            "long": "--body",
+            "value": "<body>",
+            "description": "Prompt body (max 10,000 characters). Defaults to empty if omitted."
+        },
+        { "long": "--slug", "value": "<slug>", "description": "Override the auto-generated slug." }
+    ],
+    "annotations": { "destructive": false, "idempotent": false },
+    "examples": [
+        "workjournal prompts new acme \"Project style\" -b \"Be concise. Use past tense.\"",
+        "workjournal prompts new acme \"Engineering voice\" --slug eng-voice -b \"...\""
+    ],
+    "when_to_use": "Authoring a custom writing style for a journal. Pair with `journals assign-prompt` to apply it."
+}

package/dist/help/prompts-update.json

@@ -0,0 +1,29 @@
+{
+    "command": "prompts update",
+    "description": "Update a prompt's name and/or body. The slug stays stable so existing journal assignments keep working. Plus/Pro tier feature.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "promptSlug", "required": true, "description": "Slug from `prompts list`." }
+    ],
+    "flags": [
+        {
+            "short": "-n",
+            "long": "--name",
+            "value": "<name>",
+            "description": "New display name (max 80 chars). Omit to leave unchanged."
+        },
+        {
+            "short": "-b",
+            "long": "--body",
+            "value": "<body>",
+            "description": "New body (max 10,000 chars). Omit to leave unchanged."
+        }
+    ],
+    "constraints": ["At least one of -n/-b is required."],
+    "annotations": { "destructive": false, "idempotent": false },
+    "examples": [
+        "workjournal prompts update acme project-style -n \"Renamed style\"",
+        "workjournal prompts update acme project-style -b \"Be concise. Use bullet points.\""
+    ],
+    "when_to_use": "Iterating on a prompt's wording without changing its slug. The change is picked up by every journal currently assigned this prompt on the next entry write."
+}

package/dist/help/shares-delete.json

@@ -0,0 +1,16 @@
+{
+    "command": "shares delete",
+    "description": "Remove a contributor's access to a journal. The CLI resolves the email to a user ID internally so callers don't need to know the UUID.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." },
+        {
+            "name": "email",
+            "required": true,
+            "description": "Contributor's email address (must match what's shown in `shares list`)."
+        }
+    ],
+    "annotations": { "destructive": true, "idempotent": true },
+    "examples": ["workjournal shares delete acme engineering alice@example.com"],
+    "when_to_use": "Revoking access for a former teammate or a contributor who joined by mistake. Owners cannot be removed via this command."
+}

package/dist/help/shares-list.json

@@ -0,0 +1,11 @@
+{
+    "command": "shares list",
+    "description": "List the contributors of a journal — id, role, joined-at. Each row also includes the user's email when available.",
+    "args": [
+        { "name": "workspaceSlug", "required": true, "description": "Slug from `workspaces list`." },
+        { "name": "journalSlug", "required": true, "description": "Slug from `journals list`." }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": ["workjournal shares list acme engineering"],
+    "when_to_use": "Auditing who has access to a journal before sharing further or removing a stale contributor."
+}

package/dist/help/tags-delete.json

@@ -0,0 +1,29 @@
+{
+    "command": "tags delete",
+    "description": "Delete a tag. Cascades to remove the tag from every entry that referenced it (workspace-scope: every entry in the workspace; journal-scope: every entry in that journal). Not tier-gated.",
+    "args": [
+        {
+            "name": "workspaceSlug",
+            "required": true,
+            "description": "Slug from `workspaces list`."
+        },
+        {
+            "name": "tagName",
+            "required": true,
+            "description": "Tag name to delete."
+        }
+    ],
+    "flags": [
+        {
+            "long": "--journal",
+            "value": "<journalSlug>",
+            "description": "Target the journal-scope row of this name. Omit for workspace-scope."
+        }
+    ],
+    "annotations": { "destructive": true, "idempotent": true },
+    "examples": [
+        "workjournal tags delete acme deprecated-tag",
+        "workjournal tags delete acme planning --journal engineering"
+    ],
+    "when_to_use": "Retiring a tag that should no longer be used. Cascades cleanly — no orphan references on entries."
+}

package/dist/help/tags-get.json

@@ -0,0 +1,29 @@
+{
+    "command": "tags get",
+    "description": "Show a single tag's metadata. With --journal, prefers the journal-scoped row when one exists; falls back to the workspace-scope row with the same name.",
+    "args": [
+        {
+            "name": "workspaceSlug",
+            "required": true,
+            "description": "Slug from `workspaces list`."
+        },
+        {
+            "name": "tagName",
+            "required": true,
+            "description": "Tag name (kebab-case)."
+        }
+    ],
+    "flags": [
+        {
+            "long": "--journal",
+            "value": "<journalSlug>",
+            "description": "Look up the journal-scope row preferentially; falls back to workspace-scope."
+        }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": [
+        "workjournal tags get acme decision",
+        "workjournal tags get acme planning --journal engineering --json"
+    ],
+    "when_to_use": "Inspecting a tag's description and scope before assigning or modifying it."
+}

package/dist/help/tags-list.json

@@ -0,0 +1,25 @@
+{
+    "command": "tags list",
+    "description": "List tags in a workspace. Returns workspace-scoped tags by default; pass --journal <j> to include that journal's tags too. Plus+ tier feature — Free workspaces return an empty list.",
+    "args": [
+        {
+            "name": "workspaceSlug",
+            "required": false,
+            "description": "Slug from `workspaces list`. Falls back to the active workspace."
+        }
+    ],
+    "flags": [
+        {
+            "long": "--journal",
+            "value": "<journalSlug>",
+            "description": "Narrow to a specific journal. Returns workspace-scope tags plus that journal's tags."
+        }
+    ],
+    "annotations": { "destructive": false, "idempotent": true },
+    "examples": [
+        "workjournal tags list",
+        "workjournal tags list acme --json",
+        "workjournal tags list acme --journal engineering"
+    ],
+    "when_to_use": "Discovering which tags can be attached to a new entry before calling `entries write --tags …`."
+}