praxis-agent 0.14.0 → 0.16.0

package/dist/cli/interactive.js

@@ -17,6 +17,7 @@ import { createClaudeStatusLineInput, StatusLine } from './tui/status-line.js';
 import { loadGitDiff, visiblePatchLines, } from './tui/git-diff.js';
 import { addTuiPermissionRule, loadTuiPermissionRules, removeTuiPermissionRule, } from './tui/permission-settings.js';
 import { createRecentlyDeniedStore, } from './tui/recently-denied.js';
+import { agentColorMessage, parseAgentColorInput, } from '../compatibility/claude/agent-color.js';
 import { filterTuiSlashCommands, mergeTuiSlashCommands, slashCommandQuery, } from './tui/slash-commands.js';
 import { createComposerEditor, deleteComposerBackward, deleteComposerForward, deleteComposerToEnd, deleteComposerToStart, deleteComposerWordBackward, insertComposerText, moveComposerCursor, moveComposerCursorByWord, } from './tui/composer-editor.js';
 import { applyMentionReference, fileReferenceAtCursor, filterTuiMentionEntries, loadTuiFileEntries, } from './tui/file-picker.js';
@@ -247,7 +248,7 @@ const HIDDEN_TUI_SLASH_COMMANDS = new Set([
     'update',
     'usage',
 ]);
-export function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory = [], signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader = false, allowNewSession = true, resume, display = { version: 'dev', cwd: process.cwd() }, terminalWidth, slashCommands = EMPTY_SLASH_COMMANDS, agents = EMPTY_AGENTS, allowDangerouslySkipPermissions = false, additionalDirectories = [], diffLoader, fileLoader, externalEditor = editTuiPrompt, keybindingsConfigRoot, keybindingsFile = ensureTuiKeybindingsFile, keybindingsLoader = loadTuiKeybindings, keybindingsEditor = openTuiEditorFile, memoryFilesLoader = (configRoot, cwd) => loadTuiMemoryFiles({ configRoot, cwd }), memoryEditor = openTuiEditorFile, memoryFolderOpener = openTuiMemoryFolder, suspendProcess = suspendTuiProcess, clipboardReader = readTuiClipboard, clipboardWriter = writeTuiClipboard, sideQuestionClipboardWriter = writeTuiOsc52Clipboard, exportWriter = writeConversationExport, permissionRuleStore, sandboxStore: suppliedSandboxStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver = resolveTuiWorkspaceDirectory, workspaceDirectoryCompleter = completeTuiWorkspaceDirectory, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, elicitationUrlOpener = openTuiUrl, releaseNotesLoader = (configRoot) => loadClaudeReleaseNotes({ configRoot }), settingSources, }) {
+export function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory = [], initialSessionColor, signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader = false, allowNewSession = true, resume, display = { version: 'dev', cwd: process.cwd() }, terminalWidth, slashCommands = EMPTY_SLASH_COMMANDS, agents = EMPTY_AGENTS, allowDangerouslySkipPermissions = false, additionalDirectories = [], diffLoader, fileLoader, externalEditor = editTuiPrompt, keybindingsConfigRoot, keybindingsFile = ensureTuiKeybindingsFile, keybindingsLoader = loadTuiKeybindings, keybindingsEditor = openTuiEditorFile, memoryFilesLoader = (configRoot, cwd) => loadTuiMemoryFiles({ configRoot, cwd }), memoryEditor = openTuiEditorFile, memoryFolderOpener = openTuiMemoryFolder, suspendProcess = suspendTuiProcess, clipboardReader = readTuiClipboard, clipboardWriter = writeTuiClipboard, sideQuestionClipboardWriter = writeTuiOsc52Clipboard, exportWriter = writeConversationExport, permissionRuleStore, sandboxStore: suppliedSandboxStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver = resolveTuiWorkspaceDirectory, workspaceDirectoryCompleter = completeTuiWorkspaceDirectory, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, elicitationUrlOpener = openTuiUrl, releaseNotesLoader = (configRoot) => loadClaudeReleaseNotes({ configRoot }), settingSources, }) {
     const { exit, suspendTerminal, waitUntilRenderFlush } = useApp();
     const width = useTerminalWidth(terminalWidth);
     const keybindingsRoot = useMemo(() => resolve(keybindingsConfigRoot ??
@@ -304,6 +305,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
     const statusLineSessionId = useRef(resume?.sessionId ?? randomUUID());
     const sessionIdRef = useRef(resume?.sessionId ?? null);
     sessionIdRef.current = sessionId;
+    const [sessionColor, setSessionColor] = useState(initialSessionColor);
     const [sessionName, setSessionName] = useState(null);
     const [activeSessionSummary, setActiveSessionSummary] = useState(() => resume?.sessionId
         ? initialSessions.find((session) => session.sessionId === resume.sessionId)
@@ -443,6 +445,17 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
     const matchingSlashCommands = useMemo(() => commandQuery === null
         ? []
         : filterTuiSlashCommands(allSlashCommands, commandQuery), [allSlashCommands, commandQuery]);
+    const commandArgumentHint = useMemo(() => {
+        if (shellMode || !input.startsWith('/'))
+            return undefined;
+        if (inputCursor !== input.length)
+            return undefined;
+        const match = /^\/(\S+) $/u.exec(input);
+        if (!match?.[1])
+            return undefined;
+        const command = allSlashCommands.find((candidate) => candidate.name === match[1]);
+        return command?.argumentHint;
+    }, [allSlashCommands, input, inputCursor, shellMode]);
     const commandPaletteVisible = !busy &&
         !permission &&
         !planApproval &&
@@ -1443,14 +1456,19 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         sessionLoadRef.current = loadId;
         if (nextSessionId === null) {
             setHistory([]);
+            setSessionColor(undefined);
             return;
         }
         const loading = (async () => {
             try {
                 const commands = await service();
                 const transcript = await commands.transcript?.(nextSessionId);
+                const agentColor = commands.agentColor === undefined
+                    ? undefined
+                    : await commands.agentColor(nextSessionId);
                 if (sessionLoadRef.current === loadId) {
                     setHistory(transcript ? [...transcript] : []);
+                    setSessionColor(agentColor);
                 }
             }
             catch (error) {
@@ -1816,6 +1834,32 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         onTurnChange?.(showing);
         void showing.finally(() => onTurnChange?.(null));
     };
+    const changeSessionColor = (display, selection) => {
+        appendPromptHistory(display);
+        if (selection.kind === 'color')
+            setSessionColor(selection.color);
+        else if (selection.kind === 'reset')
+            setSessionColor(undefined);
+        const changing = (async () => {
+            try {
+                const activeSessionId = await withLocalCommands(async (commands) => {
+                    if (!commands.recordColorUsage) {
+                        throw new Error('Session color is unavailable.');
+                    }
+                    return commands.recordColorUsage(sessionId ?? undefined, selection, display, runtimePreferencesRef.current.permissionMode);
+                });
+                if (activeSessionId)
+                    setSessionId(activeSessionId);
+                append({ kind: 'user', text: display });
+                append({ kind: 'local-result', text: agentColorMessage(selection) });
+            }
+            catch (error) {
+                warn(error);
+            }
+        })();
+        onTurnChange?.(changing);
+        void changing.finally(() => onTurnChange?.(null));
+    };
     const backgroundSession = () => {
         appendPromptHistory('/background');
         const backgrounding = (async () => {
@@ -4794,6 +4838,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             if (!prompt || prompt === '!')
                 return;
             const copyCommand = /^\/copy(?:\s+(\d+))?$/u.exec(prompt);
+            const colorCommand = /^\/color(?:\s+([\s\S]+))?$/u.exec(prompt);
             const sandboxCommand = /^\/sandbox(?:\s+([\s\S]+))?$/u.exec(prompt);
             const tuiCommand = /^\/tui(?:\s+(default|fullscreen))?$/u.exec(prompt);
             const renameCommand = /^\/rename(?:\s+(.+))?$/u.exec(prompt);
@@ -4808,12 +4853,14 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             else if (prompt === '/new') {
                 statusLineSessionId.current = randomUUID();
                 setSessionId(null);
+                setSessionColor(undefined);
                 setPendingFork(false);
                 append({ kind: 'notice', text: 'Started a new session.' });
             }
             else if (prompt === '/clear') {
                 statusLineSessionId.current = randomUUID();
                 setSessionId(null);
+                setSessionColor(undefined);
                 setPendingFork(false);
                 setHistory([]);
                 setUsage(undefined);
@@ -4944,6 +4991,16 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             else if (prompt === '/add-dir') {
                 openWorkspaceDirectoryInput();
             }
+            else if (prompt === '/agents') {
+                append({ kind: 'user', text: prompt });
+                append({
+                    kind: 'local-result',
+                    text: 'The /agents wizard has been removed.\n\nAsk Claude to create or update subagents for you (e.g. "create a code-reviewer subagent that ..."),\nor edit the files directly:\n  • .claude/agents/       (this project)\n  • ~/.claude/agents/     (all projects)\n\nDocs: https://code.claude.com/docs/en/sub-agents',
+                });
+            }
+            else if (colorCommand) {
+                changeSessionColor(prompt, parseAgentColorInput(colorCommand[1] ?? ''));
+            }
             else if (btwCommand) {
                 const sideQuestion = btwCommand[1]?.trim();
                 if (sideQuestion)
@@ -5413,7 +5470,9 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                                 label: 'Save to file',
                                 description: 'Save the conversation to a file in the current directory',
                             },
-                        ], selectedIndex: menu.selectedIndex, footer: "Esc to cancel", width: width, screenReader: axScreenReader })) : menu.kind === 'copy' ? (_jsx(SelectionMenu, { title: "Copy", description: "Select content to copy:", options: menu.candidates, selectedIndex: menu.selectedIndex, footer: "Enter to copy \u00B7 w to write to /tmp/claude \u00B7 Esc to cancel", width: width, screenReader: axScreenReader })) : null) : (_jsxs(_Fragment, { children: [commandPaletteVisible ? (_jsx(CommandPalette, { commands: matchingSlashCommands, selectedIndex: selectedSlashCommandIndex, width: width, screenReader: axScreenReader })) : null, filePickerVisible ? (_jsx(MentionPicker, { entries: matchingMentionEntries, selectedIndex: selectedFileIndex, width: width, screenReader: axScreenReader })) : null, exitConfirmation ? (_jsx(Text, { color: activePalette.warning, children: "Press Ctrl-C again to exit" })) : null, _jsx(Composer, { input: shellMode ? input.slice(1) : input, cursor: shellMode ? Math.max(0, inputCursor - 1) : inputCursor, shellMode: shellMode, busy: busy, clipboardBusy: clipboardBusy, status: status, display: runtimeDisplay, ...(usage === undefined ? {} : { usage }), ...(costUsd === undefined ? {} : { costUsd }), width: width, screenReader: axScreenReader, hasThinking: hasDetailedTranscript, thinkingExpanded: thinkingExpanded, reduceMotion: runtimeSettings.reduceMotion, progressBar: runtimeSettings.progressBar, ...(runtimeSettings.turnDuration
+                        ], selectedIndex: menu.selectedIndex, footer: "Esc to cancel", width: width, screenReader: axScreenReader })) : menu.kind === 'copy' ? (_jsx(SelectionMenu, { title: "Copy", description: "Select content to copy:", options: menu.candidates, selectedIndex: menu.selectedIndex, footer: "Enter to copy \u00B7 w to write to /tmp/claude \u00B7 Esc to cancel", width: width, screenReader: axScreenReader })) : null) : (_jsxs(_Fragment, { children: [commandPaletteVisible ? (_jsx(CommandPalette, { commands: matchingSlashCommands, selectedIndex: selectedSlashCommandIndex, width: width, screenReader: axScreenReader })) : null, filePickerVisible ? (_jsx(MentionPicker, { entries: matchingMentionEntries, selectedIndex: selectedFileIndex, width: width, screenReader: axScreenReader })) : null, exitConfirmation ? (_jsx(Text, { color: activePalette.warning, children: "Press Ctrl-C again to exit" })) : null, _jsx(Composer, { input: shellMode ? input.slice(1) : input, cursor: shellMode ? Math.max(0, inputCursor - 1) : inputCursor, shellMode: shellMode, ...(sessionColor === undefined ? {} : { sessionColor }), ...(commandArgumentHint === undefined
+                                    ? {}
+                                    : { commandArgumentHint }), busy: busy, clipboardBusy: clipboardBusy, status: status, display: runtimeDisplay, ...(usage === undefined ? {} : { usage }), ...(costUsd === undefined ? {} : { costUsd }), width: width, screenReader: axScreenReader, hasThinking: hasDetailedTranscript, thinkingExpanded: thinkingExpanded, reduceMotion: runtimeSettings.reduceMotion, progressBar: runtimeSettings.progressBar, ...(runtimeSettings.turnDuration
                                     ? (() => {
                                         const duration = formatTurnDuration(turnDuration);
                                         return duration === undefined
@@ -5466,6 +5525,7 @@ export async function runInteractive(options) {
         : controller.signal;
     let currentResume = options.resume;
     let currentInitialPrompt = options.initialPrompt;
+    let initialAgentPromptResolved = false;
     let currentRuntimeSettings = options.runtimeSettings ?? (await loadRuntimeSettings());
     let currentRenderer = currentRuntimeSettings.tui;
     let rendererChange = null;
@@ -5516,12 +5576,26 @@ export async function runInteractive(options) {
         const resume = canonicalResumeSession
             ? { ...currentResume, sessionId: canonicalResumeSession.sessionId }
             : currentResume;
+        if (!initialAgentPromptResolved) {
+            const agentInitialPrompt = resume === undefined ? listing.initialAgentPrompt?.() : undefined;
+            if (agentInitialPrompt) {
+                currentInitialPrompt = currentInitialPrompt
+                    ? `${agentInitialPrompt}\n\n${currentInitialPrompt}`
+                    : agentInitialPrompt;
+            }
+            initialAgentPromptResolved = true;
+        }
         let initialHistory = [];
+        let initialSessionColor;
         try {
             initialHistory =
                 resume?.sessionId === undefined || listing.transcript === undefined
                     ? []
                     : await listing.transcript(resume.sessionId);
+            initialSessionColor =
+                resume?.sessionId === undefined || listing.agentColor === undefined
+                    ? undefined
+                    : await listing.agentColor(resume.sessionId);
         }
         catch (error) {
             try {
@@ -5546,7 +5620,7 @@ export async function runInteractive(options) {
         let cleanup = null;
         let backgrounded;
         rendererChange = null;
-        const instance = render(_jsx(InteractiveApp, { factory: options.factory, initialSessions: initialSessions, slashCommands: initialSlashCommands, agents: initialAgents, initialHistory: history, runtimeSettings: currentRuntimeSettings, ...(options.settingSources === undefined
+        const instance = render(_jsx(InteractiveApp, { factory: options.factory, initialSessions: initialSessions, slashCommands: initialSlashCommands, agents: initialAgents, initialHistory: history, ...(initialSessionColor === undefined ? {} : { initialSessionColor }), runtimeSettings: currentRuntimeSettings, ...(options.settingSources === undefined
                 ? {}
                 : { settingSources: options.settingSources }), initialThemeSettings: initialThemeSettings, ...(initialThemeLoadError === undefined
                 ? {}

package/dist/cli/protocol.d.ts

@@ -206,6 +206,13 @@ export interface ProtocolResult {
 }
 export declare function createSuccessResult(result: ProtocolResult, info: CliRuntimeInfo, startedAt: number, modelTurns: number): Record<string, unknown>;
 export declare function createErrorResult(message: string, sessionId: string, startedAt: number, modelTurns: number): Record<string, unknown>;
+/**
+ * Returns the argument text of a headless `/color` prompt, or undefined when
+ * the prompt is not a bare `/color` command. A trailing space matches with an
+ * empty argument (random color), while `/colorblue` and `/colorful` are not
+ * the command.
+ */
+export declare function matchHeadlessColorCommand(prompt: string): string | undefined;
 export declare function parseCliInvocation(argv: readonly string[]): CliInvocation;
 export declare function readStreamJsonMessages(input: AsyncIterable<string | Uint8Array>): AsyncGenerator<StreamJsonMessage>;
 export declare function readStreamUserMessages(input: AsyncIterable<string | Uint8Array>): AsyncGenerator<StreamUserMessage>;
@@ -232,6 +239,12 @@ export declare class StreamJsonOutput {
     constructor(write: (value: unknown) => void, info: CliRuntimeInfo, sessionId: string, includePartialMessages: boolean, includeHookEvents?: boolean);
     init(): void;
     replayUser(message: StreamUserMessage['message']): void;
+    /**
+     * Emits the synthetic assistant message for a provider-free local command
+     * (e.g. /color). It must not touch the turn state, so the following result
+     * keeps num_turns 0 and no stream_event records are produced.
+     */
+    syntheticAssistant(text: string): void;
     controlRequest(request: {
         request_id: string;
         request: Record<string, unknown>;

package/dist/cli/protocol.js

@@ -80,6 +80,18 @@ export function createErrorResult(message, sessionId, startedAt, modelTurns) {
         uuid: randomUUID(),
     };
 }
+/**
+ * Returns the argument text of a headless `/color` prompt, or undefined when
+ * the prompt is not a bare `/color` command. A trailing space matches with an
+ * empty argument (random color), while `/colorblue` and `/colorful` are not
+ * the command.
+ */
+export function matchHeadlessColorCommand(prompt) {
+    const match = /^\/color(?:\s+([\s\S]*))?$/u.exec(prompt);
+    if (match === null)
+        return undefined;
+    return match[1] ?? '';
+}
 const INPUT_FORMATS = ['text', 'stream-json'];
 const OUTPUT_FORMATS = ['text', 'json', 'stream-json'];
 const PERMISSION_MODES = [
@@ -1594,6 +1606,28 @@ export class StreamJsonOutput {
     replayUser(message) {
         this.write({ type: 'user', message, session_id: this.sessionId });
     }
+    /**
+     * Emits the synthetic assistant message for a provider-free local command
+     * (e.g. /color). It must not touch the turn state, so the following result
+     * keeps num_turns 0 and no stream_event records are produced.
+     */
+    syntheticAssistant(text) {
+        this.write({
+            type: 'assistant',
+            message: {
+                id: randomUUID(),
+                type: 'message',
+                role: 'assistant',
+                model: '<synthetic>',
+                content: [{ type: 'text', text }],
+                stop_reason: 'stop_sequence',
+                stop_sequence: '',
+                usage: { input_tokens: 0, output_tokens: 0 },
+            },
+            parent_tool_use_id: null,
+            session_id: this.sessionId,
+        });
+    }
     controlRequest(request) {
         this.write({ type: 'control_request', ...request });
     }

package/dist/cli/tui/claude-command-inventory.d.ts

@@ -38,9 +38,8 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "color";
-    readonly disposition: "deferred";
+    readonly disposition: "included";
     readonly visibility: "visible";
-    readonly reason: "The dedicated /color contract is required; /theme is not a substitute.";
 }, {
     readonly name: "compact";
     readonly disposition: "included";

package/dist/cli/tui/claude-command-inventory.js

@@ -20,12 +20,7 @@ export const CLAUDE_2_1_208_COMMAND_INVENTORY = [
         reason: 'The CLI-driven Chrome integration is required parity work and is not implemented yet.',
     },
     { name: 'clear', disposition: 'included', visibility: 'visible' },
-    {
-        name: 'color',
-        disposition: 'deferred',
-        visibility: 'visible',
-        reason: 'The dedicated /color contract is required; /theme is not a substitute.',
-    },
+    { name: 'color', disposition: 'included', visibility: 'visible' },
     { name: 'compact', disposition: 'included', visibility: 'visible' },
     { name: 'config', disposition: 'included', visibility: 'visible' },
     { name: 'copy', disposition: 'included', visibility: 'visible' },

package/dist/cli/tui/claude-style.d.ts

@@ -1,4 +1,5 @@
 import type { ModelToolCall, ModelUsage } from '../../core/runtime.js';
+import type { AgentColorName } from '../../compatibility/claude/agent-color.js';
 import type { TuiFileEntry, TuiMentionEntry } from './file-picker.js';
 import { type TuiDiffSnapshot } from './git-diff.js';
 import { type TuiHookConfiguration } from './hook-settings.js';
@@ -230,7 +231,7 @@ export declare function ModelMenu({ options, effort, selectedIndex, width, scree
 export declare function ExternalEditorWait({ screenReader, }: {
     screenReader: boolean;
 }): import("react").JSX.Element;
-export declare function Composer({ input, cursor, busy, clipboardBusy, status, display, usage, costUsd, width, screenReader, hasThinking, thinkingExpanded, shortcutsVisible, shellMode, footerMessage, reduceMotion, progressBar, turnDuration, editorMode, prStatus, }: {
+export declare function Composer({ input, cursor, busy, clipboardBusy, status, display, usage, costUsd, width, screenReader, hasThinking, thinkingExpanded, shortcutsVisible, shellMode, footerMessage, reduceMotion, progressBar, turnDuration, editorMode, prStatus, sessionColor, commandArgumentHint, }: {
     input: string;
     cursor?: number;
     busy: boolean;
@@ -254,6 +255,8 @@ export declare function Composer({ input, cursor, busy, clipboardBusy, status, d
     turnDuration?: string;
     editorMode?: 'normal' | 'vim';
     prStatus?: string;
+    sessionColor?: AgentColorName;
+    commandArgumentHint?: string;
 }): import("react").JSX.Element;
 export declare function DialogFrame({ title, children, screenReader, }: {
     title: string;

package/dist/cli/tui/claude-style.js

@@ -659,7 +659,7 @@ export function ExternalEditorWait({ screenReader, }) {
         return _jsx(Text, { children: "External editor open. Save and close it to continue." });
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" }), _jsx(Text, { children: "Save and close editor to continue..." }), _jsx(Text, { dimColor: true, children: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" })] }));
 }
-export function Composer({ input, cursor, busy, clipboardBusy = false, status, display, usage, costUsd, width, screenReader, hasThinking = false, thinkingExpanded = false, shortcutsVisible = false, shellMode = false, footerMessage, reduceMotion = false, progressBar = true, turnDuration, editorMode = 'normal', prStatus, }) {
+export function Composer({ input, cursor, busy, clipboardBusy = false, status, display, usage, costUsd, width, screenReader, hasThinking = false, thinkingExpanded = false, shortcutsVisible = false, shellMode = false, footerMessage, reduceMotion = false, progressBar = true, turnDuration, editorMode = 'normal', prStatus, sessionColor, commandArgumentHint, }) {
     const palette = useTuiPalette();
     const [spinnerIndex, setSpinnerIndex] = useState(0);
     useEffect(() => {
@@ -677,15 +677,20 @@ export function Composer({ input, cursor, busy, clipboardBusy = false, status, d
                         ? `Shell command: ${input}`
                         : `Prompt: ${input}` }));
     const line = '─'.repeat(Math.max(12, Math.min(100, width)));
+    const separatorColor = sessionColor === undefined ? undefined : palette.sessionColors[sessionColor];
     return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [usage ? (_jsxs(Text, { dimColor: true, children: ["Context \u00B7 ", usage.inputTokens + usage.outputTokens, " tokens", display.contextWindowTokens
                         ? ` / ${display.contextWindowTokens} (${Math.min(100, Math.round(((usage.inputTokens + usage.outputTokens) /
                             display.contextWindowTokens) *
                             100))}%)`
                         : '', usage.cacheReadInputTokens
                         ? ` · ${usage.cacheReadInputTokens} cached`
-                        : '', costUsd === undefined ? '' : ` · $${costUsd.toFixed(6)}`] })) : null, _jsx(Text, { dimColor: true, children: line }), clipboardBusy ? (_jsx(Text, { children: "Pasting\u2026" })) : busy ? (_jsxs(Text, { children: [progressBar ? (_jsx(Text, { color: palette.accent, children: reduceMotion ? '•' : SPINNER[spinnerIndex] })) : null, ' ', status, "\u2026 ", _jsx(Text, { dimColor: true, children: "\u00B7 esc to interrupt" })] })) : (_jsxs(Text, { children: [_jsx(Text, { ...(shellMode ? {} : { color: palette.brand }), bold: true, children: shellMode ? '! ' : '❯ ' }), input ? (_jsx(ComposerInput, { cursor: cursor ?? Array.from(input).length, input: input })) : (_jsx(Text, { dimColor: true, children: shellMode
+                        : '', costUsd === undefined ? '' : ` · $${costUsd.toFixed(6)}`] })) : null, _jsx(Text, { ...(separatorColor === undefined
+                    ? { dimColor: true }
+                    : { color: separatorColor }), children: line }), clipboardBusy ? (_jsx(Text, { children: "Pasting\u2026" })) : busy ? (_jsxs(Text, { children: [progressBar ? (_jsx(Text, { color: palette.accent, children: reduceMotion ? '•' : SPINNER[spinnerIndex] })) : null, ' ', status, "\u2026 ", _jsx(Text, { dimColor: true, children: "\u00B7 esc to interrupt" })] })) : (_jsxs(Text, { children: [_jsx(Text, { ...(shellMode ? {} : { color: palette.brand }), bold: true, children: shellMode ? '! ' : '❯ ' }), input ? (_jsxs(Text, { children: [_jsx(ComposerInput, { cursor: cursor ?? Array.from(input).length, input: input }), commandArgumentHint ? (_jsxs(Text, { dimColor: true, children: [input.endsWith(' ') ? '' : ' ', commandArgumentHint] })) : null] })) : (_jsx(Text, { dimColor: true, children: shellMode
                             ? 'Enter a shell command'
-                            : 'Try "review this project"' }))] })), _jsx(Text, { dimColor: true, children: line }), shortcutsVisible ? (_jsx(ShortcutHelp, { width: width })) : (_jsxs(Box, { width: Math.min(100, width), children: [_jsx(Text, { dimColor: true, children: shellMode ? ('! for bash mode') : (_jsxs(_Fragment, { children: ["\u23F5\u23F5 ", permissionLabel(display.permissionMode), " \u00B7", ' ', busy ? 'esc to interrupt' : '? for shortcuts', " \u00B7 \u2190 for agents", hasThinking
+                            : 'Try "review this project"' }))] })), _jsx(Text, { ...(separatorColor === undefined
+                    ? { dimColor: true }
+                    : { color: separatorColor }), children: line }), shortcutsVisible ? (_jsx(ShortcutHelp, { width: width })) : (_jsxs(Box, { width: Math.min(100, width), children: [_jsx(Text, { dimColor: true, children: shellMode ? ('! for bash mode') : (_jsxs(_Fragment, { children: ["\u23F5\u23F5 ", permissionLabel(display.permissionMode), " \u00B7", ' ', busy ? 'esc to interrupt' : '? for shortcuts', " \u00B7 \u2190 for agents", hasThinking
                                     ? ` · ctrl+o ${thinkingExpanded ? 'collapse' : 'expand'}`
                                     : ''] })) }), _jsx(Box, { flexGrow: 1 }), footerMessage ? (footerMessage.isError ? (_jsx(Text, { color: palette.error, children: footerMessage.text })) : (_jsx(Text, { dimColor: true, children: footerMessage.text }))) : prStatus ? (_jsx(Text, { dimColor: true, children: prStatus })) : turnDuration ? (_jsxs(Text, { dimColor: true, children: ["Cooked for ", turnDuration] })) : display.effort ? (_jsxs(Text, { children: [_jsxs(Text, { color: palette.accent, children: ["\u25CF ", display.effort] }), _jsxs(Text, { dimColor: true, children: [' ', "\u00B7 ", editorMode === 'vim' ? 'vim' : '/effort'] })] })) : null] }))] }));
 }

package/dist/cli/tui/slash-commands.d.ts

@@ -3,6 +3,7 @@ export interface TuiSlashCommand {
     name: string;
     description: string;
     source: TuiSlashCommandSource;
+    argumentHint?: string;
     progressMessage?: string;
 }
 export declare const BUILTIN_TUI_SLASH_COMMANDS: readonly TuiSlashCommand[];

package/dist/cli/tui/slash-commands.js

@@ -4,6 +4,11 @@ export const BUILTIN_TUI_SLASH_COMMANDS = [
         description: 'Add a new working directory',
         source: 'builtin',
     },
+    {
+        name: 'agents',
+        description: '(removed) Ask Claude to create/manage subagents, or edit .claude/agents/',
+        source: 'builtin',
+    },
     {
         name: 'branch',
         description: 'Create a branch of the current conversation at this point',
@@ -29,6 +34,12 @@ export const BUILTIN_TUI_SLASH_COMMANDS = [
         description: 'Start a new session with empty context; previous session stays on disk (resumable with /resume)',
         source: 'builtin',
     },
+    {
+        name: 'color',
+        description: 'Set the prompt bar color for this session',
+        argumentHint: '[red|blue|green|yellow|purple|orange|pink|cyan|default]',
+        source: 'builtin',
+    },
     {
         name: 'compact',
         description: 'Clear conversation history but keep a summary in context',

package/dist/cli/tui/theme.d.ts

@@ -1,4 +1,5 @@
 import { type ReactNode } from 'react';
+import type { AgentColorName } from '../../compatibility/claude/agent-color.js';
 import type { TuiCustomTheme } from './custom-themes.js';
 export declare const TUI_THEMES: readonly ["auto", "dark", "light", "dark-daltonized", "light-daltonized", "dark-ansi", "light-ansi"];
 export type TuiTheme = (typeof TUI_THEMES)[number];
@@ -31,6 +32,7 @@ export interface TuiPalette {
     warning: string;
     muted: string;
     selectionText: string;
+    sessionColors: Readonly<Record<AgentColorName, string>>;
     syntaxTheme: 'Monokai Extended' | 'GitHub' | 'ansi';
     syntax: TuiSyntaxPalette;
 }

package/dist/cli/tui/theme.js

@@ -44,6 +44,56 @@ const LIGHT_SYNTAX = {
     addedBackground: '#d7ffd7',
     addedHighlight: '#afffaf',
 };
+const NORMAL_SESSION_COLORS = {
+    red: '#dc2626',
+    blue: '#2563eb',
+    green: '#16a34a',
+    yellow: '#ca8a04',
+    purple: '#9333ea',
+    orange: '#ea580c',
+    pink: '#db2777',
+    cyan: '#0891b2',
+};
+const LIGHT_ANSI_SESSION_COLORS = {
+    red: 'red',
+    blue: 'blue',
+    green: 'green',
+    yellow: 'yellow',
+    purple: 'magenta',
+    orange: 'redBright',
+    pink: 'magentaBright',
+    cyan: 'cyan',
+};
+const DARK_ANSI_SESSION_COLORS = {
+    red: 'redBright',
+    blue: 'blueBright',
+    green: 'greenBright',
+    yellow: 'yellowBright',
+    purple: 'magentaBright',
+    orange: 'redBright',
+    pink: 'magentaBright',
+    cyan: 'cyanBright',
+};
+const LIGHT_DALTONIZED_SESSION_COLORS = {
+    red: '#cc0000',
+    blue: '#0066cc',
+    green: '#00cc00',
+    yellow: '#ffcc00',
+    purple: '#800080',
+    orange: '#ff8000',
+    pink: '#ff66b2',
+    cyan: '#00b2b2',
+};
+const DARK_DALTONIZED_SESSION_COLORS = {
+    red: '#ff6666',
+    blue: '#66b2ff',
+    green: '#66ff66',
+    yellow: '#ffff66',
+    purple: '#b266ff',
+    orange: '#ffb266',
+    pink: '#ff99cc',
+    cyan: '#66cccc',
+};
 function automaticDark(environment) {
     const background = environment.COLORFGBG?.split(';').at(-1);
     return background === undefined || Number(background) < 8;
@@ -195,11 +245,30 @@ export function tuiPalette(profile, syntaxHighlightingDisabled = false, environm
         ? adaptSyntaxColors(syntaxBase, adaptAutoColor)
         : syntaxBase;
     const autoColor = (color) => profile === 'auto' ? adaptAutoColor(color) : color;
+    const sessionColors = ansiOnly
+        ? dark
+            ? DARK_ANSI_SESSION_COLORS
+            : LIGHT_ANSI_SESSION_COLORS
+        : daltonized
+            ? dark
+                ? DARK_DALTONIZED_SESSION_COLORS
+                : LIGHT_DALTONIZED_SESSION_COLORS
+            : {
+                red: autoColor(NORMAL_SESSION_COLORS.red),
+                blue: autoColor(NORMAL_SESSION_COLORS.blue),
+                green: autoColor(NORMAL_SESSION_COLORS.green),
+                yellow: autoColor(NORMAL_SESSION_COLORS.yellow),
+                purple: autoColor(NORMAL_SESSION_COLORS.purple),
+                orange: autoColor(NORMAL_SESSION_COLORS.orange),
+                pink: autoColor(NORMAL_SESSION_COLORS.pink),
+                cyan: autoColor(NORMAL_SESSION_COLORS.cyan),
+            };
     const palette = {
         profile,
         dark,
         ansiOnly,
         syntaxHighlightingDisabled,
+        sessionColors,
         brand: ansiOnly ? 'redBright' : autoColor('#D97757'),
         accent: ansiOnly
             ? 'magentaBright'

package/dist/cli.d.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { type ForkResult, type ManualCompactResult, type ManualCompactSelection, type RewindPoint, type SessionForkCheckpoint, type SessionInspection, type SessionRunResult, type SessionSummary, type SideQuestionForkResult, type SideQuestionResult } from './application/session-service.js';
+import { type AgentColorName, type AgentColorSelection } from './compatibility/claude/agent-color.js';
 import type { ClaudeDisplayTranscriptItem } from './compatibility/claude/projection.js';
 import { type ModelDocument, type ModelImage, type ModelProvider, type ModelToolCall, type PermissionApproval, type PermissionDecision, type ToolRegistry, type RuntimeEventSink } from './core/runtime.js';
 import type { InteractiveResumeOptions, InteractiveServiceFactory } from './cli/interactive.js';
@@ -40,6 +41,10 @@ interface SessionCommands {
     retryRecentlyDenied?(sessionId: string, display: string, signal?: AbortSignal): Promise<SessionRunResult>;
     answerSideQuestion?(sessionId: string | undefined, question: string, signal?: AbortSignal, onDelta?: (delta: string) => void, permissionMode?: ClaudePermissionMode): Promise<SideQuestionResult>;
     recordBtwUsage?(sessionId: string | undefined, permissionMode?: ClaudePermissionMode): Promise<string>;
+    recordColorUsage?(sessionId: string | undefined, selection: AgentColorSelection, display: string, permissionMode?: ClaudePermissionMode, options?: {
+        createSession?: boolean;
+    }): Promise<string>;
+    agentColor?(sessionId: string): Promise<AgentColorName | undefined>;
     recordBackgroundUsage?(sessionId: string | undefined, permissionMode?: ClaudePermissionMode): Promise<string>;
     recordBackgroundLaunch?(sessionId: string): Promise<SessionForkCheckpoint>;
     forkSideQuestion?(sessionId: string, question: string, signal?: AbortSignal): Promise<SideQuestionForkResult>;
@@ -67,6 +72,7 @@ interface SessionCommands {
     mcpTools?(name: string): Promise<readonly ClaudeMcpToolInspection[]>;
     close?(): Promise<void>;
     runtimeInfo?(): CliRuntimeInfo;
+    initialAgentPrompt?(): string | undefined;
     agentDefinitions?(): readonly {
         name: string;
         description: string;