@truss-harness/tui 0.1.19 → 0.1.21

package/dist/bin.js

@@ -14,6 +14,7 @@ import { useTuiInputController } from "./input-controller.js";
 import { calculateLayout, focusReducer } from "./layout.js";
 import { openExternalPreview } from "./processes.js";
 import { useRuntimeSessionController } from "./runtime-session.js";
+import { useSkillsController } from "./skills-controller.js";
 import { useTerminalController } from "./terminal-controller.js";
 import { tuiTheme } from "./theme.js";
 import { useWorkspaceFiles } from "./workspace-files.js";
@@ -110,6 +111,7 @@ function App({ initialConfiguration, }) {
         closeSearch: () => setScreen("workspace"),
     });
     const { fileIndex, setFileIndex, fileTree, selectedFileTreeEntry, fileSearchInput, setFileSearchInput, fileSearchIndex, setFileSearchIndex, fileSearchResults, openFilePath, editorTitle, setEditorScroll, editorRows, visibleEditorRows, fileTreeStart, visibleFileTree, loadFile, toggleDirectory, openSearchResult, toggleDiff, } = workspaceFiles;
+    const skillsController = useSkillsController(workspaceRoot, initialConfiguration?.skills);
     const runtimeSession = useRuntimeSessionController({
         initialConfiguration,
         workspaceRoot,
@@ -123,6 +125,7 @@ function App({ initialConfiguration, }) {
         contextWindow,
         appendTerminal,
         showScreen: setScreen,
+        skills: skillsController.skills,
     });
     const { configuration, mcpStatuses, sessionId, chatInput, setChatInput, chat, chatScroll, setChatScroll, busy, runStatus, activePlan, pendingTool, tokensPerSecond, configureRuntime, sendPrompt, resolveApproval, startNewConversation, cancelRun, testMcpConnections, } = runtimeSession;
     const contextTokens = useMemo(() => chat.reduce((total, message) => total + estimateTokens(message.content), 400), [chat]);
@@ -226,6 +229,7 @@ function App({ initialConfiguration, }) {
             editorLineCount,
             chatTranscriptLength: chatTranscript.length,
             chatLineCount,
+            chatInput,
         },
         setters: {
             setScreen,
@@ -262,6 +266,15 @@ function App({ initialConfiguration, }) {
             loadFile: (entry) => void loadFile(entry),
             toggleDiff: () => void toggleDiff(),
             sendPrompt: () => void sendPrompt(),
+            openSkills: () => {
+                skillsController.refreshSkills();
+                setScreen("skills");
+            },
+            moveSkill: skillsController.moveSkill,
+            toggleSkill: skillsController.toggleSkill,
+            cycleSkillMode: skillsController.cycleSkillMode,
+            toggleSuperpowers: skillsController.toggleSuperpowers,
+            toggleSkillScope: skillsController.toggleSkillScope,
         },
     });
     return (_jsx(TuiWorkspaceView, { viewport: viewport, layout: layout, theme: theme, configuration: configuration, runStatus: runStatus, busy: busy, contextTokens: contextTokens, contextWindow: contextWindow, tokensPerSecond: tokensPerSecond, previewUrl: previewUrl, focus: focus, visibleFileTree: visibleFileTree, fileTreeLength: fileTree.length, fileTreeStart: fileTreeStart, fileIndex: fileIndex, openFilePath: openFilePath, editorTitle: editorTitle, visibleEditorRows: visibleEditorRows, activePlan: activePlan, chatLines: chatLines, chatScroll: chatScroll, chatInput: chatInput, visibleTerminalLines: visibleTerminalLines, commandInput: commandInput, sessionId: sessionId, overlays: {
@@ -282,6 +295,14 @@ function App({ initialConfiguration, }) {
             pendingTool,
             agentProfiles,
             mcpStatuses,
+            skills: {
+                state: skillsController.skillState,
+                index: skillsController.skillIndex,
+                scope: skillsController.skillScope,
+                ...(skillsController.skillError
+                    ? { error: skillsController.skillError }
+                    : {}),
+            },
         } }));
 }
 const initialConfiguration = await resolveConfiguration({

package/dist/components.d.ts

@@ -1,6 +1,8 @@
+import type { RuntimeServiceSkillState } from "@truss-harness/cli/protocol";
 import type { LocalModelEndpoint } from "@truss-harness/provider-openai-compatible";
 import type { AgentProfile, ToolCall } from "@truss-harness/runtime";
 import type { FileEntry } from "./file-browser.js";
+import { type SkillScope } from "./skills-controller.js";
 import type { TuiTheme, TuiThemeName } from "./theme.js";
 import type { Screen, SettingsField } from "./types.js";
 export declare function Panel({ title, active, theme, children, }: {
@@ -39,6 +41,13 @@ export interface TuiOverlaysProps {
     readonly pendingTool?: ToolCall;
     readonly agentProfiles: readonly AgentProfile[];
     readonly mcpStatuses: readonly McpServerView[];
+    readonly skills?: TuiSkillsView;
+}
+export interface TuiSkillsView {
+    readonly state?: RuntimeServiceSkillState;
+    readonly index: number;
+    readonly scope: SkillScope;
+    readonly error?: string;
 }
 export declare function TuiOverlays(props: TuiOverlaysProps): React.ReactElement;
 export {};

package/dist/components.js

@@ -1,7 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { brand } from "@truss-harness/branding";
 import { workspaceCommandHelp } from "@truss-harness/runtime";
 import { Box, Text } from "ink";
 import { truncate } from "./display.js";
+import { skillPickerRows } from "./skills-controller.js";
 export function Panel({ title, active, theme, children, }) {
     return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: active ? theme.focus : theme.panel, paddingX: 1, width: "100%", height: "100%", overflow: "hidden", children: [_jsx(Text, { color: active ? theme.focus : theme.muted, bold: true, children: title }), children] }));
 }
@@ -22,6 +24,10 @@ const tuiControlHelp = [
         "AGENT",
         "Enter sends; a opens saved multi-agent profiles; Up/Down scroll chat; n starts a new conversation outside the chat input.",
     ],
+    [
+        "SKILLS",
+        "s outside chat, or /skills in chat, opens the skill picker; Space selects, M mode, P Superpowers, W scope.",
+    ],
     [
         "MCP",
         "c opens credential-safe server and tool status; R tests configured servers.",
@@ -40,8 +46,11 @@ const tuiControlHelp = [
         "Escape cancels an active agent run. Ctrl+C stops a process or run, and exits while idle.",
     ],
 ];
+const visibleSkillRows = 12;
 export function TuiOverlays(props) {
-    const { screen, theme, overlayWidth, fileSearchInput, fileSearchResults, fileSearchIndex, settingsField, selectedEndpoint, endpointInput, modelInput, models, modelIndex, internetAccess, themeName, providerKind, pendingTool, agentProfiles, mcpStatuses, } = props;
+    const { screen, theme, overlayWidth, fileSearchInput, fileSearchResults, fileSearchIndex, settingsField, selectedEndpoint, endpointInput, modelInput, models, modelIndex, internetAccess, themeName, providerKind, pendingTool, agentProfiles, mcpStatuses, skills, } = props;
+    const skillRows = skills?.state ? skillPickerRows(skills.state) : [];
+    const skillStart = Math.max(0, Math.min((skills?.index ?? 0) - Math.floor(visibleSkillRows / 2), skillRows.length - visibleSkillRows));
     return (_jsxs(_Fragment, { children: [screen === "file-search" && (_jsxs(Box, { position: "absolute", flexDirection: "column", borderStyle: "double", borderColor: theme.focus, paddingX: 2, paddingY: 1, width: overlayWidth, marginLeft: 2, marginTop: 3, backgroundColor: theme.overlay, children: [_jsx(Text, { bold: true, color: theme.accent, children: "FIND FILE" }), _jsxs(Text, { color: theme.text, children: [_jsx(Text, { color: theme.focus, children: "> " }), fileSearchInput || (_jsx(Text, { color: theme.muted, children: "Type part of a file name or path" }))] }), _jsx(Text, { color: theme.muted, children: "Up/Down select Enter open Escape close" }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [fileSearchResults.map((entry, index) => {
                                 const selected = index ===
                                     Math.min(fileSearchIndex, Math.max(0, fileSearchResults.length - 1));
@@ -53,7 +62,16 @@ export function TuiOverlays(props) {
                                                 ? theme.success
                                                 : theme.warning, children: [_jsx(Text, { bold: true, children: server.name }), " ", server.state, server.error
                                                 ? ` — ${server.error}`
-                                                : ` — ${server.toolCount} tool${server.toolCount === 1 ? "" : "s"}`] }), (server.tools ?? []).map((tool) => (_jsxs(Text, { color: theme.muted, children: ["  ", tool.name, " [", tool.readOnly ? "read-only" : "approval", "]"] }, `${server.name}:${tool.name}`)))] }, server.name))), !mcpStatuses.length && (_jsx(Text, { color: theme.warning, children: "No MCP servers configured." }))] }), _jsx(Text, { color: theme.muted, children: "R tests configured servers. C or Escape closes." })] })), screen === "help" && (_jsxs(Box, { position: "absolute", flexDirection: "column", borderStyle: "double", borderColor: theme.focus, paddingX: 2, paddingY: 1, width: overlayWidth, marginLeft: 2, marginTop: 7, backgroundColor: theme.overlay, children: [_jsx(Text, { bold: true, color: theme.accent, children: "TUI CONTROLS" }), tuiControlHelp.map(([label, detail]) => (_jsxs(Text, { color: theme.text, wrap: "wrap", children: [_jsxs(Text, { bold: true, color: theme.focus, children: [label, ":", " "] }), detail] }, label))), _jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, color: theme.accent, children: "WORKSPACE COMMANDS" }) }), workspaceCommandHelp()
+                                                : ` — ${server.toolCount} tool${server.toolCount === 1 ? "" : "s"}`] }), (server.tools ?? []).map((tool) => (_jsxs(Text, { color: theme.muted, children: ["  ", tool.name, " [", tool.readOnly ? "read-only" : "approval", "]"] }, `${server.name}:${tool.name}`)))] }, server.name))), !mcpStatuses.length && (_jsx(Text, { color: theme.warning, children: "No MCP servers configured." }))] }), _jsx(Text, { color: theme.muted, children: "R tests configured servers. C or Escape closes." })] })), screen === "skills" && (_jsxs(Box, { position: "absolute", flexDirection: "column", borderStyle: "double", borderColor: theme.focus, paddingX: 2, paddingY: 1, width: overlayWidth, marginLeft: 2, marginTop: 4, backgroundColor: theme.overlay, children: [_jsx(Text, { bold: true, color: theme.accent, children: "SKILLS" }), skills?.state ? (_jsxs(Text, { color: theme.text, children: ["Mode ", skills.state.selection.mode, " \u00B7 Superpowers", " ", skills.state.selection.superpowersEnabled ? "on" : "off", " \u00B7 Saving for", " ", skills.scope === "user" ? "all workspaces" : "this workspace"] })) : (_jsx(Text, { color: theme.muted, children: "Loading skills..." })), _jsx(Box, { flexDirection: "column", marginTop: 1, children: skillRows
+                            .slice(skillStart, skillStart + visibleSkillRows)
+                            .map((row, offset) => {
+                            const active = skillStart + offset === skills?.index;
+                            return (_jsxs(Text, { color: active
+                                    ? theme.focus
+                                    : row.available
+                                        ? theme.text
+                                        : theme.muted, wrap: "truncate-end", children: [active ? "> " : "  ", "[", row.selected ? "x" : " ", "] ", row.id, row.note ? ` (${row.note})` : "", " ", row.description] }, row.id));
+                        }) }), skills?.error && _jsx(Text, { color: theme.warning, children: skills.error }), _jsx(Text, { color: theme.muted, wrap: "wrap", children: `Space marks a skill always active. M cycles Automatic, Manual, Off. P toggles Superpowers. W switches all workspaces or this one. Changes apply to the next run. Import with \`${brand.cliCommand} skills add <folder>\`. S or Escape closes.` })] })), screen === "help" && (_jsxs(Box, { position: "absolute", flexDirection: "column", borderStyle: "double", borderColor: theme.focus, paddingX: 2, paddingY: 1, width: overlayWidth, marginLeft: 2, marginTop: 7, backgroundColor: theme.overlay, children: [_jsx(Text, { bold: true, color: theme.accent, children: "TUI CONTROLS" }), tuiControlHelp.map(([label, detail]) => (_jsxs(Text, { color: theme.text, wrap: "wrap", children: [_jsxs(Text, { bold: true, color: theme.focus, children: [label, ":", " "] }), detail] }, label))), _jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, color: theme.accent, children: "WORKSPACE COMMANDS" }) }), workspaceCommandHelp()
                         .split("\n")
                         .slice(1)
                         .map((line) => (_jsx(Text, { color: theme.text, children: line }, line))), _jsx(Text, { color: theme.muted, children: "Press any key to close this reference." })] }))] }));

package/dist/file-browser.js

@@ -32,7 +32,7 @@ export function buildFileTree(files, collapsed) {
                 kind: "file",
                 path: file.path,
                 name: file.path.split("/").at(-1) ?? file.path,
-                depth
+                depth,
             });
         }
     };
@@ -68,12 +68,38 @@ export function fuzzyFiles(files, query, limit = 12) {
         const score = fuzzyScore(file.path, query);
         return score === undefined ? [] : [{ file, score }];
     })
-        .sort((left, right) => left.score - right.score || left.file.path.localeCompare(right.file.path))
+        .sort((left, right) => left.score - right.score ||
+        left.file.path.localeCompare(right.file.path))
         .slice(0, limit)
         .map(({ file }) => file);
 }
-const codeExtensions = new Set([".c", ".cc", ".cpp", ".cs", ".go", ".java", ".js", ".jsx", ".kt", ".mjs", ".php", ".py", ".rb", ".rs", ".sh", ".ts", ".tsx"]);
-const markupExtensions = new Set([".html", ".htm", ".svg", ".vue", ".svelte", ".xml"]);
+const codeExtensions = new Set([
+    ".c",
+    ".cc",
+    ".cpp",
+    ".cs",
+    ".go",
+    ".java",
+    ".js",
+    ".jsx",
+    ".kt",
+    ".mjs",
+    ".php",
+    ".py",
+    ".rb",
+    ".rs",
+    ".sh",
+    ".ts",
+    ".tsx",
+]);
+const markupExtensions = new Set([
+    ".html",
+    ".htm",
+    ".svg",
+    ".vue",
+    ".svelte",
+    ".xml",
+]);
 const dataExtensions = new Set([".json", ".jsonc", ".yaml", ".yml", ".toml"]);
 function tokenize(line, pattern, colors) {
     const result = [];
@@ -83,7 +109,11 @@ function tokenize(line, pattern, colors) {
         if (index > cursor)
             result.push({ text: line.slice(cursor, index) });
         const group = match.slice(1).findIndex((value) => value !== undefined);
-        result.push({ text: match[0], color: colors[Math.max(0, group)], dim: group === 0 });
+        result.push({
+            text: match[0],
+            color: colors[Math.max(0, group)],
+            dim: group === 0,
+        });
         cursor = index + match[0].length;
     }
     if (cursor < line.length)
@@ -105,7 +135,13 @@ export function syntaxTokens(line, path) {
         const comment = extension === ".py" || extension === ".rb" || extension === ".sh"
             ? /(#.*$)|("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|`(?:\\.|[^`\\])*`)|(\b(?:as|async|await|break|case|catch|class|const|continue|def|default|delete|do|else|enum|export|extends|false|finally|fn|for|from|function|if|implements|import|in|instanceof|interface|let|match|new|null|package|private|protected|public|return|static|struct|super|switch|this|throw|true|try|type|typeof|undefined|use|var|void|while|yield)\b)|(\b(?:0x[\da-f]+|\d+(?:\.\d+)?)\b)|([{}()[\].,:;=+\-*/<>!?&|]+)/gi
             : /(\/\/.*$)|("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|`(?:\\.|[^`\\])*`)|(\b(?:as|async|await|break|case|catch|class|const|continue|def|default|delete|do|else|enum|export|extends|false|finally|fn|for|from|function|if|implements|import|in|instanceof|interface|let|match|new|null|package|private|protected|public|return|static|struct|super|switch|this|throw|true|try|type|typeof|undefined|use|var|void|while|yield)\b)|(\b(?:0x[\da-f]+|\d+(?:\.\d+)?)\b)|([{}()[\].,:;=+\-*/<>!?&|]+)/gi;
-        return tokenize(line, comment, ["gray", "green", "magenta", "yellow", "cyan"]);
+        return tokenize(line, comment, [
+            "gray",
+            "green",
+            "magenta",
+            "yellow",
+            "cyan",
+        ]);
     }
     return [{ text: line }];
 }

package/dist/input-controller.d.ts

@@ -28,6 +28,7 @@ interface InputState {
     readonly editorLineCount: number;
     readonly chatTranscriptLength: number;
     readonly chatLineCount: number;
+    readonly chatInput: string;
 }
 interface InputSetters {
     readonly setScreen: Setter<Screen>;
@@ -64,6 +65,12 @@ interface InputActions {
     readonly loadFile: (entry: FileEntry) => void;
     readonly toggleDiff: () => void;
     readonly sendPrompt: () => void;
+    readonly openSkills: () => void;
+    readonly moveSkill: (delta: number) => void;
+    readonly toggleSkill: () => void;
+    readonly cycleSkillMode: () => void;
+    readonly toggleSuperpowers: () => void;
+    readonly toggleSkillScope: () => void;
 }
 export interface TuiInputControllerOptions {
     readonly state: InputState;

package/dist/input-controller.js

@@ -56,6 +56,25 @@ export function useTuiInputController({ state, setters, actions, }) {
                 actions.refreshAgentProfiles();
             return;
         }
+        if (state.screen === "skills") {
+            if (key.escape || input === "s") {
+                setters.setScreen("workspace");
+                return;
+            }
+            if (key.upArrow)
+                actions.moveSkill(-1);
+            else if (key.downArrow)
+                actions.moveSkill(1);
+            else if (input === " " || key.return)
+                actions.toggleSkill();
+            else if (input.toLowerCase() === "m")
+                actions.cycleSkillMode();
+            else if (input.toLowerCase() === "p")
+                actions.toggleSuperpowers();
+            else if (input.toLowerCase() === "w")
+                actions.toggleSkillScope();
+            return;
+        }
         if (state.screen === "mcp") {
             if (key.escape || input.toLowerCase() === "c") {
                 setters.setScreen("workspace");
@@ -193,6 +212,10 @@ export function useTuiInputController({ state, setters, actions, }) {
             setters.setScreen("mcp");
             return;
         }
+        if (input === "s" && state.focus !== "chat") {
+            actions.openSkills();
+            return;
+        }
         if (input === "n" && state.focus !== "chat") {
             actions.startNewConversation();
             return;
@@ -240,6 +263,11 @@ export function useTuiInputController({ state, setters, actions, }) {
             return;
         }
         if (key.return) {
+            if (state.chatInput.trim() === "/skills") {
+                setters.setChatInput("");
+                actions.openSkills();
+                return;
+            }
             actions.sendPrompt();
             return;
         }

package/dist/runtime-session.d.ts

@@ -16,8 +16,10 @@ export interface RuntimeSessionOptions {
     readonly contextWindow: number;
     readonly appendTerminal: (output: string) => void;
     readonly showScreen: (screen: Screen) => void;
+    /** Shared skill wiring for every runtime this session creates. */
+    readonly skills: () => Promise<ResolvedConfiguration["skills"]>;
 }
-export declare function useRuntimeSessionController({ initialConfiguration, workspaceRoot, providerKind, endpointInput, modelInput, agentMode, permissionMode, internetAccess, openFilePath, contextWindow, appendTerminal, showScreen, }: RuntimeSessionOptions): {
+export declare function useRuntimeSessionController({ initialConfiguration, workspaceRoot, providerKind, endpointInput, modelInput, agentMode, permissionMode, internetAccess, openFilePath, contextWindow, appendTerminal, showScreen, skills, }: RuntimeSessionOptions): {
     configuration: ClientConfiguration | undefined;
     mcpStatuses: readonly import("@truss-harness/mcp").McpServerStatus[];
     sessionId: string | undefined;

package/dist/runtime-session.js

@@ -5,7 +5,7 @@ import { cloudProviderDefinition, isCloudProviderId, } from "@truss-harness/prov
 import { executeWorkspaceCommand, FileWorkspacePlanStore, } from "@truss-harness/runtime";
 import { useEffect, useRef, useState } from "react";
 import { estimateTokens, truncate } from "./display.js";
-export function useRuntimeSessionController({ initialConfiguration, workspaceRoot, providerKind, endpointInput, modelInput, agentMode, permissionMode, internetAccess, openFilePath, contextWindow, appendTerminal, showScreen, }) {
+export function useRuntimeSessionController({ initialConfiguration, workspaceRoot, providerKind, endpointInput, modelInput, agentMode, permissionMode, internetAccess, openFilePath, contextWindow, appendTerminal, showScreen, skills, }) {
     const [configuration, setConfiguration] = useState(initialConfiguration);
     const [client, setClient] = useState();
     const [mcpStatuses, setMcpStatuses] = useState(() => Object.entries(initialConfiguration?.mcpServers ?? {}).map(([name, server]) => ({
@@ -100,10 +100,16 @@ export function useRuntimeSessionController({ initialConfiguration, workspaceRoo
                         ? process.env[cloudProviderDefinition(providerKind)
                             .apiKeyEnvironmentVariable]
                         : undefined)),
-            systemPrompt: process.env.TRUSS_HARNESS_SYSTEM_PROMPT,
+            systemPrompt: process.env.TRUSS_HARNESS_MASTER_PROMPT
+                ? undefined
+                : process.env.TRUSS_HARNESS_SYSTEM_PROMPT,
+            masterPrompt: process.env.TRUSS_HARNESS_MASTER_PROMPT
+                ? { enabled: true, template: process.env.TRUSS_HARNESS_MASTER_PROMPT }
+                : undefined,
             mode: agentMode,
             internetAccess,
             mcpServers: initialConfiguration?.mcpServers,
+            skills: await skills(),
             approval: {
                 approve: async (call) => {
                     const readOnly = [

package/dist/skills-controller.d.ts

@@ -0,0 +1,36 @@
+import { type ResolvedConfiguration } from "@truss-harness/cli/config";
+import type { RuntimeServiceSkillState } from "@truss-harness/cli/protocol";
+import type { SkillMode, SkillSelection } from "@truss-harness/runtime";
+export type SkillScope = "user" | "workspace";
+type DefaultSkills = ResolvedConfiguration["skills"];
+export interface SkillPickerRow {
+    readonly id: string;
+    readonly description: string;
+    readonly selected: boolean;
+    readonly available: boolean;
+    readonly note?: string;
+}
+export declare function skillPickerRows(state: RuntimeServiceSkillState): SkillPickerRow[];
+export declare function nextSkillMode(mode: SkillMode): SkillMode;
+/** Space on a row: unavailable skills can be cleared but never added. */
+export declare function toggledSkillSelection(state: RuntimeServiceSkillState, row: SkillPickerRow): Partial<SkillSelection> | undefined;
+/** Turning the pack off drops selected pack skills so runs stay valid. */
+export declare function superpowersSelection(selection: SkillSelection): Partial<SkillSelection>;
+/**
+ * Keyboard skill picker state. Skills come from the same user store and
+ * settings file as the CLI, so changes apply to every client's next run.
+ */
+export declare function useSkillsController(workspaceRoot: string, configured?: DefaultSkills): {
+    refreshSkills: () => void;
+    moveSkill: (delta: number) => void;
+    toggleSkill: () => void;
+    cycleSkillMode: () => void;
+    toggleSuperpowers: () => void;
+    toggleSkillScope: () => void;
+    skills: () => Promise<DefaultSkills>;
+    skillState: RuntimeServiceSkillState | undefined;
+    skillIndex: number;
+    skillScope: SkillScope;
+    skillError: string | undefined;
+};
+export {};

package/dist/skills-controller.js

@@ -0,0 +1,102 @@
+import { resolveSkills, } from "@truss-harness/cli/config";
+import { skillServiceHost } from "@truss-harness/cli/skills";
+import { useCallback, useMemo, useRef, useState } from "react";
+const superpowersPrefix = "superpowers:";
+const modes = ["automatic", "manual", "off"];
+export function skillPickerRows(state) {
+    const selected = new Set(state.selection.skillIds);
+    return state.skills.map((skill) => {
+        const packOff = skill.id.startsWith(superpowersPrefix) &&
+            !state.selection.superpowersEnabled;
+        const note = !skill.trusted
+            ? "untrusted: import to use"
+            : packOff
+                ? "pack off"
+                : undefined;
+        return {
+            id: skill.id,
+            description: skill.description,
+            selected: selected.has(skill.id),
+            available: skill.trusted && !packOff,
+            ...(note ? { note } : {}),
+        };
+    });
+}
+export function nextSkillMode(mode) {
+    return modes[(modes.indexOf(mode) + 1) % modes.length] ?? "automatic";
+}
+/** Space on a row: unavailable skills can be cleared but never added. */
+export function toggledSkillSelection(state, row) {
+    if (!row.selected && !row.available)
+        return undefined;
+    const rest = state.selection.skillIds.filter((id) => id !== row.id);
+    return { skillIds: row.selected ? rest : [...rest, row.id] };
+}
+/** Turning the pack off drops selected pack skills so runs stay valid. */
+export function superpowersSelection(selection) {
+    return selection.superpowersEnabled
+        ? {
+            superpowersEnabled: false,
+            skillIds: selection.skillIds.filter((id) => !id.startsWith(superpowersPrefix)),
+        }
+        : { superpowersEnabled: true };
+}
+/**
+ * Keyboard skill picker state. Skills come from the same user store and
+ * settings file as the CLI, so changes apply to every client's next run.
+ */
+export function useSkillsController(workspaceRoot, configured) {
+    const resolved = useRef(undefined);
+    const skills = useCallback(() => {
+        if (configured)
+            return Promise.resolve(configured);
+        resolved.current ??= resolveSkills({ workspaceRoot });
+        return resolved.current;
+    }, [configured, workspaceRoot]);
+    const [skillState, setSkillState] = useState();
+    const [skillIndex, setSkillIndex] = useState(0);
+    const [skillScope, setSkillScope] = useState("user");
+    const [skillError, setSkillError] = useState();
+    const run = useCallback((action) => {
+        void skills()
+            .then((value) => action(skillServiceHost(value, workspaceRoot)))
+            .then((next) => {
+            setSkillState(next);
+            setSkillError(undefined);
+            setSkillIndex((index) => Math.min(index, Math.max(0, next.skills.length - 1)));
+        })
+            .catch((error) => setSkillError(error instanceof Error ? error.message : String(error)));
+    }, [skills, workspaceRoot]);
+    const actions = useMemo(() => {
+        const save = (selection) => {
+            if (selection)
+                run((host) => host.setSettings(skillScope, undefined, selection));
+        };
+        return {
+            refreshSkills: () => run((host) => host.list()),
+            moveSkill: (delta) => setSkillIndex((index) => Math.min(Math.max(0, index + delta), Math.max(0, (skillState?.skills.length ?? 1) - 1))),
+            toggleSkill: () => {
+                const row = skillState && skillPickerRows(skillState)[skillIndex];
+                if (skillState && row)
+                    save(toggledSkillSelection(skillState, row));
+            },
+            cycleSkillMode: () => {
+                if (skillState)
+                    save({ mode: nextSkillMode(skillState.selection.mode) });
+            },
+            toggleSuperpowers: () => {
+                if (skillState)
+                    save(superpowersSelection(skillState.selection));
+            },
+            toggleSkillScope: () => setSkillScope((scope) => (scope === "user" ? "workspace" : "user")),
+        };
+    }, [run, skillIndex, skillScope, skillState]);
+    return {
+        skills,
+        skillState,
+        skillIndex,
+        skillScope,
+        skillError,
+        ...actions,
+    };
+}

package/dist/theme.js

@@ -14,7 +14,15 @@ export const tuiThemes = {
         warning: "#d3b978",
         error: "#d79a8e",
         overlay: "#13231d",
-        syntax: { blue: "#9eb4cf", cyan: "#8cc8bd", gray: "#71867d", green: "#a9c994", magenta: "#c4a8c8", red: "#d4958a", yellow: "#d6c184" }
+        syntax: {
+            blue: "#9eb4cf",
+            cyan: "#8cc8bd",
+            gray: "#71867d",
+            green: "#a9c994",
+            magenta: "#c4a8c8",
+            red: "#d4958a",
+            yellow: "#d6c184",
+        },
     },
     sage: {
         name: "sage",
@@ -30,7 +38,15 @@ export const tuiThemes = {
         warning: "#d6ba83",
         error: "#d69b91",
         overlay: "#1a241d",
-        syntax: { blue: "#9eafcf", cyan: "#89c0b4", gray: "#7d8d80", green: "#afcc9a", magenta: "#c5aac4", red: "#d5958d", yellow: "#d7c183" }
+        syntax: {
+            blue: "#9eafcf",
+            cyan: "#89c0b4",
+            gray: "#7d8d80",
+            green: "#afcc9a",
+            magenta: "#c5aac4",
+            red: "#d5958d",
+            yellow: "#d7c183",
+        },
     },
     dusk: {
         name: "dusk",
@@ -46,11 +62,19 @@ export const tuiThemes = {
         warning: "#ceb776",
         error: "#d29289",
         overlay: "#101d1c",
-        syntax: { blue: "#93aaca", cyan: "#7eb9ae", gray: "#687d76", green: "#9dbf8c", magenta: "#bda2c3", red: "#cf9188", yellow: "#d0ba80" }
-    }
+        syntax: {
+            blue: "#93aaca",
+            cyan: "#7eb9ae",
+            gray: "#687d76",
+            green: "#9dbf8c",
+            magenta: "#bda2c3",
+            red: "#cf9188",
+            yellow: "#d0ba80",
+        },
+    },
 };
 export function isTuiThemeName(value) {
-    return typeof value === "string" && tuiThemeNames.includes(value);
+    return (typeof value === "string" && tuiThemeNames.includes(value));
 }
 export function tuiTheme(value) {
     return tuiThemes[value ?? "forest"];

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 import type { SyntaxToken } from "./file-browser.js";
 export declare const focusOrder: readonly ["files", "editor", "chat", "terminal"];
 export type Focus = (typeof focusOrder)[number];
-export type Screen = "workspace" | "settings" | "approval" | "help" | "file-search" | "agents" | "mcp";
+export type Screen = "workspace" | "settings" | "approval" | "help" | "file-search" | "agents" | "mcp" | "skills";
 export type SettingsField = "server" | "endpoint" | "model" | "internet" | "theme";
 export type RunStatus = "ready" | "thinking" | "tool" | "waiting";
 export interface ChatMessage {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truss-harness/tui",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "Interactive terminal client for Truss.",
   "type": "module",
   "bin": {
@@ -17,7 +17,7 @@
     "logo.png"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22.15.1"
   },
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
@@ -43,9 +43,9 @@
     "ink": "^6.8.0",
     "react": "^19.2.0",
     "@truss-harness/branding": "0.1.1",
-    "@truss-harness/cli": "^0.1.22",
-    "@truss-harness/provider-openai-compatible": "^0.1.14",
-    "@truss-harness/runtime": "^0.1.11"
+    "@truss-harness/cli": "^0.1.24",
+    "@truss-harness/provider-openai-compatible": "^0.1.16",
+    "@truss-harness/runtime": "^0.1.15"
   },
   "devDependencies": {
     "@types/react": "^19.2.0"