profile-swap

1import type { EngineInterface, Register } from 'claude-code'
2
3const SUBCOMMANDS = new Set([
4  'help',
5  'list',
6  'current',
7  'usage',
8  'folder',
9  'save',
10  'swap',
11  'rename',
12  'delete',
13  'new',
14  'auto',
15  'bind',
16  'unbind',
17  'notify',
18  'tag',
19  'untag',
20  'tags',
21  'export',
22  'import-enc',
23  'history',
24  'undo',
25  'stats',
26  'cooldown',
27  'doctor',
28  'statusline',
29  'prompt',
30  'temp',
31  'untemp',
32  'alias',
33  'unalias',
34  'aliases',
35  'bind-branch',
36  'unbind-branch',
37  'branch-bindings',
38  'forecast',
39  'pick',
40  'sync',
41  'affinity',
42  'unaffinity',
43  'affinities',
44  'cleanup',
45  'lang',
46  'language',
47  'disable',
48  'enable',
49  'disabled',
50  'add-token',
51  'run',
52  'version',
53  'upgrade',
54  'web',
55  'dashboard',
56  'balance',
57  'webhook',
58  'budget',
59  'cost',
60  'mask',
61  'share',
62  'completion',
63  'repair',
64  'schedule',
65  'unschedule',
66  'settings',
67  'overview',
68])
69const USAGE =
70  'Dùng: /profile | /profile list | /profile <tên|alias> | /profile pick | /profile web | /profile balance | /profile webhook | /profile lang [vi|en] | /profile run <tên> | /profile add-token <tok> | /profile disable <tên> | /profile auto | /profile sync | /profile upgrade'
71
72// "" → help, "list" → list, "work" → swap work, "save work" → save work, "import ~/a b" → import ~/a b, "auto ..." → auto ...
73function toArgv(args: string): string[] | undefined {
74  const words = args.trim().split(/\s+/).filter(Boolean)
75  if (words.length === 0 || words[0] === '--help' || words[0] === '-h') return ['help']
76  if (words.length === 1 && words[0] === 'statusline') return ['statusline', 'toggle'] // bare CLI `statusline` prints the shell-prompt string
77  if (words[0] === 'version' || words[0] === '--version' || words[0] === '-v') return ['version']
78  if (words[0] === 'web' || words[0] === 'dashboard') {
79    if (words[1] === 'stop') return words
80    if (!words.includes('--daemon')) return [words[0], '--daemon', ...words.slice(1)]
81  }
82  if (words[0] === 'import') {
83    const path = words.slice(1).filter(w => w !== '--force').join(' ')
84    if (!path) return undefined
85    return ['import', path, ...(words.includes('--force') ? ['--force'] : [])]
86  }
87  if (SUBCOMMANDS.has(words[0])) return words
88  if (words.length === 1) return ['swap', words[0]]
89  if (words.length === 2 && words[1] === '--project') return ['swap', words[0], '--project']
90  return undefined
91}
92
93// `$.env.get` wants a literal name at its call site (so a module's variables can be listed): pass the call itself
94const safely = async (read: () => Promise<string | undefined>) => {
95  try {
96    return await read()
97  } catch {
98    return undefined
99  }
100}
101
102// Where node may live when the host was started from a GUI (Desktop app from Finder/Dock) and PATH lacks the
103// shell's additions; the login shell last, since it reads the user's profile (nvm, asdf…). The hooks module has no
104// `process`: the environment comes through `$.env`.
105async function nodeCandidates($: EngineInterface, script: string, argv: string[]): Promise<string[][]> {
106  const home = (await safely(() => $.env.get('HOME'))) || (await safely(() => $.env.get('USERPROFILE'))) || ''
107  const windows = (await safely(() => $.env.get('OS'))) === 'Windows_NT'
108  const direct = [
109    'node',
110    'nodejs',
111    '/opt/homebrew/bin/node',
112    '/usr/local/bin/node',
113    '/usr/bin/node',
114    `${home}/.volta/bin/node`,
115    'C:\\Program Files\\nodejs\\node.exe',
116  ].map(node => [node, script, ...argv])
117  const shell = (await safely(() => $.env.get('SHELL'))) || '/bin/sh'
118  return windows ? direct : [...direct, [shell, '-lc', 'exec node "$@"', 'node', script, ...argv]]
119}
120
121// the first launcher that worked, tried first from then on (a reload starts over)
122let launcher = -1
123
124// the plugin is the repo itself: swap.js sits next to .claude-plugin/ and hooks/
125async function runSwap($: EngineInterface, argv: string[]) {
126  const script = `${$.plugin.root}/swap.js`
127  // the common case, `node` on PATH, costs no `$.env` lookups
128  if (launcher <= 0) {
129    try {
130      const ran = await $.process.run(['node', script, ...argv])
131      launcher = 0
132      return ran
133    } catch {}
134  }
135  const all = await nodeCandidates($, script, argv)
136  const order = launcher > 0 ? [launcher, ...all.keys()].filter((i, n, a) => a.indexOf(i) === n) : [...all.keys()].slice(1)
137  let failure: unknown
138  for (const i of order) {
139    try {
140      const ran = await $.process.run(all[i])
141      launcher = i
142      return ran
143    } catch (error) {
144      failure = error
145    }
146  }
147  throw new Error(
148    `Không tìm thấy Node.js để chạy claude-swap (${String(failure)}). Cài Node.js 18+ rồi mở lại app; ` +
149      'nếu đã cài qua nvm/Homebrew mà app Desktop vẫn không thấy, mở Claude từ terminal hoặc thêm node vào PATH hệ thống.'
150  )
151}
152
153// What `statusLineData` in swap.js returns. Drawn as a coloured band above the prompt: the host's own status line
154// takes plain text only (one colour, prefixed with the plugin name).
155type StatusData = {
156  profile: string
157  rateLimited: boolean
158  windows: { name: string; pct: number; left: string }[]
159  warn: string
160  stale?: string // '⚠ lỗi mạng', '⚠ cũ 2h': the numbers are not current
161  suggest?: string // '→ minhvong 7d 31%': auto-switch is off and this profile is running out
162  next?: string
163  pace?: string // '7d ≈0.7%/h': the 7-day quota left per hour until its reset
164  models?: string // 'Fable 7d 85% → minhvong 13%': a model's own 7-day limit running out
165  recovered?: string[] // other profiles whose full window has reset since
166  mode?: 'line' | 'band'
167  text?: string
168}
169
170// The data swap.js last produced. `auto check` reprints it on every prompt, so only a change redraws.
171// A reload loses it; the next prompt brings it back.
172let status: StatusData | null = null
173let lastRaw: string | undefined
174
175function parseStatus(raw: string): StatusData | null {
176  try {
177    const data = JSON.parse(raw)
178    return data && typeof data.profile === 'string' && Array.isArray(data.windows) ? data : null
179  } catch {
180    return null
181  }
182}
183
184// `line` mode pins plain text under the prompt (the host drops the ESC byte of a pinned line, so no colour there);
185// `band` (default) draws the coloured band above it. Whichever is not in use is cleared:
186// a plugin's pinned text survives a reload, so the very first call must clear a line an older version left behind.
187let pinned = true
188
189// the suggestion last toasted, so one profile running out toasts once, not on every refresh
190let lastSuggest = ''
191let lastRecovered: string[] = []
192
193function showStatus($: EngineInterface, raw: string) {
194  lastRaw = raw
195  status = parseStatus(raw)
196  const suggest = status?.suggest || ''
197  if (suggest && status?.next !== lastSuggest) $.ui.toast(`⚠ ${status!.profile} sắp hết quota ${suggest}: /profile ${status!.next}`)
198  lastSuggest = suggest ? status!.next || '' : ''
199  const recovered = status?.recovered || []
200  for (const name of recovered) if (!lastRecovered.includes(name)) $.ui.toast(`✅ ${name} đã hồi quota: /profile ${name}`)
201  lastRecovered = recovered
202  const text = status && status.mode === 'line' ? status.text || undefined : undefined
203  if (text !== undefined || pinned) $.ui.status(text)
204  pinned = text !== undefined
205  $.ui.invalidate('ui.render')
206}
207
208async function refreshStatus($: EngineInterface) {
209  const { stdout } = await runSwap($, ['statusline', 'json'])
210  const raw = stdout.trim()
211  if (raw !== lastRaw) showStatus($, raw)
212}
213
214// Between prompts nothing else redraws: tick once a minute so the countdown moves and the quota (refetched by
215// `statusline json` once USAGE_TTL has passed) stays current while the session sits idle. Started once per load.
216const TICK_MS = 60_000
217let ticking = false
218
219// the band's "switch" button: the same swap `/profile <name>` does, then the band redraws for the new profile
220async function swapTo($: EngineInterface, name: string) {
221  const ran = await runSwap($, ['swap', name, '--no-color']) // a toast is plain text: `swap` output is coloured
222  $.ui.toast(`${ran.stdout}${ran.stderr}`.trim().split('\n')[0] || name)
223  await refreshStatus($)
224}
225
226// `/profile settings` editor: the rows swap.js reported, the edits not saved yet, and the last save's outcome
227type Setting = { key: string; type: 'bool' | 'number' | 'choice' | 'text'; choices?: string[]; value: boolean | number | string; desc: string }
228let settings: Setting[] = []
229let draft: Record<string, Setting['value']> = {}
230let settingsNote = ''
231
232async function loadSettings($: EngineInterface) {
233  const { stdout } = await runSwap($, ['settings', '--json'])
234  settings = JSON.parse(stdout.trim())
235  draft = {}
236}
237
238function edit($: EngineInterface, key: string, value: Setting['value']) {
239  draft = { ...draft, [key]: value }
240  settingsNote = ''
241  $.ui.invalidate('ui.render')
242}
243
244// every changed row goes through `settings set`, which validates it; a refused one stays in the draft with its error
245async function saveSettings($: EngineInterface) {
246  const errors: string[] = []
247  const changed = Object.entries(draft)
248  for (const [key, value] of changed) {
249    const text = value === true ? 'on' : value === false ? 'off' : String(value)
250    const ran = await runSwap($, ['settings', 'set', key, text, '--no-color'])
251    if (ran.exitCode !== 0) errors.push(`${key}: ${`${ran.stderr}${ran.stdout}`.trim().replace(/^❌ Lỗi: /, '')}`)
252  }
253  const failed = new Set(errors.map(e => e.split(':')[0]))
254  const kept = Object.fromEntries(Object.entries(draft).filter(([k]) => failed.has(k)))
255  await loadSettings($)
256  draft = kept
257  await refreshStatus($)
258  const saved = changed.length - errors.length
259  if (!errors.length) {
260    $.ui.toast(saved ? `✅ Đã lưu ${saved} cài đặt` : 'Không có gì thay đổi')
261    await $.ui.close({ id: 'settings' })
262    return
263  }
264  settingsNote = `⚠ Đã lưu ${saved}/${changed.length}. ${errors.join(' · ')}`
265  $.ui.invalidate('ui.render')
266}
267
268// commands that only read: they cannot change what the band shows, so they skip the extra `statusline json` process
269const READ_ONLY = new Set([
270  'help', 'overview', 'list', 'current', 'usage', 'folder', 'history', 'stats', 'cooldown', 'forecast', 'doctor', 'tags',
271  'aliases', 'disabled', 'branch-bindings', 'affinities', 'prompt', 'completion', 'version', 'share', 'export', 'web', 'dashboard',
272])
273
274// Same palette as the `/profile list` table (pctCode in swap.js): green < 50, yellow < 80, orange < 95, red above.
275// Raw colours rather than theme keys, so the band and the table look alike on any theme.
276const loadColor = (pct: number) => (pct >= 95 ? 'red' : pct >= 80 ? '#ff8700' : pct >= 50 ? 'yellow' : 'green')
277const BAR_WIDTH = 8
278
279// `/profile` help, row by row: a command (yellow in swap.js's formatHelpReport) with its description, or a title
280const SGR = /\x1b\[[0-9;]*m/g
281const HELP_ARGS = new Set(['', 'help', '--help', '-h'])
282type HelpRow = { cmd?: string; desc?: string; title?: string }
283
284// what bare `/profile` draws above the help (`overview --json`, overviewData in swap.js); the latest one, so an older help
285// in the scrollback shows the current values too
286type Overview = {
287  profile: string
288  email: string
289  profiles: number
290  disabled: number
291  rateLimited: boolean
292  stale: string
293  windows: { name: string; pct: number; left: string }[]
294  settings: (Setting & { icon: string })[]
295}
296let overview: Overview | null = null
297
298function helpRows(text: string): HelpRow[] {
299  return text.split('\n').map(line => {
300    const m = line.match(/^\s*\x1b\[1;33m(\/profile[^\x1b]*)\x1b\[0m\s*(.*)$/)
301    return m ? { cmd: m[1].trim(), desc: m[2].replace(SGR, '') } : { title: line.replace(SGR, '') }
302  })
303}
304
305// what a click puts in the prompt box: the command up to its first placeholder ("/profile alias <tên> <p>" → "/profile alias ")
306export function helpDraft(cmd: string): string {
307  const words: string[] = []
308  for (const w of cmd.split(/\s+/)) {
309    if (/[<[|]/.test(w)) break
310    words.push(w)
311  }
312  return `${words.join(' ')} `
313}
314
315export const register: Register = on => {
316  on('session.start', async ($, e, next) => {
317    await $.command.register({
318      name: 'profile',
319      description: 'Đổi tài khoản Claude ngay trong session: /profile [tên | usage | auto | cooldown | doctor | temp | bind | history]',
320      immediate: true, // runs at once even while a turn is streaming, instead of queueing behind it
321    })
322
323    try {
324      const targetDir = e.cwd || '.'
325      const boundRan = await runSwap($, ['bind', 'get', targetDir])
326      const boundOut = boundRan.stdout.trim()
327      const match = boundOut.match(/(?:đang liên kết với profile|bound to profile|profile):\s*([^\s()]+)/i)
328      if (match && match[1]) {
329        const boundProfile = match[1]
330        const curRan = await runSwap($, ['current'])
331        const curProfile = curRan.stdout.trim()
332        if (boundProfile !== curProfile) {
333          await runSwap($, ['swap', boundProfile, '--project'])
334        }
335      }
336    } catch {}
337
338    void refreshStatus($).catch(() => undefined)
339    if (!ticking) {
340      ticking = true
341      $.clock.every(TICK_MS, () => void refreshStatus($).catch(() => undefined))
342    }
343
344    return next(e)
345  })
346
347  on('prompt.submit', async ($, e, next) => {
348    try {
349      const ran = await runSwap($, ['auto', 'check'])
350      const out = `${ran.stdout}${ran.stderr}`.trim()
351      // the auto-swap notice would otherwise show nowhere: the hook only reads the [status] line
352      const swapped = out.match(/^\[auto-swap\] (🔀 .*)$/m)
353      if (swapped) $.ui.toast(swapped[1])
354      const line = out.match(/^\[status\] ?(.*)$/m)
355      if (line && line[1].trim() !== lastRaw) showStatus($, line[1].trim())
356    } catch {}
357
358    return next(e)
359  })
360
361  // coloured status band: ● profile │ 5h [███░░░░░] 34% ⏳2h10m │ 7d [██████░░] 73% ⏳3d4h │ ⚠ 5h ~12p
362  on('ui.render', { component: 'AbovePrompt' }, ($, e, next) => {
363    if (!status || status.mode === 'line' || e.props.hasSurvey) return next(e)
364    const { Box, Text, Button } = $.ui.resolve(e)
365    const suggested = status.next
366    // a narrow terminal drops the bars and countdowns: "● work │ 5h 34% │ 7d 73%"
367    const width = status.text ? status.text.length : status.profile.length + 4 + status.windows.length * 28 // ≈ one full window
368    const compact = typeof e.props.bodyColumns === 'number' && e.props.bodyColumns < width + 8
369    const sep = <Text color="gray"> │ </Text>
370    return (
371      <Box>
372        <Text color="green" bold>● {status.profile}</Text>
373        {status.rateLimited ? <Text color="yellow" bold> ⏳ 429</Text> : null}
374        {status.windows.map(w => {
375          const filled = Math.round((w.pct / 100) * BAR_WIDTH)
376          const color = loadColor(w.pct)
377          return (
378            <Box key={w.name}>
379              {sep}
380              <Text color="cyan" bold>{w.name} </Text>
381              {compact ? null : <Text color="gray">[</Text>}
382              {compact ? null : <Text color={color} bold>{'█'.repeat(filled)}</Text>}
383              {compact ? null : <Text color="gray">{'░'.repeat(BAR_WIDTH - filled)}] </Text>}
384              <Text color={color} bold>{String(w.pct)}%</Text>
385              {w.pct >= 80 && !compact ? <Text> 🔥</Text> : null}
386              {w.left && !compact ? <Text color="cyan"> ⏳{w.left}</Text> : null}
387            </Box>
388          )
389        })}
390        {[status.warn, status.pace, status.models, status.stale, status.suggest].filter(Boolean).map(note => (
391          <Box key={note}>{sep}<Text color="yellow" bold>{note}</Text></Box>
392        ))}
393        {suggested ? (
394          <Box>
395            <Text> </Text>
396            <Button key="swap-next" hotkey="s" plain onPress={() => void swapTo($, suggested).catch(() => undefined)}>
397              {`⇄ ${suggested}`}
398            </Button>
399          </Box>
400        ) : null}
401      </Box>
402    )
403  })
404
405  // `/profile` help: every command is a button that puts it in the prompt box, ready to complete and send
406  on('ui.render', { component: 'CommandOutput' }, ($, e, next) => {
407    const { command, args, text, isErrored } = e.props
408    if (command !== 'profile' || isErrored || !HELP_ARGS.has(args.trim().split(/\s+/)[0])) return next(e)
409    let rows = helpRows(text)
410    if (!rows.some(r => r.cmd)) return next(e) // not the help after all (a format change, no match): draw it as text
411    const { Box, Text, Button } = $.ui.resolve(e)
412    // bare `/profile`: swap.js printed the overview as text above the help; draw it from the data instead
413    const ov = HELP_ARGS.has(args.trim()) ? overview : null
414    const start = rows.findIndex(r => r.title?.includes('claude-swap —'))
415    if (ov && start > 0) rows = rows.slice(start)
416    const width = ov ? Math.max(...ov.settings.map(r => r.key.length), 8) : 0
417    return (
418      <Box flexDirection="column">
419        {ov ? (
420          <Box flexDirection="column">
421            <Text color="cyan" bold>🔀 claude-swap · Tổng quan</Text>
422            {ov.profile ? (
423              <Box>
424                <Text>  👤 </Text>
425                <Text color="green" bold>{ov.profile}</Text>
426                {ov.email ? <Text color="gray">{` ${ov.email}`}</Text> : null}
427                <Text>{`   📦 ${ov.profiles} profile`}</Text>
428                {ov.disabled ? <Text color="red">{` · 🚫 ${ov.disabled} tắt`}</Text> : null}
429              </Box>
430            ) : (
431              <Text color="yellow" bold>  ⚠ Chưa có profile nào active. Tạo bằng: /profile new {'<tên>'}</Text>
432            )}
433            {ov.windows.map(w => {
434              const filled = Math.round((w.pct / 100) * 16)
435              const color = loadColor(w.pct)
436              return (
437                <Box key={`ov:${w.name}`}>
438                  <Text>{w.name === '5h' ? '  ⌛ ' : '  📅 '}</Text>
439                  <Text color="cyan" bold>{w.name === '5h' ? '5 giờ   ' : '7 ngày  '}</Text>
440                  <Text color="gray">[</Text>
441                  <Text color={color} bold>{'█'.repeat(filled)}</Text>
442                  <Text color="gray">{'░'.repeat(16 - filled)}] </Text>
443                  <Text color={color} bold>{`${String(w.pct).padStart(3)}%`}</Text>
444                  {w.pct >= 80 ? <Text> 🔥</Text> : null}
445                  {w.left ? <Text color="cyan">{`  ⏳ ${w.left}`}</Text> : null}
446                </Box>
447              )
448            })}
449            {ov.rateLimited ? <Text color="yellow" bold>  ⏳ máy chủ usage đang bận (429), quota sẽ hiện lại sau</Text> : null}
450            {ov.stale ? <Text color="yellow" bold>{`  ${ov.stale}`}</Text> : null}
451            <Text> </Text>
452            <Box>
453              <Text color="cyan" bold>🧰 Cài đặt </Text>
454              <Button key="overview-settings" plain onPress={() => void $.prompt.fill({ text: '/profile settings' }).catch(() => undefined)}>
455                <Text color="gray">(sửa: /profile settings)</Text>
456              </Button>
457            </Box>
458            {ov.settings.map(r => {
459              const v = r.value
460              const off = v === false || v === '' || v === 'off'
461              return (
462                <Box key={`ov:${r.key}`}>
463                  <Text>{`  ${r.icon} `}</Text>
464                  <Text bold>{`${r.key.padEnd(width)}  `}</Text>
465                  <Text color={v === true ? 'green' : off ? 'gray' : 'cyan'} bold={!off}>
466                    {(v === true ? '● bật' : v === false ? '○ tắt' : v === '' ? '—' : String(v)).padEnd(14)}
467                  </Text>
468                  <Text dimColor>{r.desc}</Text>
469                </Box>
470              )
471            })}
472            <Text> </Text>
473          </Box>
474        ) : null}
475        {rows.map((r, i) =>
476          r.cmd ? (
477            <Box key={`row${i}`}>
478              <Text>  </Text>
479              <Button key={`help:${r.cmd}`} plain onPress={() => void $.prompt.fill({ text: helpDraft(r.cmd!) }).catch(() => undefined)}>
480                <Text color="yellow" bold>{r.cmd.padEnd(28)}</Text>
481              </Button>
482              <Text> {r.desc}</Text>
483            </Box>
484          ) : (
485            <Text key={`row${i}`} color="cyan" bold>{r.title || ' '}</Text>
486          )
487        )}
488        <Text dimColor>💡 Bấm vào một lệnh để đưa nó xuống ô nhập.</Text>
489      </Box>
490    )
491  })
492
493  // the settings editor: a toggle for on/off, a button cycling through choices, a field for numbers and text
494  on('ui.render', { component: 'Pane', requestId: 'settings' }, ($, e) => {
495    const { Box, Text, Button, Input } = $.ui.resolve(e)
496    const width = Math.max(...settings.map(r => r.key.length), 8)
497    const shown = (v: Setting['value']) => (v === '' ? '—' : String(v))
498    return (
499      <Box flexDirection="column">
500        {settings.map(r => {
501          const value = r.key in draft ? draft[r.key] : r.value
502          const changed = r.key in draft && draft[r.key] !== r.value
503          const control =
504            r.type === 'bool' ? (
505              <Button key={`set:${r.key}`} plain onPress={() => edit($, r.key, !value)}>
506                <Text color={value ? 'green' : 'gray'} bold>{value ? '● on ' : '○ off'}</Text>
507              </Button>
508            ) : r.type === 'choice' ? (
509              <Button
510                key={`set:${r.key}`}
511                plain
512                onPress={() => {
513                  const list = r.choices || []
514                  edit($, r.key, list[(list.indexOf(String(value)) + 1) % list.length] ?? '')
515                }}
516              >
517                <Text color="cyan" bold>{`⇄ ${shown(value)}`}</Text>
518              </Button>
519            ) : (
520              <Input key={`set:${r.key}`} value={String(value)} placeholder="—" onInput={v => edit($, r.key, v)} onSubmit={v => edit($, r.key, v)} />
521            )
522          return (
523            <Box key={`row:${r.key}`}>
524              <Text color={changed ? 'yellow' : 'white'} bold>{`${changed ? '* ' : '  '}${r.key.padEnd(width)}  `}</Text>
525              {control}
526              <Text dimColor>{`  ${r.desc}`}</Text>
527            </Box>
528          )
529        })}
530        {settingsNote ? <Text color="yellow">{settingsNote}</Text> : null}
531        <Box>
532          <Button key="settings-save" variant="primary" hotkey="s" onPress={() =>
533              void saveSettings($).catch(err => {
534                settingsNote = `⚠ ${String(err)}`
535                $.ui.invalidate('ui.render')
536              })
537            }>
538            💾 Lưu
539          </Button>
540          <Text> </Text>
541          <Button key="settings-cancel" role="dismiss" onPress={() => void $.ui.close({ id: 'settings' })}>
542            Hủy
543          </Button>
544          <Text dimColor>{`  ${Object.keys(draft).length} thay đổi chưa lưu`}</Text>
545        </Box>
546      </Box>
547    )
548  })
549
550  on('command.run', { command: 'profile' }, async ($, e) => {
551    const argv = toArgv(e.args)
552    if (!argv) return { text: USAGE }
553
554    // bare `/profile settings` opens the editor; with arguments (`settings set k v`) it runs as any command
555    if (argv[0] === 'settings' && argv.length === 1) {
556      await loadSettings($)
557      settingsNote = ''
558      const opened = await $.ui.open({ id: 'settings', title: 'claude-swap · Cài đặt', focus: true, closeOnEscape: true })
559      if (opened.isPlaced) return { text: '⚙️ Đã mở bảng cài đặt: sửa rồi bấm 💾 Lưu (phím s), Esc để đóng.' }
560      await $.ui.close({ id: 'settings' })
561    }
562
563    // bare `/profile`: the overview's data, for the render hook to draw in colour above the help
564    const [ran, ov] = await Promise.all([
565      runSwap($, argv),
566      argv.length === 1 && argv[0] === 'help' ? runSwap($, ['overview', '--json']).catch(() => null) : null,
567    ])
568    if (ov) {
569      try {
570        overview = JSON.parse(ov.stdout.trim())
571      } catch {}
572    }
573    if (!READ_ONLY.has(argv[0]) || ran.exitCode !== 0) await refreshStatus($)
574    const out = `${ran.stdout}${ran.stderr}`.trim()
575    // the new version is only on disk: have the host re-read plugins once this command has returned
576    if (argv[0] === 'upgrade' && ran.exitCode === 0) {
577      $.clock.after(500, () => void $.command.run({ command: 'reload-plugins' }).catch(() => undefined))
578      return { text: `${out}\n🔄 Đang nạp lại plugin (/reload-plugins)...`.trim() }
579    }
580    // the host draws the first line beside its own prefix, which would push a table's header out of line
581    if (out) return { text: argv[0] === 'list' || argv[0] === 'usage' ? `\n${out}` : out }
582
583    return { text: argv[0] === 'list' ? 'Chưa có profile nào. Tạo bằng: /profile new <tên>' : 'OK' }
584  })
585}
586