@slothmoney/agent-cli 0.14.0 → 0.14.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.14.1 - 2026-08-21
+
+- Make every parent help page list its nested commands, and give
+  `line-items --help` its own group page instead of generic top-level usage.
+
 ## 0.14.0 - 2026-08-20
 
 - Add `transactions --account-ref REF` using the opaque reference returned by

package/README.md

@@ -15,7 +15,7 @@ sloth-agent --version
 For a one-off pinned run:
 
 ```bash
-npm exec --yes --package=@slothmoney/agent-cli@0.14.0 -- sloth-agent --help
+npm exec --yes --package=@slothmoney/agent-cli@0.14.1 -- sloth-agent --help
 ```
 
 ## Authenticate
@@ -98,7 +98,7 @@ An assignment can change an owned transaction's sharing, categorisation, or
 both.
 
 Every command has built-in reference documentation covering its inputs,
-options, output, and examples:
+options, output, and examples. For example:
 
 ```bash
 sloth-agent auth login --help
@@ -109,6 +109,7 @@ sloth-agent budget update --help
 sloth-agent budget move --help
 sloth-agent categories --help
 sloth-agent categories create --help
+sloth-agent line-items --help
 sloth-agent line-items create --help
 sloth-agent transactions --help
 sloth-agent assign --help

package/dist/args.js

@@ -803,7 +803,7 @@ function helpTopic(argv) {
             return 'line-items-create';
         if (subcommand === 'rename')
             return 'line-items-rename';
-        return undefined;
+        return 'line-items';
     }
     if (command === 'budget') {
         if (subcommand === 'status')

package/dist/cli.js

@@ -4,7 +4,7 @@ import { ICON_KEYS } from './category-metadata.js';
 import { parseApiResponse, validateAssignmentPayload, validateBudgetMovementResponse, validateBudgetUpdatePayload, } from './contracts.js';
 import { createSystemCredentialStore, secureStorageUnavailableError, } from './credential-store.js';
 import { ApiError, CliError, ConfigError, UsageError, } from './errors.js';
-export const CLI_VERSION = '0.14.0';
+export const CLI_VERSION = '0.14.1';
 const REQUEST_TIMEOUT_MS = 60_000;
 const API_ORIGIN_HELP_LINES = [
     '',
@@ -56,7 +56,7 @@ export function usageText() {
         '',
         'Help:',
         '  Run sloth-agent <command> --help for options, inputs, output, and examples.',
-        '  Auth and goal subcommands also have help, for example:',
+        '  Every nested subcommand has its own help, for example:',
         '  sloth-agent auth login --help',
         '  sloth-agent goals update --help',
         '',
@@ -176,6 +176,14 @@ export function categoriesHelpText() {
         '',
         'Read categories and the personal and joint line items within them.',
         '',
+        'Commands:',
+        '  sloth-agent categories list    List categories; "sloth-agent categories" is equivalent.',
+        '  sloth-agent categories create  Preview or create a custom category.',
+        '  sloth-agent categories rename  Preview or rename a custom category.',
+        '',
+        'Help:',
+        '  Run sloth-agent categories <command> --help for command-specific details.',
+        '',
         'Usage:',
         '  sloth-agent categories [list] [--base-url URL]',
         '',
@@ -286,12 +294,35 @@ export function lineItemsCreateHelpText() {
 export function lineItemsRenameHelpText() {
     return lineItemsMutationHelpText('rename');
 }
+export function lineItemsHelpText() {
+    return [
+        'Sloth Agent CLI — line-items',
+        '',
+        'Create or rename personal or joint budget line items.',
+        '',
+        'Commands:',
+        '  sloth-agent line-items create  Preview or create a scoped line item.',
+        '  sloth-agent line-items rename  Preview or rename a scoped line item.',
+        '',
+        'Help:',
+        '  Run sloth-agent line-items <command> --help for command-specific details.',
+        ...API_ORIGIN_HELP_LINES,
+    ].join('\n');
+}
 export function accountsHelpText() {
     return [
         'Sloth Agent CLI — accounts',
         '',
         'Read the existing Sloth account inventory known to the authenticated user.',
         '',
+        'Commands:',
+        '  sloth-agent accounts list    List accounts; "sloth-agent accounts" is equivalent.',
+        '  sloth-agent accounts update  Preview or update an owned account.',
+        '  sloth-agent accounts remove  Preview or archive an owned manual account.',
+        '',
+        'Help:',
+        '  Run sloth-agent accounts <command> --help for command-specific details.',
+        '',
         'Usage:',
         '  sloth-agent accounts [list] [--base-url URL]',
         '',
@@ -402,6 +433,15 @@ export function budgetHelpText() {
         '',
         'Read one personal or joint budget period.',
         '',
+        'Commands:',
+        '  sloth-agent budget         Read one budget period.',
+        '  sloth-agent budget status  Read assigned, spent, and available money.',
+        '  sloth-agent budget update  Preview or update planned line-item amounts.',
+        '  sloth-agent budget move    Preview or move assigned money.',
+        '',
+        'Help:',
+        '  Run sloth-agent budget <command> --help for command-specific details.',
+        '',
         'Usage:',
         '  sloth-agent budget --scope personal|joint [--period YYYY-MM] [--base-url URL]',
         '',
@@ -913,6 +953,7 @@ export function commandHelpText(topic) {
         categories: categoriesHelpText,
         'categories-create': categoriesCreateHelpText,
         'categories-rename': categoriesRenameHelpText,
+        'line-items': lineItemsHelpText,
         'line-items-create': lineItemsCreateHelpText,
         'line-items-rename': lineItemsRenameHelpText,
         transactions: transactionsHelpText,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slothmoney/agent-cli",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "Command-line access to the Sloth Money Agent API.",
   "type": "module",
   "bin": {