From fec0601722a6957c0490d96178cfe6c0aded2fb4 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 5 Jul 2026 22:15:47 +0000 Subject: [PATCH] Add a Terminal page to the dashboard Adds a real shell terminal to the dashboard sidebar: POST /api/terminal/run executes a command via subprocess in a server-tracked working directory (with cd support), and GET /api/terminal/session returns the current cwd. The frontend renders a scrollback panel with command history (up/down arrows) styled to match the existing chat UI. Local-only power feature: it executes arbitrary shell commands, same trust model as the existing agent CLIs the dashboard already shells out to. --- dashboard/api.js | 3 + dashboard/index.html | 1 + dashboard/pages/terminal.js | 114 ++++++++++++++++++++++++++++++++++++ dashboard/styles.css | 32 ++++++++++ dashboard/utils.js | 1 + server.py | 37 ++++++++++++ 6 files changed, 188 insertions(+) create mode 100644 dashboard/pages/terminal.js diff --git a/dashboard/api.js b/dashboard/api.js index bdb2284..886e71f 100644 --- a/dashboard/api.js +++ b/dashboard/api.js @@ -52,6 +52,9 @@ const api = { discoverStandards: () => api.post('/api/standards/discover'), chat: (agent, message, controller) => api.post('/api/chat', { agent, message }, controller), getChatHistory: () => api.get('/api/chat/history'), + // Terminal + getTerminalSession: () => api.get('/api/terminal/session'), + runTerminalCommand: (command) => api.post('/api/terminal/run', { command }), // Kanban getKanbanBoard: (status) => api.get(status ? `/api/kanban/board?status=${encodeURIComponent(status)}` : '/api/kanban/board'), getKanbanTask: (id) => api.get(`/api/kanban/tasks/${encodeURIComponent(id)}`), diff --git a/dashboard/index.html b/dashboard/index.html index 4f7899e..6a600ba 100644 --- a/dashboard/index.html +++ b/dashboard/index.html @@ -33,6 +33,7 @@
Primary
💬AI Chat + ⌨Terminal ◉Dashboard
Agents
⚡Skills0 diff --git a/dashboard/pages/terminal.js b/dashboard/pages/terminal.js new file mode 100644 index 0000000..c05afc1 --- /dev/null +++ b/dashboard/pages/terminal.js @@ -0,0 +1,114 @@ +async function renderTerminal() { + const content = document.getElementById('pageContent'); + content.innerHTML = ` +
+
+

Terminal

+

Run shell commands directly on this machine

+
+
+ +
+
+
+
+
+ $ + +
+
+ `; + + window._terminalHistory = window._terminalHistory || []; + window._terminalHistoryIndex = window._terminalHistory.length; + window._terminalBusy = false; + + try { + const session = await api.getTerminalSession(); + updateTerminalPrompt(session.cwd); + } catch { + appendTerminalLine('Could not reach the terminal backend.', 'stderr'); + } + + document.getElementById('terminalInput').focus(); +} + +function focusTerminalInput() { + const input = document.getElementById('terminalInput'); + if (input) input.focus(); +} + +function updateTerminalPrompt(cwd) { + const prompt = document.getElementById('terminalPrompt'); + if (prompt) prompt.textContent = `${cwd} $`; +} + +function appendTerminalLine(text, kind = '') { + const output = document.getElementById('terminalOutput'); + if (!output || !text) return; + const line = document.createElement('div'); + if (kind) line.className = `terminal-line-${kind}`; + line.textContent = text; + output.appendChild(line); + output.scrollTop = output.scrollHeight; +} + +function clearTerminal() { + const output = document.getElementById('terminalOutput'); + if (output) output.innerHTML = ''; +} + +async function handleTerminalKey(e) { + const input = e.target; + + if (e.key === 'ArrowUp') { + e.preventDefault(); + if (window._terminalHistoryIndex > 0) { + window._terminalHistoryIndex--; + input.value = window._terminalHistory[window._terminalHistoryIndex] || ''; + } + return; + } + if (e.key === 'ArrowDown') { + e.preventDefault(); + if (window._terminalHistoryIndex < window._terminalHistory.length - 1) { + window._terminalHistoryIndex++; + input.value = window._terminalHistory[window._terminalHistoryIndex] || ''; + } else { + window._terminalHistoryIndex = window._terminalHistory.length; + input.value = ''; + } + return; + } + if (e.key !== 'Enter' || window._terminalBusy) return; + + const command = input.value.trim(); + input.value = ''; + if (!command) return; + + window._terminalHistory.push(command); + window._terminalHistoryIndex = window._terminalHistory.length; + + appendTerminalLine(command, 'cmd'); + + if (command === 'clear' || command === 'cls') { + clearTerminal(); + return; + } + + window._terminalBusy = true; + input.disabled = true; + try { + const r = await api.runTerminalCommand(command); + if (r.stdout) appendTerminalLine(r.stdout.replace(/\n$/, '')); + if (r.stderr) appendTerminalLine(r.stderr.replace(/\n$/, ''), 'stderr'); + if (r.timed_out) appendTerminalLine('Command timed out after 60s.', 'info'); + updateTerminalPrompt(r.cwd); + } catch (err) { + appendTerminalLine(`Error: ${err.message}`, 'stderr'); + } finally { + window._terminalBusy = false; + input.disabled = false; + input.focus(); + } +} diff --git a/dashboard/styles.css b/dashboard/styles.css index 54c27f9..57921ed 100644 --- a/dashboard/styles.css +++ b/dashboard/styles.css @@ -821,6 +821,38 @@ pre { .chat-message { max-width: 95%; } } +/* Terminal */ +.terminal-panel { + flex: 1; display: flex; flex-direction: column; + min-height: 0; + background: #0a0e14; + border: 1px solid var(--border); + border-radius: var(--radius-lg); + overflow: hidden; + box-shadow: var(--shadow); + font-family: var(--font-mono); +} +.terminal-output { + flex: 1; overflow-y: auto; padding: 16px; + font-size: 13px; line-height: 1.6; + color: #c9d1d9; white-space: pre-wrap; word-break: break-word; +} +.terminal-line-cmd { color: #7ee787; } +.terminal-line-cmd::before { content: '$ '; color: #58a6ff; } +.terminal-line-stderr { color: #ff7b72; } +.terminal-line-info { color: var(--text-muted); font-style: italic; } +.terminal-input-row { + display: flex; align-items: center; gap: 8px; + padding: 10px 16px; + background: #0d1117; + border-top: 1px solid var(--border); +} +.terminal-prompt { color: #58a6ff; font-size: 13px; white-space: nowrap; } +.terminal-input { + flex: 1; background: transparent; border: none; outline: none; + color: #c9d1d9; font-family: var(--font-mono); font-size: 13px; +} + /* ─── v0.2.0 UI Modernization ─── */ /* Glass card variant */ diff --git a/dashboard/utils.js b/dashboard/utils.js index 393f11e..2dd85c1 100644 --- a/dashboard/utils.js +++ b/dashboard/utils.js @@ -123,6 +123,7 @@ const PAGE_TITLES = { settings: { title: 'Settings', breadcrumb: 'Configuration' }, 'setup-wizard': { title: 'Setup Wizard', breadcrumb: 'Guided configuration' }, chat: { title: 'AI Chat', breadcrumb: 'Multi-agent terminal' }, + terminal: { title: 'Terminal', breadcrumb: 'Local shell access' }, kanban: { title: 'Kanban Board', breadcrumb: 'Multi-agent task management' }, goals: { title: 'Goals', breadcrumb: 'Project targets and progress' }, journal: { title: 'Journal', breadcrumb: 'Daily entries and notes' }, diff --git a/server.py b/server.py index 9c538c8..00f393f 100644 --- a/server.py +++ b/server.py @@ -99,6 +99,9 @@ class ChatRequest(BaseModel): agent: str message: str +class TerminalRunRequest(BaseModel): + command: str + # ─── Helper Functions ───────────────────────────────────────────── def read_file(path: Path): @@ -662,6 +665,40 @@ def chat(req: ChatRequest): def get_chat_history(): return load_chat_history() +# ─── Routes: Terminal ───────────────────────────────────────────── + +_terminal_cwd = str(BASE_DIR) + +@app.get("/api/terminal/session") +def get_terminal_session(): + return {"cwd": _terminal_cwd} + +@app.post("/api/terminal/run") +def run_terminal_command(req: TerminalRunRequest): + global _terminal_cwd + command = req.command.strip() + if not command: + return {"cwd": _terminal_cwd, "stdout": "", "stderr": "", "returncode": 0, "timed_out": False} + + if command == "cd" or command.startswith("cd "): + target = command[2:].strip() or str(Path.home()) + new_dir = (Path(_terminal_cwd) / target).resolve() if not Path(target).is_absolute() else Path(target).resolve() + if not new_dir.is_dir(): + return {"cwd": _terminal_cwd, "stdout": "", "stderr": f"cd: no such directory: {target}", "returncode": 1, "timed_out": False} + _terminal_cwd = str(new_dir) + append_audit({"action": "terminal_command", "command": "cd", "cwd": _terminal_cwd}) + return {"cwd": _terminal_cwd, "stdout": "", "stderr": "", "returncode": 0, "timed_out": False} + + try: + r = subprocess.run( + command, shell=True, cwd=_terminal_cwd, + capture_output=True, text=True, timeout=60, + ) + append_audit({"action": "terminal_command", "command": command[:200], "cwd": _terminal_cwd}) + return {"cwd": _terminal_cwd, "stdout": r.stdout, "stderr": r.stderr, "returncode": r.returncode, "timed_out": False} + except subprocess.TimeoutExpired: + return {"cwd": _terminal_cwd, "stdout": "", "stderr": "Command timed out after 60s.", "returncode": -1, "timed_out": True} + # ═══════════════════════════════════════════════════════════════════ # v0.2.0 — New Feature Endpoints # ═══════════════════════════════════════════════════════════════════