ticketlens 0.1.4 → 0.1.6

package/bin/ticketlens.mjs

@@ -17,9 +17,16 @@ import { run as runConfig } from '../skills/jtb/scripts/lib/config-wizard.mjs';
 import { activateLicense, checkLicense, revalidateIfStale, isLicensed, showUpgradePrompt, readLicense } from '../skills/jtb/scripts/lib/license.mjs';
 import { deleteProfile, loadProfiles } from '../skills/jtb/scripts/lib/profile-resolver.mjs';
 import { run as runCache } from '../skills/jtb/scripts/lib/cache-manager.mjs';
-import { printHelp, printProfiles } from '../skills/jtb/scripts/lib/help.mjs';
+import {
+  printHelp, printProfiles,
+  printLoginHelp, printLogoutHelp, printSyncHelp,
+  printActivateHelp, printLicenseHelp, printDeleteHelp,
+  printProfilesHelp, printScheduleHelp,
+  printInitHelp, printSwitchHelp, printConfigHelp,
+} from '../skills/jtb/scripts/lib/help.mjs';
 import { createStyler } from '../skills/jtb/scripts/lib/ansi.mjs';
 import { readCliToken, saveCliToken, deleteCliToken } from '../skills/jtb/scripts/lib/cli-auth.mjs';
+import { browserLogin } from '../skills/jtb/scripts/lib/browser-login.mjs';
 import { syncProfiles, getApiBase, getConsoleBase } from '../skills/jtb/scripts/lib/sync.mjs';
 import { promptSecret, promptText } from '../skills/jtb/scripts/lib/prompt-helpers.mjs';
 
@@ -45,6 +52,7 @@ switch (command) {
     break;
 
   case 'init':
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printInitHelp(); break; }
     runInit().catch(err => {
       process.stderr.write(`Error: ${err.message}\n`);
       process.exitCode = 1;
@@ -52,6 +60,7 @@ switch (command) {
     break;
 
   case 'switch':
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printSwitchHelp(); break; }
     runSwitch().catch(err => {
       process.stderr.write(`Error: ${err.message}\n`);
       process.exitCode = 1;
@@ -59,6 +68,7 @@ switch (command) {
     break;
 
   case 'config': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printConfigHelp(); break; }
     const profileArg = cmdArgs.find(a => a.startsWith('--profile='));
     const profileName = profileArg ? profileArg.split('=')[1] : undefined;
     runConfig({ profileName }).catch(err => {
@@ -69,6 +79,7 @@ switch (command) {
   }
 
   case 'activate': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printActivateHelp(); break; }
     const s = createStyler({ isTTY: process.stdout.isTTY });
     const key = cmdArgs.find(a => !a.startsWith('--'));
     if (!key) {
@@ -90,6 +101,7 @@ switch (command) {
   }
 
   case 'license': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printLicenseHelp(); break; }
     const s = createStyler({ isTTY: process.stdout.isTTY });
     const status = checkLicense();
     const daysSinceVal = status.validatedAt
@@ -131,6 +143,7 @@ switch (command) {
   }
 
   case 'delete': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printDeleteHelp(); break; }
     const s = createStyler({ isTTY: process.stderr.isTTY });
     const profileName = cmdArgs.find(a => !a.startsWith('--'));
     if (!profileName) {
@@ -182,6 +195,7 @@ switch (command) {
   }
 
   case 'profiles': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printProfilesHelp(); break; }
     const plain = cmdArgs.includes('--plain');
     const config = loadProfiles();
     printProfiles({ config, plain });
@@ -203,6 +217,7 @@ switch (command) {
   }
 
   case 'schedule': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printScheduleHelp(); break; }
     const subCmd = cmdArgs[0];
 
     if (subCmd === '--stop') {
@@ -262,21 +277,46 @@ switch (command) {
     break;
 
   case 'login': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printLoginHelp(); break; }
+
+    const useManual = cmdArgs.includes('--manual');
+
     (async () => {
       const s = createStyler({ isTTY: process.stderr.isTTY });
-      process.stderr.write(`\n  ${s.bold('TicketLens Login')}\n`);
-      process.stderr.write(`  ${s.dim('─'.repeat(44))}\n`);
-      process.stderr.write(`  ${s.dim(`Generate a CLI token at ${s.cyan(`${getConsoleBase()}/console/account`)}`)}\n`);
-      process.stderr.write(`  ${s.dim('then paste it below.')}\n\n`);
-
-      const token = await promptSecret(`CLI Token ${s.dim('(tl_…)')}:`, { stream: process.stderr });
-      if (!token.startsWith('tl_')) {
-        process.stderr.write(`  ${s.red('✖')} Token must start with ${s.dim('tl_')}\n`);
-        process.exitCode = 1;
-        return;
+
+      let token;
+
+      if (useManual) {
+        // ── manual paste flow (CI / headless environments) ──────────────────
+        process.stderr.write(`\n  ${s.bold('TicketLens Login')}\n`);
+        process.stderr.write(`  ${s.dim('─'.repeat(44))}\n`);
+        process.stderr.write(`  ${s.dim(`Generate a CLI token at ${s.cyan(`${getConsoleBase()}/console/account`)}`)}\n`);
+        process.stderr.write(`  ${s.dim('then paste it below.')}\n\n`);
+
+        token = await promptSecret(`CLI Token ${s.dim('(tl_…)')}:`, { stream: process.stderr });
+        if (!token.startsWith('tl_')) {
+          process.stderr.write(`  ${s.red('✖')} Token must start with ${s.dim('tl_')}\n`);
+          process.exitCode = 1;
+          return;
+        }
+      } else {
+        // ── browser flow (default) ────────────────────────────────────────
+        process.stderr.write(`\n  ${s.bold('TicketLens Login')}\n`);
+        process.stderr.write(`  ${s.dim('─'.repeat(44))}\n`);
+        process.stderr.write(`  Opening browser to authorize…\n\n`);
+        process.stderr.write(`  ${s.dim('○ Waiting for authorization (120s)…')}\n`);
+
+        try {
+          token = await browserLogin();
+        } catch (err) {
+          process.stderr.write(`\x1b[A\r\x1b[2K  ${s.red('✖')} ${err.message}\n`);
+          process.stderr.write(`\n  ${s.dim(`Try ${s.cyan('ticketlens login --manual')} to paste a token instead.`)}\n\n`);
+          process.exitCode = 1;
+          return;
+        }
       }
 
-      // Validate against the API before saving
+      // ── verify token against API (both flows) ─────────────────────────
       process.stderr.write(`\n  ${s.dim('○ Verifying token…')}\n`);
       let res;
       try {
@@ -284,7 +324,7 @@ switch (command) {
           headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
           signal: AbortSignal.timeout(15000),
         });
-      } catch (err) {
+      } catch {
         process.stderr.write(`\x1b[A\r\x1b[2K  ${s.red('✖')} Could not reach ${getApiBase()} — check your connection.\n`);
         process.exitCode = 1;
         return;
@@ -312,6 +352,7 @@ switch (command) {
   }
 
   case 'logout': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printLogoutHelp(); break; }
     const s = createStyler({ isTTY: process.stderr.isTTY });
     deleteCliToken();
     process.stderr.write(`  ${s.green('✔')} CLI token removed.\n`);
@@ -319,6 +360,7 @@ switch (command) {
   }
 
   case 'sync': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printSyncHelp(); break; }
     (async () => {
       const s = createStyler({ isTTY: process.stderr.isTTY });
       process.stderr.write(`\n  ${s.dim('Syncing from TicketLens console…')}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticketlens",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Jira CLI for developers — fetch ticket context, triage your queue, and stop tab-switching. Zero dependencies, all local.",
   "type": "module",
   "bin": {

package/skills/jtb/scripts/lib/browser-login.mjs

@@ -0,0 +1,108 @@
+import { createServer }     from 'node:http';
+import { randomBytes }       from 'node:crypto';
+import { spawn }             from 'node:child_process';
+import { hostname as osHostname } from 'node:os';
+import { getConsoleBase }    from './sync.mjs';
+
+const PORT_MIN    = 49152;
+const PORT_MAX    = 65535;
+const TIMEOUT_MS  = 120_000;
+
+export const generateState = () => randomBytes(16).toString('hex');
+
+export const pickPort = () =>
+  Math.floor(Math.random() * (PORT_MAX - PORT_MIN + 1)) + PORT_MIN;
+
+export function openBrowser(url) {
+  const cmd = process.platform === 'win32' ? 'cmd'
+            : process.platform === 'darwin' ? 'open'
+            : 'xdg-open';
+  const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
+  spawn(cmd, args, { detached: true, stdio: 'ignore' }).unref();
+}
+
+/**
+ * Start a one-shot local HTTP server that waits for the CLI auth callback.
+ * Resolves with the token string on success; rejects on state mismatch,
+ * missing/invalid token, or timeout.
+ */
+export function startLocalServer(port, expectedState, timeoutMs = TIMEOUT_MS) {
+  return new Promise((resolve, reject) => {
+    let settled = false;
+
+    const settle = (fn, value) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      server.close();
+      fn(value);
+    };
+
+    const server = createServer((req, res) => {
+      const url = new URL(req.url, `http://127.0.0.1:${port}`);
+
+      if (url.pathname !== '/callback') {
+        res.writeHead(404);
+        res.end();
+        return;
+      }
+
+      const token = url.searchParams.get('token') ?? '';
+      const state = url.searchParams.get('state') ?? '';
+
+      if (state !== expectedState) {
+        res.writeHead(400, { 'Content-Type': 'text/plain' });
+        res.end('State mismatch — authorization rejected.');
+        settle(reject, new Error('State mismatch'));
+        return;
+      }
+
+      if (!token.startsWith('tl_')) {
+        res.writeHead(400, { 'Content-Type': 'text/plain' });
+        res.end('Invalid token received.');
+        settle(reject, new Error('Invalid token'));
+        return;
+      }
+
+      res.writeHead(200, { 'Content-Type': 'text/html' });
+      res.end(
+        '<html><body style="font-family:sans-serif;text-align:center;padding:60px;background:#0d1117;color:#cdd9e5">'
+        + '<h2 style="color:#3fb950">&#10003; Authorized</h2>'
+        + '<p style="color:#8b949e">You can close this tab and return to the terminal.</p>'
+        + '</body></html>',
+      );
+
+      settle(resolve, token);
+    });
+
+    server.on('error', (err) => settle(reject, err));
+
+    const timer = setTimeout(
+      () => settle(reject, new Error('Authorization timed out after 120 seconds')),
+      timeoutMs,
+    );
+
+    server.listen(port, '127.0.0.1');
+  });
+}
+
+/**
+ * Full browser login flow. Opens the authorize page in the default browser,
+ * waits for the callback, and returns the plaintext CLI token.
+ */
+export async function browserLogin() {
+  const state    = generateState();
+  const port     = pickPort();
+  const hostname = osHostname();
+
+  const consoleBase = getConsoleBase();
+  const url = `${consoleBase}/console/auth/cli`
+    + `?port=${port}`
+    + `&state=${encodeURIComponent(state)}`
+    + `&hostname=${encodeURIComponent(hostname)}`;
+
+  const tokenPromise = startLocalServer(port, state);
+  openBrowser(url);
+
+  return tokenPromise;
+}

package/skills/jtb/scripts/lib/help.mjs

@@ -215,6 +215,288 @@ export function printProfiles({ stream = process.stdout, config, plain = false }
   stream.write(lines.join('\n') + '\n');
 }
 
+export function printLoginHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('login')} ${s.dim('[--manual]')}`,
+    '',
+    `  Connect the CLI to your TicketLens account.`,
+    `  Opens a browser window to authorize — no copy-pasting required.`,
+    '',
+    `  ${s.bold('HOW IT WORKS')}`,
+    '',
+    `    1. Run ${s.cyan('ticketlens login')} — your browser opens the authorize page`,
+    `    2. Click ${s.bold('Authorize TicketLens CLI')} while logged in to the Console`,
+    `    3. The terminal confirms login automatically`,
+    `    4. Run ${s.cyan('ticketlens sync')} to pull your tracker connections`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('--manual')}            Paste a token instead of using the browser`,
+    `                       ${s.dim('Useful for CI, SSH sessions, or headless environments.')}`,
+    `                       ${s.dim(`Generate a token at ${s.cyan('<console-url>/console/account')}`)}`,
+    `    ${s.brand('-h')}, ${s.brand('--help')}         Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens login             ${s.dim('# opens browser (default)')}`,
+    `    ${s.dim('$')} ticketlens login --manual     ${s.dim('# paste token (CI / headless)')}`,
+    `    ${s.dim('$')} ticketlens sync               ${s.dim('# after login, pull connections')}`,
+    '',
+    `  ${s.bold('FILES')}`,
+    '',
+    `    ${s.dim('Token saved to:')}  ~/.ticketlens/cli-token  ${s.dim('(written by ticketlens login)')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printLogoutHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('logout')}`,
+    '',
+    `  Remove the stored CLI token, disconnecting this machine from your`,
+    `  TicketLens account. Local profiles and credentials are kept intact.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens logout`,
+    `    ${s.dim('$')} ticketlens login   ${s.dim('# re-authenticate')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printSyncHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('sync')}`,
+    '',
+    `  Pull tracker connections from the TicketLens console and write them`,
+    `  to ${s.dim('~/.ticketlens/profiles.json')}. Requires ${s.cyan('ticketlens login')} first.`,
+    '',
+    `  Profiles that need credentials will be listed with a reminder to`,
+    `  run ${s.cyan('ticketlens config --profile=NAME')} to add them.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens login`,
+    `    ${s.dim('$')} ticketlens sync`,
+    `    ${s.dim('$')} ticketlens profiles   ${s.dim('# verify pulled connections')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printActivateHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('activate')} ${s.dim('<LICENSE-KEY>')}`,
+    '',
+    `  Activate a Pro or Team license key to unlock paid features.`,
+    `  Validates the key online and writes the result to ${s.dim('~/.ticketlens/license.json')}.`,
+    '',
+    `  ${s.bold('ARGUMENTS')}`,
+    '',
+    `    ${s.brand('<LICENSE-KEY>')}   Your LemonSqueezy license key`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}      Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens activate tl_abc123xxxx`,
+    `    ${s.dim('$')} ticketlens license             ${s.dim('# verify activation')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printLicenseHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('license')}`,
+    '',
+    `  Show current license status: tier, email, and last validation date.`,
+    `  License is re-validated automatically in the background every 7 days.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens license`,
+    `    ${s.dim('$')} ticketlens activate ${s.dim('<KEY>')}   ${s.dim('# activate or renew')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printDeleteHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('delete')} ${s.dim('<PROFILE-NAME>')}`,
+    '',
+    `  Permanently remove a locally configured profile. In TTY mode, prompts`,
+    `  for confirmation before deleting. Pass ${s.cyan('--yes')} to skip the prompt.`,
+    '',
+    `  ${s.bold('ARGUMENTS')}`,
+    '',
+    `    ${s.brand('<PROFILE-NAME>')}   Name of the profile to remove`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('--yes')}, ${s.brand('-y')}     Skip confirmation prompt`,
+    `    ${s.brand('-h')}, ${s.brand('--help')}    Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens delete myprofile`,
+    `    ${s.dim('$')} ticketlens delete myprofile --yes`,
+    `    ${s.dim('$')} ticketlens profiles                ${s.dim('# list remaining profiles')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printProfilesHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('profiles')} ${s.dim('[--plain]')}`,
+    '',
+    `  List all locally configured Jira profiles and their active status.`,
+    `  Also available as ${s.cyan('ticketlens ls')}.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('--plain')}          Tab-separated output ${s.dim('(for scripting)')}`,
+    `    ${s.brand('-h')}, ${s.brand('--help')}     Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens profiles`,
+    `    ${s.dim('$')} ticketlens ls`,
+    `    ${s.dim('$')} ticketlens profiles --plain`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printScheduleHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('schedule')} ${s.dim('[--stop|--status]')}  ${s.dim('[Pro]')}`,
+    '',
+    `  Set up a recurring digest email with your triage results. ${s.dim('[Pro]')}`,
+    `  Runs an interactive wizard to configure day, time, and timezone.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('--stop')}        Cancel the active digest schedule`,
+    `    ${s.brand('--status')}      Show current schedule configuration`,
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens schedule`,
+    `    ${s.dim('$')} ticketlens schedule --status`,
+    `    ${s.dim('$')} ticketlens schedule --stop`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printInitHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('init')}`,
+    '',
+    `  Configure a new Jira connection locally using an interactive wizard.`,
+    `  Supports Jira Cloud ${s.dim('(Basic auth)')} and Jira Server/DC ${s.dim('(Bearer PAT or Basic)')}`,
+    '',
+    `  After setup, run ${s.cyan('ticketlens PROJ-123')} to fetch your first ticket.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens init`,
+    `    ${s.dim('$')} ticketlens profiles   ${s.dim('# verify the new profile')}`,
+    '',
+    `  ${s.dim('Tip: use')} ${s.cyan('ticketlens sync')} ${s.dim('instead to pull connections from the console.')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printSwitchHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('switch')}`,
+    '',
+    `  Interactively select which profile is active by default.`,
+    `  The chosen profile is used when no ${s.cyan('--profile')} flag is given.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens switch`,
+    `    ${s.dim('$')} ticketlens profiles   ${s.dim('# confirm new active profile')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printConfigHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('config')} ${s.dim('[--profile=NAME]')}`,
+    '',
+    `  Edit settings for an existing profile using an interactive wizard.`,
+    `  Without ${s.cyan('--profile')}, edits the currently active profile.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('--profile')}=${s.dim('NAME')}   Profile to configure`,
+    `    ${s.brand('-h')}, ${s.brand('--help')}      Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens config`,
+    `    ${s.dim('$')} ticketlens config --profile=work`,
+    `    ${s.dim('$')} ticketlens config --profile=acme`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
 export function printTriageHelp({ stream = process.stdout } = {}) {
   const s = createStyler({ isTTY: stream.isTTY });
   const lines = [