@phren/agent 0.0.1 → 0.1.0

package/dist/repl.js

@@ -5,9 +5,9 @@ import * as path from "node:path";
 import * as os from "node:os";
 import { createSession, runTurn } from "./agent-loop.js";
 import { handleCommand } from "./commands.js";
+import { loadInputMode, saveInputMode, savePermissionMode } from "./settings.js";
 const HISTORY_DIR = path.join(os.homedir(), ".phren-agent");
 const HISTORY_FILE = path.join(HISTORY_DIR, "repl-history.txt");
-const SETTINGS_FILE = path.join(HISTORY_DIR, "settings.json");
 const MAX_HISTORY = 500;
 const CYAN = "\x1b[36m";
 const RED = "\x1b[31m";
@@ -30,41 +30,6 @@ function saveHistory(lines) {
     }
     catch { /* ignore */ }
 }
-function loadInputMode() {
-    try {
-        const data = JSON.parse(fs.readFileSync(SETTINGS_FILE, "utf-8"));
-        if (data.inputMode === "queue")
-            return "queue";
-    }
-    catch { /* ignore */ }
-    return "steering";
-}
-function saveInputMode(mode) {
-    try {
-        fs.mkdirSync(HISTORY_DIR, { recursive: true });
-        let data = {};
-        try {
-            data = JSON.parse(fs.readFileSync(SETTINGS_FILE, "utf-8"));
-        }
-        catch { /* fresh */ }
-        data.inputMode = mode;
-        fs.writeFileSync(SETTINGS_FILE, JSON.stringify(data, null, 2) + "\n");
-    }
-    catch { /* ignore */ }
-}
-function savePermissionMode(mode) {
-    try {
-        fs.mkdirSync(HISTORY_DIR, { recursive: true });
-        let data = {};
-        try {
-            data = JSON.parse(fs.readFileSync(SETTINGS_FILE, "utf-8"));
-        }
-        catch { /* fresh */ }
-        data.permissionMode = mode;
-        fs.writeFileSync(SETTINGS_FILE, JSON.stringify(data, null, 2) + "\n");
-    }
-    catch { /* ignore */ }
-}
 export async function startRepl(config) {
     const contextLimit = config.provider.contextWindow ?? 200_000;
     const session = createSession(contextLimit);

package/dist/settings.js

@@ -0,0 +1,42 @@
+/** Shared settings persistence for agent TUI and REPL. */
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+export const SETTINGS_FILE = path.join(os.homedir(), ".phren-agent", "settings.json");
+export function loadInputMode() {
+    try {
+        const data = JSON.parse(fs.readFileSync(SETTINGS_FILE, "utf-8"));
+        if (data.inputMode === "queue")
+            return "queue";
+    }
+    catch { }
+    return "steering";
+}
+export function saveInputMode(mode) {
+    try {
+        const dir = path.dirname(SETTINGS_FILE);
+        fs.mkdirSync(dir, { recursive: true });
+        let data = {};
+        try {
+            data = JSON.parse(fs.readFileSync(SETTINGS_FILE, "utf-8"));
+        }
+        catch { }
+        data.inputMode = mode;
+        fs.writeFileSync(SETTINGS_FILE, JSON.stringify(data, null, 2) + "\n");
+    }
+    catch { }
+}
+export function savePermissionMode(mode) {
+    try {
+        const dir = path.dirname(SETTINGS_FILE);
+        fs.mkdirSync(dir, { recursive: true });
+        let data = {};
+        try {
+            data = JSON.parse(fs.readFileSync(SETTINGS_FILE, "utf-8"));
+        }
+        catch { }
+        data.permissionMode = mode;
+        fs.writeFileSync(SETTINGS_FILE, JSON.stringify(data, null, 2) + "\n");
+    }
+    catch { }
+}

package/dist/system-prompt.js

@@ -15,6 +15,17 @@ export function buildSystemPrompt(phrenContext, priorSummary) {
         "- `phren_add_finding` saves insights for future sessions. Good findings: non-obvious patterns, decisions with rationale, error resolutions, architecture constraints. Bad findings: narration of what you did, obvious facts, secrets.",
         "- `phren_get_tasks` shows tracked work items. Complete tasks with `phren_complete_task` when done.",
         "",
+        "## Self-configuration",
+        "You ARE phren-agent. You can configure phren itself via shell commands:",
+        "- `phren init` — set up phren (MCP server, hooks, profiles)",
+        "- `phren add <path>` — register a project directory",
+        "- `phren config proactivity <level>` — set proactivity (high/medium/low)",
+        "- `phren config policy set <key> <value>` — configure retention, TTL, decay",
+        "- `phren hooks enable <tool>` — enable hooks for claude/copilot/cursor/codex",
+        "- `phren doctor --fix` — diagnose and self-heal",
+        "- `phren status` — check health",
+        "If the user asks you to configure phren, set up a project, or fix their install, use the shell tool to run these commands.",
+        "",
         "## Rules",
         "- Never write secrets, API keys, or PII to files or findings.",
         "- Prefer `edit_file` over `write_file` for existing files.",

package/dist/tools/edit-file.js

@@ -1,5 +1,7 @@
 import * as fs from "fs";
+import * as path from "path";
 import { encodeDiffPayload } from "../multi/diff-renderer.js";
+import { checkSensitivePath, validatePath } from "../permissions/sandbox.js";
 export const editFileTool = {
     name: "edit_file",
     description: "Edit a file by replacing an exact string match. Preferred over write_file for modifying existing files — only changes what's needed. The old_string must appear exactly once; include surrounding lines for uniqueness if needed.",
@@ -16,6 +18,17 @@ export const editFileTool = {
         const filePath = input.path;
         const oldStr = input.old_string;
         const newStr = input.new_string;
+        // Defense-in-depth: sensitive path check
+        const resolved = path.resolve(filePath);
+        const sensitive = checkSensitivePath(resolved);
+        if (sensitive.sensitive) {
+            return { output: `Access denied: ${sensitive.reason}`, is_error: true };
+        }
+        // Defense-in-depth: sandbox check
+        const sandboxResult = validatePath(filePath, process.cwd(), []);
+        if (!sandboxResult.ok) {
+            return { output: `Path outside sandbox: ${sandboxResult.error}`, is_error: true };
+        }
         if (!fs.existsSync(filePath))
             return { output: `File not found: ${filePath}`, is_error: true };
         const oldContent = fs.readFileSync(filePath, "utf-8");

package/dist/tools/git.js

@@ -1,4 +1,5 @@
 import { execFileSync } from "child_process";
+import { validatePath } from "../permissions/sandbox.js";
 function git(args, cwd) {
     return execFileSync("git", args, {
         cwd,
@@ -20,6 +21,10 @@ export const gitStatusTool = {
     },
     async execute(input) {
         const cwd = input.cwd || process.cwd();
+        const cwdCheck = validatePath(cwd, process.cwd(), []);
+        if (!cwdCheck.ok) {
+            return { output: `Git cwd outside sandbox: ${cwdCheck.error}`, is_error: true };
+        }
         try {
             const output = git(["status", "--short"], cwd);
             return { output: output || "(working tree clean)" };
@@ -43,6 +48,10 @@ export const gitDiffTool = {
     },
     async execute(input) {
         const cwd = input.cwd || process.cwd();
+        const cwdCheck = validatePath(cwd, process.cwd(), []);
+        if (!cwdCheck.ok) {
+            return { output: `Git cwd outside sandbox: ${cwdCheck.error}`, is_error: true };
+        }
         const args = ["diff"];
         if (input.cached)
             args.push("--cached");
@@ -75,6 +84,10 @@ export const gitCommitTool = {
     },
     async execute(input) {
         const cwd = input.cwd || process.cwd();
+        const cwdCheck = validatePath(cwd, process.cwd(), []);
+        if (!cwdCheck.ok) {
+            return { output: `Git cwd outside sandbox: ${cwdCheck.error}`, is_error: true };
+        }
         const message = input.message;
         const files = input.files || [];
         try {

package/dist/tools/write-file.js

@@ -1,6 +1,7 @@
 import * as fs from "fs";
 import * as path from "path";
 import { encodeDiffPayload } from "../multi/diff-renderer.js";
+import { checkSensitivePath, validatePath } from "../permissions/sandbox.js";
 export const writeFileTool = {
     name: "write_file",
     description: "Write content to a file, creating parent directories as needed. Use for new files only — prefer edit_file for modifying existing files. Overwrites existing content entirely.",
@@ -15,6 +16,17 @@ export const writeFileTool = {
     async execute(input) {
         const filePath = input.path;
         const content = input.content;
+        // Defense-in-depth: sensitive path check
+        const resolved = path.resolve(filePath);
+        const sensitive = checkSensitivePath(resolved);
+        if (sensitive.sensitive) {
+            return { output: `Access denied: ${sensitive.reason}`, is_error: true };
+        }
+        // Defense-in-depth: sandbox check
+        const sandboxResult = validatePath(filePath, process.cwd(), []);
+        if (!sandboxResult.ok) {
+            return { output: `Path outside sandbox: ${sandboxResult.error}`, is_error: true };
+        }
         const oldContent = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf-8") : "";
         fs.mkdirSync(path.dirname(filePath), { recursive: true });
         fs.writeFileSync(filePath, content);

package/dist/tui.js

@@ -8,21 +8,29 @@ import { createSession, runTurn } from "./agent-loop.js";
 import { handleCommand } from "./commands.js";
 import { renderMarkdown } from "./multi/markdown.js";
 import { decodeDiffPayload, renderInlineDiff, DIFF_MARKER } from "./multi/diff-renderer.js";
-import * as fs from "fs";
-import * as path from "path";
 import * as os from "os";
+import { execSync } from "node:child_process";
+import { loadInputMode, saveInputMode, savePermissionMode } from "./settings.js";
+import { createRequire } from "node:module";
+const _require = createRequire(import.meta.url);
+const AGENT_VERSION = _require("../package.json").version;
 // ── ANSI helpers ─────────────────────────────────────────────────────────────
 const ESC = "\x1b[";
 const s = {
     reset: `${ESC}0m`,
     bold: (t) => `${ESC}1m${t}${ESC}0m`,
     dim: (t) => `${ESC}2m${t}${ESC}0m`,
+    italic: (t) => `${ESC}3m${t}${ESC}0m`,
     cyan: (t) => `${ESC}36m${t}${ESC}0m`,
     green: (t) => `${ESC}32m${t}${ESC}0m`,
     yellow: (t) => `${ESC}33m${t}${ESC}0m`,
     red: (t) => `${ESC}31m${t}${ESC}0m`,
+    blue: (t) => `${ESC}34m${t}${ESC}0m`,
+    magenta: (t) => `${ESC}35m${t}${ESC}0m`,
     gray: (t) => `${ESC}90m${t}${ESC}0m`,
     invert: (t) => `${ESC}7m${t}${ESC}0m`,
+    // Gradient-style brand text
+    brand: (t) => `${ESC}1;35m${t}${ESC}0m`,
 };
 function cols() {
     return process.stdout.columns || 80;
@@ -38,23 +46,28 @@ const PERMISSION_LABELS = {
     "auto-confirm": "auto",
     "full-auto": "full-auto",
 };
-function formatPermissionMode(mode) {
-    const label = PERMISSION_LABELS[mode];
-    switch (mode) {
-        case "suggest": return s.cyan(`[${label}]`);
-        case "auto-confirm": return s.green(`[${label}]`);
-        case "full-auto": return s.yellow(`[${label}]`);
-    }
-}
 // ── Status bar ───────────────────────────────────────────────────────────────
 function renderStatusBar(provider, project, turns, cost, permMode, agentCount) {
-    const modeStr = permMode ? ` ${PERMISSION_LABELS[permMode]}` : "";
-    const agentTag = agentCount && agentCount > 0 ? ` ${s.dim(`A${agentCount}`)}` : "";
-    const left = ` ${s.bold("phren-agent")} ${s.dim("·")} ${provider}${project ? ` ${s.dim("·")} ${project}` : ""}`;
-    const right = `${modeStr}${agentTag} ${cost ? cost + " " : ""}${s.dim(`T${turns}`)} `;
+    const modeLabel = permMode ? PERMISSION_LABELS[permMode] : "";
+    const agentTag = agentCount && agentCount > 0 ? ` A${agentCount}` : "";
+    // Left: brand + provider + project
+    const parts = [" ◆ phren", provider];
+    if (project)
+        parts.push(project);
+    const left = parts.join(" · ");
+    // Right: mode + agents + cost + turns
+    const rightParts = [];
+    if (modeLabel)
+        rightParts.push(modeLabel);
+    if (agentTag)
+        rightParts.push(agentTag.trim());
+    if (cost)
+        rightParts.push(cost);
+    rightParts.push(`T${turns}`);
+    const right = rightParts.join("  ") + " ";
     const w = cols();
-    const pad = Math.max(0, w - stripAnsi(left).length - stripAnsi(right).length);
-    return s.invert(stripAnsi(left) + " ".repeat(pad) + stripAnsi(right));
+    const pad = Math.max(0, w - left.length - right.length);
+    return s.invert(left + " ".repeat(pad) + right);
 }
 function stripAnsi(t) {
     return t.replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "");
@@ -70,17 +83,34 @@ function formatDuration(ms) {
     const secs = Math.round((ms % 60_000) / 1000);
     return `${mins}m ${secs}s`;
 }
+function formatToolInput(name, input) {
+    // Show the most relevant input field for each tool type
+    switch (name) {
+        case "read_file": return input.file_path ?? "";
+        case "write_file": return input.file_path ?? "";
+        case "edit_file": return input.file_path ?? "";
+        case "shell": return (input.command ?? "").slice(0, 60);
+        case "glob": return input.pattern ?? "";
+        case "grep": return `/${input.pattern ?? ""}/ ${input.path ?? ""}`;
+        case "git_commit": return (input.message ?? "").slice(0, 50);
+        case "phren_search": return input.query ?? "";
+        case "phren_add_finding": return (input.finding ?? "").slice(0, 50);
+        default: return JSON.stringify(input).slice(0, 60);
+    }
+}
 function renderToolCall(name, input, output, isError, durationMs) {
-    const inputPreview = JSON.stringify(input).slice(0, 80);
+    const preview = formatToolInput(name, input);
     const dur = formatDuration(durationMs);
-    const icon = isError ? s.red("✗") : s.green("✓");
-    const header = s.dim(`  ${name}(${inputPreview})`) + `  ${icon} ${s.dim(dur)}`;
+    const icon = isError ? s.red("✗") : s.green("→");
+    const header = `  ${icon} ${s.bold(name)} ${s.gray(preview)}  ${s.dim(dur)}`;
     // Compact: show first 3 lines only, with overflow count
     const allLines = output.split("\n").filter(Boolean);
+    if (allLines.length === 0)
+        return header;
     const shown = allLines.slice(0, COMPACT_LINES);
-    const body = shown.map((l) => s.dim(`  │ ${l.slice(0, cols() - 6)}`)).join("\n");
+    const body = shown.map((l) => s.dim(`    ${l.slice(0, cols() - 6)}`)).join("\n");
     const overflow = allLines.length - COMPACT_LINES;
-    const more = overflow > 0 ? `\n${s.dim(`  │ [+${overflow} lines]`)}` : "";
+    const more = overflow > 0 ? `\n${s.dim(`    ... +${overflow} lines`)}` : "";
     return `${header}\n${body}${more}`;
 }
 // ── Menu mode helpers ────────────────────────────────────────────────────────
@@ -118,6 +148,7 @@ export async function startTui(config, spawner) {
     let menuListCount = 0;
     let menuFilterActive = false;
     let menuFilterBuf = "";
+    let ctrlCCount = 0;
     // ── Menu rendering ─────────────────────────────────────────────────────
     async function renderMenu() {
         const mod = await loadMenuModule();
@@ -144,7 +175,7 @@ export async function startTui(config, spawner) {
         menuFilterBuf = "";
         w.write("\x1b[?1049l"); // leave alternate screen (restores chat)
         statusBar();
-        prompt();
+        prompt(true); // skip newline — alt screen restore already positioned cursor
     }
     // Print status bar
     function statusBar() {
@@ -153,10 +184,31 @@ export async function startTui(config, spawner) {
         const bar = renderStatusBar(config.provider.name, config.phrenCtx?.project ?? null, session.turns, costStr, config.registry.permissionConfig.mode, spawner?.listAgents().length);
         w.write(`${ESC}s${ESC}H${bar}${ESC}u`); // save cursor, move to top, print, restore
     }
-    // Print prompt
-    function prompt() {
-        const modeTag = inputMode === "steering" ? s.dim("[steer]") : s.dim("[queue]");
-        w.write(`\n${s.cyan("phren>")} ${modeTag} `);
+    // Print prompt — bordered input bar at bottom
+    let bashMode = false;
+    function prompt(skipNewline = false) {
+        if (!isTTY)
+            return;
+        const mode = config.registry.permissionConfig.mode;
+        const modeIcon = mode === "full-auto" ? "●" : mode === "auto-confirm" ? "◐" : "○";
+        const modeColor = mode === "full-auto" ? s.yellow : mode === "auto-confirm" ? s.green : s.cyan;
+        const rows = process.stdout.rows || 24;
+        const c = cols();
+        if (!skipNewline)
+            w.write("\n");
+        // Separator line + prompt on last 2 rows
+        const permLabel = PERMISSION_LABELS[mode];
+        const separator = s.dim("─".repeat(c));
+        const rightHints = s.dim(`${bashMode ? "! bash" : permLabel} · shift+tab to cycle · esc to interrupt`);
+        const rightLen = stripAnsi(rightHints).length;
+        const sepLine = s.dim("─".repeat(Math.max(1, c - rightLen - 1))) + " " + rightHints;
+        w.write(`${ESC}${rows - 1};1H${ESC}2K${sepLine}`);
+        if (bashMode) {
+            w.write(`${ESC}${rows};1H${ESC}2K${s.yellow("!")} `);
+        }
+        else {
+            w.write(`${ESC}${rows};1H${ESC}2K${modeColor(modeIcon)} ${s.dim("▸")} `);
+        }
     }
     // Terminal cleanup: restore state on exit
     function cleanupTerminal() {
@@ -169,13 +221,50 @@ export async function startTui(config, spawner) {
         }
     }
     process.on("exit", cleanupTerminal);
-    // Setup: alternate screen not needed — just reserve top line for status
+    // Setup: clear screen, status bar at top, content area clean
     if (isTTY) {
-        w.write("\n"); // make room for status bar
-        w.write(`${ESC}1;1H`); // move to top
+        w.write(`${ESC}2J${ESC}H`); // clear entire screen + home
         statusBar();
         w.write(`${ESC}2;1H`); // move below status bar
-        w.write(s.dim("phren-agent TUI. Tab: memory browser  Shift+Tab: permissions  /help: commands  Ctrl+D: exit\n"));
+        // Startup banner
+        const project = config.phrenCtx?.project;
+        const cwd = process.cwd().replace(os.homedir(), "~");
+        const permMode = config.registry.permissionConfig.mode;
+        const modeColor = permMode === "full-auto" ? s.yellow : permMode === "auto-confirm" ? s.green : s.cyan;
+        // Try to show the phren character art alongside info
+        let artLines = [];
+        try {
+            const { PHREN_ART } = await import("@phren/cli/phren-art");
+            artLines = PHREN_ART.filter((l) => l.trim());
+        }
+        catch { /* art not available */ }
+        if (artLines.length > 0) {
+            // Art on left, info on right
+            const info = [
+                `${s.brand("◆ phren agent")}  ${s.dim("v${AGENT_VERSION}")}`,
+                `${s.dim(config.provider.name)}${project ? s.dim(` · ${project}`) : ""}`,
+                `${s.dim(cwd)}`,
+                ``,
+                `${modeColor(`${permMode === "full-auto" ? "●" : permMode === "auto-confirm" ? "◐" : "○"} ${permMode}`)} ${s.dim("permissions (shift+tab to cycle)")}`,
+                ``,
+                `${s.dim("Tab")} memory  ${s.dim("Shift+Tab")} perms  ${s.dim("/help")} cmds  ${s.dim("Ctrl+D")} exit`,
+            ];
+            const maxArtWidth = 26; // phren art is ~24 chars wide
+            for (let i = 0; i < Math.max(artLines.length, info.length); i++) {
+                const artPart = i < artLines.length ? artLines[i] : "";
+                const infoPart = i < info.length ? info[i] : "";
+                const artPadded = artPart + " ".repeat(Math.max(0, maxArtWidth - stripAnsi(artPart).length));
+                w.write(`${artPadded}${infoPart}\n`);
+            }
+        }
+        else {
+            // Fallback: text-only banner
+            w.write(`\n  ${s.brand("◆ phren agent")}  ${s.dim("v${AGENT_VERSION}")}\n`);
+            w.write(`  ${s.dim(config.provider.name)}${project ? s.dim(` · ${project}`) : ""}  ${s.dim(cwd)}\n`);
+            w.write(`  ${modeColor(`${permMode === "full-auto" ? "●" : permMode === "auto-confirm" ? "◐" : "○"} ${permMode}`)} ${s.dim("permissions (shift+tab to cycle)")}\n\n`);
+            w.write(`  ${s.dim("Tab")} memory  ${s.dim("Shift+Tab")} perms  ${s.dim("/help")} cmds  ${s.dim("Ctrl+D")} exit\n\n`);
+        }
+        w.write("\n");
     }
     // Raw stdin for steering
     if (process.stdin.isTTY) {
@@ -239,13 +328,12 @@ export async function startTui(config, spawner) {
     process.stdin.on("keypress", (_ch, key) => {
         if (!key)
             return;
-        // Ctrl+D — always exit
+        // Ctrl+D — clean exit
         if (key.ctrl && key.name === "d") {
             if (tuiMode === "menu")
-                w.write("\x1b[?1049l"); // leave alt screen
-            if (process.stdin.isTTY)
-                process.stdin.setRawMode(false);
-            w.write(s.dim("\nSession ended.\n"));
+                w.write("\x1b[?1049l");
+            cleanupTerminal();
+            w.write(`\n${s.dim(`${session.turns} turns, ${session.toolCalls} tool calls.`)}\n`);
             resolve(session);
             return;
         }
@@ -255,7 +343,9 @@ export async function startTui(config, spawner) {
             const next = nextPermissionMode(current);
             config.registry.setPermissions({ ...config.registry.permissionConfig, mode: next });
             savePermissionMode(next);
-            w.write(s.yellow(`  [mode: ${next}]\n`));
+            const modeColor = next === "full-auto" ? s.yellow : next === "auto-confirm" ? s.green : s.cyan;
+            const modeIcon = next === "full-auto" ? "●" : next === "auto-confirm" ? "◐" : "○";
+            w.write(`  ${modeColor(`${modeIcon} ${next}`)}\n`);
             statusBar();
             if (!running)
                 prompt();
@@ -277,16 +367,57 @@ export async function startTui(config, spawner) {
             return;
         }
         // ── Chat mode keys ──────────────────────────────────────────────────
-        // Ctrl+C — cancel current or clear line
+        // Escape — exit bash mode, or clear input
+        if (key.name === "escape") {
+            if (bashMode) {
+                bashMode = false;
+                inputLine = "";
+                prompt(true);
+                return;
+            }
+            if (inputLine) {
+                inputLine = "";
+                prompt(true);
+                return;
+            }
+        }
+        // Ctrl+C — progressive: cancel → warn → quit
         if (key.ctrl && key.name === "c") {
             if (running) {
+                // Cancel current agent turn
                 pendingInput = null;
                 w.write(s.yellow("\n  [interrupted]\n"));
+                ctrlCCount = 0;
+                return;
             }
-            else {
+            if (bashMode) {
+                bashMode = false;
                 inputLine = "";
-                w.write("\n");
-                prompt();
+                prompt(true);
+                ctrlCCount = 0;
+                return;
+            }
+            if (inputLine) {
+                // Clear input
+                inputLine = "";
+                prompt(true);
+                ctrlCCount = 0;
+                return;
+            }
+            // Nothing to cancel — progressive quit
+            ctrlCCount++;
+            if (ctrlCCount === 1) {
+                w.write(s.dim("\n  Press Ctrl+C again to exit.\n"));
+                prompt(true);
+                // Reset after 2 seconds
+                setTimeout(() => { ctrlCCount = 0; }, 2000);
+            }
+            else {
+                // Actually quit
+                if (process.stdin.isTTY)
+                    process.stdin.setRawMode(false);
+                w.write(s.dim("\nSession ended.\n"));
+                resolve(session);
             }
             return;
         }
@@ -299,6 +430,25 @@ export async function startTui(config, spawner) {
                 prompt();
                 return;
             }
+            // Bash mode: ! prefix runs shell directly
+            if (line.startsWith("!") || bashMode) {
+                const cmd = bashMode ? line : line.slice(1).trim();
+                bashMode = false;
+                if (cmd) {
+                    try {
+                        const output = execSync(cmd, { encoding: "utf-8", timeout: 30_000, cwd: process.cwd(), stdio: ["ignore", "pipe", "pipe"] });
+                        w.write(output);
+                        if (!output.endsWith("\n"))
+                            w.write("\n");
+                    }
+                    catch (err) {
+                        const e = err;
+                        w.write(s.red(e.stderr || e.message || "Command failed") + "\n");
+                    }
+                }
+                prompt();
+                return;
+            }
             // Slash commands
             if (line === "/mode") {
                 inputMode = inputMode === "steering" ? "queue" : "steering";
@@ -307,7 +457,14 @@ export async function startTui(config, spawner) {
                 prompt();
                 return;
             }
-            if (handleCommand(line, { session, contextLimit, undoStack: [] })) {
+            if (handleCommand(line, {
+                session,
+                contextLimit,
+                undoStack: [],
+                providerName: config.provider.name,
+                currentModel: config.provider.model,
+                spawner,
+            })) {
                 prompt();
                 return;
             }
@@ -332,6 +489,12 @@ export async function startTui(config, spawner) {
         }
         // Regular character
         if (key.sequence && !key.ctrl && !key.meta) {
+            // ! at start of empty input toggles bash mode
+            if (key.sequence === "!" && inputLine === "" && !bashMode) {
+                bashMode = true;
+                prompt(true);
+                return;
+            }
             inputLine += key.sequence;
             w.write(key.sequence);
         }
@@ -360,9 +523,11 @@ export async function startTui(config, spawner) {
             if (!text.endsWith("\n"))
                 w.write("\n");
         },
-        onToolStart: (name, _input, _count) => {
+        onToolStart: (name, input, count) => {
             flushTextBuffer();
-            w.write(s.dim(`  ⠋ ${name}...\r`));
+            const preview = formatToolInput(name, input);
+            const countLabel = count > 1 ? s.dim(` (${count} tools)`) : "";
+            w.write(`${ESC}2K  ${s.dim("◌")} ${s.gray(name)} ${s.dim(preview)}${countLabel}\r`);
         },
         onToolEnd: (name, input, output, isError, dur) => {
             w.write(`${ESC}2K\r`);
@@ -386,7 +551,7 @@ export async function startTui(config, spawner) {
     };
     async function runAgentTurn(userInput) {
         running = true;
-        w.write(s.dim("  ⠋ Thinking...\r"));
+        w.write(`${ESC}2K  ${s.dim("◌ thinking...")}\r`);
         try {
             await runTurn(userInput, session, config, tuiHooks);
             statusBar();
@@ -410,42 +575,3 @@ export async function startTui(config, spawner) {
     prompt();
     return done;
 }
-// ── Settings persistence ─────────────────────────────────────────────────────
-const SETTINGS_FILE = path.join(os.homedir(), ".phren-agent", "settings.json");
-function loadInputMode() {
-    try {
-        const data = JSON.parse(fs.readFileSync(SETTINGS_FILE, "utf-8"));
-        if (data.inputMode === "queue")
-            return "queue";
-    }
-    catch { }
-    return "steering";
-}
-function saveInputMode(mode) {
-    try {
-        const dir = path.dirname(SETTINGS_FILE);
-        fs.mkdirSync(dir, { recursive: true });
-        let data = {};
-        try {
-            data = JSON.parse(fs.readFileSync(SETTINGS_FILE, "utf-8"));
-        }
-        catch { }
-        data.inputMode = mode;
-        fs.writeFileSync(SETTINGS_FILE, JSON.stringify(data, null, 2) + "\n");
-    }
-    catch { }
-}
-function savePermissionMode(mode) {
-    try {
-        const dir = path.dirname(SETTINGS_FILE);
-        fs.mkdirSync(dir, { recursive: true });
-        let data = {};
-        try {
-            data = JSON.parse(fs.readFileSync(SETTINGS_FILE, "utf-8"));
-        }
-        catch { }
-        data.permissionMode = mode;
-        fs.writeFileSync(SETTINGS_FILE, JSON.stringify(data, null, 2) + "\n");
-    }
-    catch { }
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phren/agent",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Coding agent with persistent memory — powered by phren",
   "type": "module",
   "bin": {
@@ -12,12 +12,8 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "echo 'Run tests from repo root: pnpm -w test'"
-  },
   "dependencies": {
-    "@phren/cli": "workspace:*"
+    "@phren/cli": "0.1.0"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -35,5 +31,9 @@
     "type": "git",
     "url": "git+https://github.com/alaarab/phren.git",
     "directory": "packages/agent"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "echo 'Run tests from repo root: pnpm -w test'"
   }
-}
+}