Skip to content

Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.

fix(ux): slash autocomplete & help cover every recent command, on every surface

Salman Qureshifb700b4f318d
diff --git a/src/autocomplete-sync.test.ts b/src/autocomplete-sync.test.ts
new file mode 100644
index 00000000..92a7ff60
--- /dev/null
+++ b/src/autocomplete-sync.test.ts
@@ -0,0 +1,60 @@
+import { describe, expect, it } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+// This test lives in src/, so dirname is already the src directory.
+const root = dirname(fileURLToPath(import.meta.url));
+const appSrc = readFileSync(join(root, 'ui', 'App.tsx'), 'utf8');
+const manualSrc = readFileSync(join(root, 'utils', 'manual.ts'), 'utf8');
+
+/**
+ * Slash-command sync contract: every real chat command must appear in the
+ * TUI's autocomplete list (ui/App.tsx `slashCommands`) and in the manual.
+ * New commands are easy to ship and forget to suggest — this test fails
+ * until they are added everywhere.
+ */
+describe('slash autocomplete & help stay in sync', () => {
+ it('the TUI autocomplete covers the recently added commands', () => {
+ for (const cmd of [
+ '/whatsnew',
+ '/update ignore',
+ '/log',
+ '/code chat',
+ '/code back',
+ ]) {
+ expect(appSrc).toContain(`'${cmd}'`);
+ }
+ });
+
+ it('the manual documents the background-task, model, and budget commands', () => {
+ for (const entry of [
+ "['/bg current',",
+ "['/bg list',",
+ "['/bg cancel <id>',",
+ "['/bg clear',",
+ "['/bg killall',",
+ "['/budget',",
+ "['/models',",
+ "['/models use <provider>',",
+ "['/cloud models',",
+ "['/cloud use <model-id>',",
+ "['/log',",
+ ]) {
+ expect(manualSrc).toContain(entry);
+ }
+ });
+
+ it('dead commands are not documented (no dispatcher → no manual entry)', () => {
+ // /tasks was documented but never dispatched — removed.
+ expect(manualSrc).not.toContain("['/tasks',");
+ });
+
+ it('the channel help texts mention the new commands', () => {
+ // Telegram + Discord share the same list layout; Slack uses /mercury prefix.
+ for (const marker of ['whatsnew', 'update ignore', '/bg current']) {
+ expect(manualSrc).toContain(marker);
+ }
+ expect(manualSrc).toContain('/mercury whatsnew');
+ });
+});
\ No newline at end of file
diff --git a/src/ui/App.tsx b/src/ui/App.tsx
index 4331eda5..0382d95f 100644
--- a/src/ui/App.tsx
+++ b/src/ui/App.tsx
@@ -118,6 +118,9 @@ export function TuiApp({ channel, onInput, onPermissionResolve, onExit, spotifyC
const slashCommands = React.useMemo(() => [
'/help',
+ '/whatsnew',
+ '/update ignore',
+ '/log',
'/sessions',
'/session new',
'/session current',
@@ -139,6 +142,8 @@ export function TuiApp({ channel, onInput, onPermissionResolve, onExit, spotifyC
'/code off',
'/code toggle',
'/code exit',
+ '/code chat',
+ '/code back',
'/research',
'/research on',
'/research off',
diff --git a/src/ui/tips.test.ts b/src/ui/tips.test.ts
index 70a302f2..6ca9664f 100644
--- a/src/ui/tips.test.ts
+++ b/src/ui/tips.test.ts
@@ -46,7 +46,7 @@ describe('tip picker (anti-nag)', () => {
for (let i = 0; i < pool.length; i++) {
const tip = rotateTip('code');
expect(seen.has(tip!.id)).toBe(false);
- seen.add(tip.id);
+ seen.add(tip!.id);
}
// One more rotation re-offers the earliest tip — the cycle restarts.
expect(seen.size).toBe(pool.length);
diff --git a/src/utils/manual.ts b/src/utils/manual.ts
index 515b2e96..5dd48929 100644
--- a/src/utils/manual.ts
+++ b/src/utils/manual.ts
@@ -125,6 +125,17 @@ export function getManual(): string {
['/session archive <ref>', 'Archive a session'],
['/session delete <ref>', 'Permanently delete a session after confirmation'],
['/progress', 'Show live status for the current long task'],
+ ['/log', 'Print the last finished task’s step log'],
+ ['/bg', 'Show background tasks and current task status'],
+ ['/bg current', 'Move the current task to the background (keeps running)'],
+ ['/bg list', 'List background tasks'],
+ ['/bg cancel <id>', 'Cancel a background task'],
+ ['/bg clear', 'Remove finished background tasks from the list'],
+ ['/bg killall', 'Cancel all background tasks'],
+ ['/budget', 'Show token budget status'],
+ ['/budget override', 'Allow one request past the budget'],
+ ['/budget reset', 'Reset daily usage to zero'],
+ ['/budget set <n>', 'Set the daily token budget'],
['/telegram', 'CLI chat only: open the Telegram management menu'],
['/telegram pending', 'CLI chat only: list pending Telegram requests'],
['/telegram users', 'CLI chat only: list approved Telegram users'],
@@ -141,10 +152,13 @@ export function getManual(): string {
['/skills install <id|url>', 'Install from the registry or a raw SKILL.md URL'],
['/skills remove <id>', 'Uninstall a skill'],
['/permissions', 'Change permission mode (Ask Me / Allow All)'],
+ ['/models', 'List configured providers and their models'],
+ ['/models use <provider>', 'Switch the default model (saved across restarts)'],
+ ['/cloud models', 'List Mercury Cloud models for your tier'],
+ ['/cloud use <model-id>', 'Switch to a Mercury Cloud model'],
['/view', 'Toggle progress view (balanced/detailed)'],
['/view balanced', 'Set compact progress view'],
['/view detailed', 'Set full progress view'],
- ['/tasks', 'List scheduled tasks'],
['/memory', 'View and manage second brain memory'],
['/stream', 'Toggle text streaming on/off (Telegram)'],
['/stream on', 'Enable streaming (live text updates)'],
@@ -291,10 +305,22 @@ export function getTelegramHelp(): string {
lines.push('/help — Show this command list');
lines.push('/status — Config, budget, and uptime');
lines.push('/progress — Live status for the current task');
+ lines.push('/log — Step log of the last finished task');
+ lines.push('/whatsnew — What changed in this Mercury version');
+ lines.push('/update ignore — Silence the offered update notice');
lines.push('/permissions — Switch Ask Me / Allow All mode');
- lines.push('/models — List providers or switch AI model');
+ lines.push('/models — List providers or switch AI model (saved across restarts)');
lines.push('/cloud models — List Mercury Cloud models and switch');
lines.push('/stream — Toggle text streaming on/off');
+ lines.push('/stop — Stop the current task and its agents now');
+ lines.push('/halt — Emergency: stop all agents and clear the queue');
+ lines.push('');
+
+ lines.push('**Tasks**');
+ lines.push('/bg — Show background tasks and current task status');
+ lines.push('/bg current — Move the current task to the background (keeps running)');
+ lines.push('/bg list — List background tasks');
+ lines.push('/bg cancel <id> — Cancel a background task');
lines.push('');
lines.push('**Budget**');
@@ -387,9 +413,21 @@ export function getDiscordHelp(): string {
lines.push('/help \u2014 Show this command list');
lines.push('/status \u2014 Config, budget, and uptime');
lines.push('/progress \u2014 Live status for the current task');
+ lines.push('/log \u2014 Step log of the last finished task');
+ lines.push('/whatsnew \u2014 What changed in this Mercury version');
+ lines.push('/update ignore \u2014 Silence the offered update notice');
lines.push('/permissions \u2014 Switch Ask Me / Allow All mode');
- lines.push('/models \u2014 List providers or switch AI model');
+ lines.push('/models \u2014 List providers or switch AI model (saved across restarts)');
lines.push('/cloud models \u2014 List Mercury Cloud models and switch');
+ lines.push('/stop \u2014 Stop the current task and its agents now');
+ lines.push('/halt \u2014 Emergency: stop all agents and clear the queue');
+ lines.push('');
+
+ lines.push('**Tasks**');
+ lines.push('/bg \u2014 Show background tasks and current task status');
+ lines.push('/bg current \u2014 Move the current task to the background (keeps running)');
+ lines.push('/bg list \u2014 List background tasks');
+ lines.push('/bg cancel <id> \u2014 Cancel a background task');
lines.push('');
lines.push('**Budget**');
@@ -426,7 +464,12 @@ export function getSlackHelp(): string {
lines.push('**General**');
lines.push('/mercury help \u2014 Show this command list');
lines.push('/mercury status \u2014 Config, budget, and uptime');
- lines.push('/mercury stop \u2014 Stop all agents');
+ lines.push('/mercury progress \u2014 Live status for the current task');
+ lines.push('/mercury log \u2014 Step log of the last finished task');
+ lines.push('/mercury whatsnew \u2014 What changed in this Mercury version');
+ lines.push('/mercury update ignore \u2014 Silence the offered update notice');
+ lines.push('/mercury models \u2014 List providers or switch AI model');
+ lines.push('/mercury stop \u2014 Stop the current task and its agents now');
lines.push('');
lines.push('**Budget**');