Skip to content

Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.

terminal

Theo Browne58261b9ba01e
diff --git a/apps/desktop/src/main.ts b/apps/desktop/src/main.ts
index 448ea4733..881ab29a7 100644
--- a/apps/desktop/src/main.ts
+++ b/apps/desktop/src/main.ts
@@ -2,13 +2,17 @@ import { fixPath } from "./fixPath";
fixPath();
import path from "node:path";
+import { spawn } from "node:child_process";
import { BrowserWindow, app, ipcMain, session } from "electron";
import {
IPC_CHANNELS,
+ type TerminalCommandInput,
+ type TerminalCommandResult,
agentConfigSchema,
agentSessionIdSchema,
newTodoInputSchema,
+ terminalCommandInputSchema,
todoIdSchema,
} from "@acme/contracts";
import { ProcessManager } from "./processManager";
@@ -70,6 +74,11 @@ function registerIpcHandlers(): void {
return todoStore.remove(todoIdSchema.parse(id));
});
+ // Terminal handlers
+ ipcMain.handle(IPC_CHANNELS.terminalRun, async (_event, payload: unknown) => {
+ return runTerminalCommand(terminalCommandInputSchema.parse(payload));
+ });
+
// Agent handlers
ipcMain.handle(IPC_CHANNELS.agentSpawn, async (_event, config: unknown) => {
return processManager.spawn(agentConfigSchema.parse(config));
@@ -87,6 +96,66 @@ function registerIpcHandlers(): void {
);
}
+async function runTerminalCommand(
+ input: TerminalCommandInput,
+): Promise<TerminalCommandResult> {
+ const shellPath =
+ process.platform === "win32"
+ ? process.env.ComSpec ?? "cmd.exe"
+ : process.env.SHELL ?? "/bin/sh";
+
+ const args =
+ process.platform === "win32"
+ ? ["/d", "/s", "/c", input.command]
+ : ["-lc", input.command];
+
+ return new Promise((resolve, reject) => {
+ const child = spawn(shellPath, args, {
+ cwd: input.cwd,
+ env: process.env,
+ stdio: ["ignore", "pipe", "pipe"],
+ });
+
+ let stdout = "";
+ let stderr = "";
+ let timedOut = false;
+
+ const timeout = setTimeout(() => {
+ timedOut = true;
+ child.kill("SIGTERM");
+ setTimeout(() => {
+ if (!child.killed) {
+ child.kill("SIGKILL");
+ }
+ }, 1_000).unref();
+ }, input.timeoutMs ?? 30_000);
+
+ child.stdout?.on("data", (chunk: Buffer) => {
+ stdout += chunk.toString();
+ });
+
+ child.stderr?.on("data", (chunk: Buffer) => {
+ stderr += chunk.toString();
+ });
+
+ child.on("error", (error) => {
+ clearTimeout(timeout);
+ reject(error);
+ });
+
+ child.on("close", (code, signal) => {
+ clearTimeout(timeout);
+ resolve({
+ stdout,
+ stderr,
+ code: code ?? null,
+ signal: signal ?? null,
+ timedOut,
+ });
+ });
+ });
+}
+
function setupEventForwarding(window: BrowserWindow): void {
const onOutput = (chunk: unknown) => {
if (!window.isDestroyed()) {
diff --git a/apps/desktop/src/preload.ts b/apps/desktop/src/preload.ts
index 0eb6bd74f..b9207d85c 100644
--- a/apps/desktop/src/preload.ts
+++ b/apps/desktop/src/preload.ts
@@ -9,6 +9,9 @@ const nativeApi: NativeApi = {
toggle: (id) => ipcRenderer.invoke(IPC_CHANNELS.todosToggle, id),
remove: (id) => ipcRenderer.invoke(IPC_CHANNELS.todosRemove, id),
},
+ terminal: {
+ run: (input) => ipcRenderer.invoke(IPC_CHANNELS.terminalRun, input),
+ },
agent: {
spawn: (config) => ipcRenderer.invoke(IPC_CHANNELS.agentSpawn, config),
kill: (sessionId) => ipcRenderer.invoke(IPC_CHANNELS.agentKill, sessionId),
diff --git a/apps/renderer/src/App.tsx b/apps/renderer/src/App.tsx
index 2f5b038b3..1774e2962 100644
--- a/apps/renderer/src/App.tsx
+++ b/apps/renderer/src/App.tsx
@@ -1,19 +1,19 @@
-import {
- type FormEvent,
- useCallback,
- useEffect,
- useMemo,
- useState,
-} from "react";
+import { type FormEvent, useMemo, useState } from "react";
-import type { Todo } from "@acme/contracts";
+import type { TerminalCommandResult } from "@acme/contracts";
-function formatCreatedAt(isoDate: string): string {
+interface TerminalEntry {
+ id: string;
+ command: string;
+ result: TerminalCommandResult;
+ createdAt: string;
+}
+
+function formatTimestamp(isoDate: string): string {
return new Intl.DateTimeFormat(undefined, {
- month: "short",
- day: "numeric",
hour: "numeric",
minute: "2-digit",
+ second: "2-digit",
}).format(new Date(isoDate));
}
@@ -27,102 +27,52 @@ function readNativeApi() {
export default function App() {
const api = useMemo(() => readNativeApi(), []);
- const [todos, setTodos] = useState<Todo[]>([]);
- const [title, setTitle] = useState("");
- const [isLoading, setIsLoading] = useState(true);
+ const [command, setCommand] = useState("");
+ const [history, setHistory] = useState<TerminalEntry[]>([]);
+ const [isRunning, setIsRunning] = useState(false);
const [error, setError] = useState<string | null>(null);
- const loadTodos = useCallback(async () => {
- if (!api) {
- return;
- }
-
- setError(null);
-
- try {
- const nextTodos = await api.todos.list();
- setTodos(nextTodos);
- } catch (loadError) {
- const message =
- loadError instanceof Error
- ? loadError.message
- : "Could not fetch todos.";
- setError(message);
- } finally {
- setIsLoading(false);
- }
- }, [api]);
-
- useEffect(() => {
- void loadTodos();
- }, [loadTodos]);
-
const onSubmit = async (event: FormEvent<HTMLFormElement>) => {
event.preventDefault();
- if (!api) {
+ if (!api || isRunning) {
return;
}
- const trimmed = title.trim();
+ const trimmed = command.trim();
if (!trimmed) {
return;
}
setError(null);
+ setIsRunning(true);
try {
- const nextTodos = await api.todos.add({ title: trimmed });
- setTodos(nextTodos);
- setTitle("");
- } catch (addError) {
- const message =
- addError instanceof Error ? addError.message : "Could not add todo.";
- setError(message);
- }
- };
-
- const onToggle = async (id: string) => {
- if (!api) {
- return;
- }
-
- setError(null);
-
- try {
- const nextTodos = await api.todos.toggle(id);
- setTodos(nextTodos);
- } catch (toggleError) {
+ const result = await api.terminal.run({ command: trimmed });
+ setHistory((previous) => [
+ ...previous,
+ {
+ id: crypto.randomUUID(),
+ command: trimmed,
+ result,
+ createdAt: new Date().toISOString(),
+ },
+ ]);
+ setCommand("");
+ } catch (runError) {
const message =
- toggleError instanceof Error
- ? toggleError.message
- : "Could not toggle todo.";
- setError(message);
- }
- };
-
- const onRemove = async (id: string) => {
- if (!api) {
- return;
- }
-
- setError(null);
-
- try {
- const nextTodos = await api.todos.remove(id);
- setTodos(nextTodos);
- } catch (removeError) {
- const message =
- removeError instanceof Error
- ? removeError.message
- : "Could not remove todo.";
+ runError instanceof Error
+ ? runError.message
+ : "Could not execute command.";
setError(message);
+ } finally {
+ setIsRunning(false);
}
};
if (!api) {
return (
- <main className="mx-auto flex min-h-screen w-full max-w-3xl items-center justify-center px-8">
+ <main className="mx-auto flex min-h-screen w-full max-w-4xl items-center justify-center px-8">
<section className="rounded-3xl border border-amber-200 bg-amber-50 px-6 py-5 text-amber-900 shadow-soft">
<h1 className="text-lg font-semibold">Native bridge unavailable</h1>
<p className="mt-2 text-sm">
@@ -134,100 +84,102 @@ export default function App() {
}
return (
- <main className="mx-auto flex min-h-screen w-full max-w-3xl flex-col px-6 py-12 text-slate-900 sm:px-10">
- <header className="rounded-3xl border border-slate-200/80 bg-white/80 p-7 shadow-soft backdrop-blur">
- <h1 className="text-3xl font-semibold tracking-tight">
- Long-Horizon TODOs
+ <main className="mx-auto flex min-h-screen w-full max-w-5xl flex-col px-6 py-10 text-slate-900 sm:px-10">
+ <header className="rounded-3xl border border-slate-800/80 bg-slate-900 p-7 text-slate-100 shadow-soft">
+ <p className="text-xs uppercase tracking-[0.18em] text-emerald-300">
+ Demo Terminal
+ </p>
+ <h1 className="mt-2 font-mono text-3xl font-semibold tracking-tight">
+ Shell Command Runner
</h1>
- <p className="mt-2 text-sm text-slate-600">
- Renderer is isolated. All native access is routed through a typed
- preload API.
+ <p className="mt-3 text-sm text-slate-300">
+ Runs one command at a time in your shell and prints stdout/stderr.
</p>
<form className="mt-6 flex gap-3" onSubmit={onSubmit}>
<input
- value={title}
- onChange={(event) => setTitle(event.target.value)}
- placeholder="Write a task..."
- className="h-11 flex-1 rounded-xl border border-slate-300 bg-white px-4 text-sm outline-none ring-0 transition focus:border-slate-500"
- maxLength={280}
+ value={command}
+ onChange={(event) => setCommand(event.target.value)}
+ placeholder="e.g. ls -la"
+ className="h-11 flex-1 rounded-xl border border-emerald-500/50 bg-slate-950 px-4 font-mono text-sm text-emerald-100 outline-none ring-0 transition focus:border-emerald-300"
+ maxLength={4000}
/>
<button
type="submit"
- className="h-11 rounded-xl bg-slate-900 px-5 text-sm font-medium text-white transition hover:bg-slate-700"
+ className="h-11 rounded-xl bg-emerald-500 px-5 text-sm font-semibold text-slate-950 transition hover:bg-emerald-400 disabled:cursor-not-allowed disabled:bg-emerald-800 disabled:text-emerald-300"
+ disabled={isRunning}
+ >
+ {isRunning ? "Running..." : "Run"}
+ </button>
+ <button
+ type="button"
+ className="h-11 rounded-xl border border-slate-600 px-5 text-sm font-medium text-slate-200 transition hover:border-slate-400 hover:text-white disabled:cursor-not-allowed disabled:opacity-50"
+ disabled={history.length === 0 || isRunning}
+ onClick={() => setHistory([])}
>
- Add
+ Clear
</button>
</form>
</header>
- <section className="mt-6 rounded-3xl border border-slate-200/70 bg-white/80 p-4 shadow-soft backdrop-blur sm:p-6">
- {isLoading ? (
- <p className="text-sm text-slate-500">Loading todos...</p>
- ) : null}
+ {error ? (
+ <div className="mt-6 rounded-xl border border-rose-200 bg-rose-50 px-4 py-3 text-sm text-rose-700">
+ {error}
+ </div>
+ ) : null}
- {error ? (
- <div className="mb-4 rounded-xl border border-rose-200 bg-rose-50 px-4 py-3 text-sm text-rose-700">
- {error}
+ <section className="mt-6 flex-1 space-y-4">
+ {history.length === 0 ? (
+ <div className="rounded-2xl border border-dashed border-slate-300 bg-slate-50 px-4 py-6 text-sm text-slate-500">
+ No commands run yet.
</div>
) : null}
- {!isLoading && todos.length === 0 ? (
- <p className="rounded-xl border border-dashed border-slate-300 bg-slate-50 px-4 py-5 text-sm text-slate-500">
- No todos yet. Add one above.
- </p>
- ) : null}
-
- <ul className="space-y-3">
- {todos.map((todo) => (
- <li
- key={todo.id}
- className="flex items-center justify-between rounded-2xl border border-slate-200 bg-white px-4 py-3"
- >
- <button
- type="button"
- onClick={() => {
- void onToggle(todo.id);
- }}
- className="flex flex-1 items-center gap-3 text-left"
- >
- <span
- className={[
- "mt-0.5 inline-block h-5 w-5 rounded-full border transition",
- todo.completed
- ? "border-emerald-600 bg-emerald-500"
- : "border-slate-300 bg-white",
- ].join(" ")}
- />
- <span>
- <p
- className={[
- "text-sm font-medium",
- todo.completed
- ? "text-slate-400 line-through"
- : "text-slate-800",
- ].join(" ")}
- >
- {todo.title}
+ {history.map((entry) => (
+ <article
+ key={entry.id}
+ className="overflow-hidden rounded-2xl border border-slate-700 bg-slate-950 shadow-soft"
+ >
+ <header className="flex items-center justify-between border-b border-slate-800 px-4 py-3 font-mono text-xs text-slate-300">
+ <p>$ {entry.command}</p>
+ <p>{formatTimestamp(entry.createdAt)}</p>
+ </header>
+
+ <div className="space-y-3 px-4 py-4 font-mono text-sm">
+ {entry.result.stdout ? (
+ <div>
+ <p className="mb-1 text-xs uppercase tracking-wide text-emerald-300">
+ stdout
</p>
- <p className="text-xs text-slate-500">
- Created {formatCreatedAt(todo.createdAt)}
+ <pre className="whitespace-pre-wrap break-words text-emerald-100">
+ {entry.result.stdout}
+ </pre>
+ </div>
+ ) : null}
+
+ {entry.result.stderr ? (
+ <div>
+ <p className="mb-1 text-xs uppercase tracking-wide text-rose-300">
+ stderr
</p>
- </span>
- </button>
-
- <button
- type="button"
- onClick={() => {
- void onRemove(todo.id);
- }}
- className="rounded-lg border border-rose-200 px-3 py-1.5 text-xs font-medium text-rose-600 transition hover:bg-rose-50"
- >
- Remove
- </button>
- </li>
- ))}
- </ul>
+ <pre className="whitespace-pre-wrap break-words text-rose-200">
+ {entry.result.stderr}
+ </pre>
+ </div>
+ ) : null}
+
+ {!entry.result.stdout && !entry.result.stderr ? (
+ <p className="text-slate-400">(no output)</p>
+ ) : null}
+ </div>
+
+ <footer className="border-t border-slate-800 bg-slate-900/60 px-4 py-2 font-mono text-xs text-slate-400">
+ exit={entry.result.code ?? "null"} signal=
+ {entry.result.signal ?? "null"} timedOut=
+ {entry.result.timedOut ? "yes" : "no"}
+ </footer>
+ </article>
+ ))}
</section>
</main>
);
diff --git a/apps/renderer/src/index.css b/apps/renderer/src/index.css
index 0c8daf02c..258af8d75 100644
--- a/apps/renderer/src/index.css
+++ b/apps/renderer/src/index.css
@@ -9,9 +9,10 @@
}
body {
- font-family: "Avenir Next", "Avenir", "Segoe UI", sans-serif;
+ font-family: "Iowan Old Style", "Georgia", serif;
min-height: 100vh;
- background: radial-gradient(circle at top left, #dbeafe 0%, transparent 40%),
- radial-gradient(circle at 90% 20%, #e9d5ff 0%, transparent 35%),
- linear-gradient(120deg, #f8fafc 0%, #eef2ff 50%, #f8fafc 100%);
+ background:
+ radial-gradient(circle at top left, #d1fae5 0%, transparent 38%),
+ radial-gradient(circle at 88% 20%, #fef3c7 0%, transparent 28%),
+ linear-gradient(130deg, #f8fafc 0%, #eef6f2 50%, #f8fafc 100%);
}
diff --git a/packages/contracts/src/index.ts b/packages/contracts/src/index.ts
index 1685d691b..11ba98210 100644
--- a/packages/contracts/src/index.ts
+++ b/packages/contracts/src/index.ts
@@ -1,3 +1,4 @@
export * from "./todo";
export * from "./ipc";
export * from "./agent";
+export * from "./terminal";
diff --git a/packages/contracts/src/ipc.ts b/packages/contracts/src/ipc.ts
index fa6cd3290..b6f28a0cc 100644
--- a/packages/contracts/src/ipc.ts
+++ b/packages/contracts/src/ipc.ts
@@ -1,4 +1,5 @@
import type { AgentConfig, AgentExit, OutputChunk } from "./agent";
+import type { TerminalCommandInput, TerminalCommandResult } from "./terminal";
import type { NewTodoInput, Todo } from "./todo";
export const IPC_CHANNELS = {
@@ -6,6 +7,7 @@ export const IPC_CHANNELS = {
todosAdd: "todos:add",
todosToggle: "todos:toggle",
todosRemove: "todos:remove",
+ terminalRun: "terminal:run",
agentSpawn: "agent:spawn",
agentKill: "agent:kill",
agentWrite: "agent:write",
@@ -20,6 +22,9 @@ export interface NativeApi {
toggle: (id: string) => Promise<Todo[]>;
remove: (id: string) => Promise<Todo[]>;
};
+ terminal: {
+ run: (input: TerminalCommandInput) => Promise<TerminalCommandResult>;
+ };
agent: {
spawn: (config: AgentConfig) => Promise<string>;
kill: (sessionId: string) => Promise<void>;
diff --git a/packages/contracts/src/terminal.test.ts b/packages/contracts/src/terminal.test.ts
new file mode 100644
index 000000000..7e5b9aab8
--- /dev/null
+++ b/packages/contracts/src/terminal.test.ts
@@ -0,0 +1,24 @@
+import { describe, expect, it } from "vitest";
+
+import { terminalCommandInputSchema } from "./terminal";
+
+describe("terminalCommandInputSchema", () => {
+ it("accepts a valid command", () => {
+ const result = terminalCommandInputSchema.safeParse({
+ command: "echo hello",
+ });
+ expect(result.success).toBe(true);
+ });
+
+ it("trims whitespace", () => {
+ const result = terminalCommandInputSchema.parse({
+ command: " echo hello ",
+ });
+ expect(result.command).toBe("echo hello");
+ });
+
+ it("rejects an empty command", () => {
+ const result = terminalCommandInputSchema.safeParse({ command: " " });
+ expect(result.success).toBe(false);
+ });
+});
diff --git a/packages/contracts/src/terminal.ts b/packages/contracts/src/terminal.ts
new file mode 100644
index 000000000..33126ec96
--- /dev/null
+++ b/packages/contracts/src/terminal.ts
@@ -0,0 +1,18 @@
+import { z } from "zod";
+
+export const terminalCommandInputSchema = z.object({
+ command: z.string().trim().min(1).max(4000),
+ cwd: z.string().min(1).optional(),
+ timeoutMs: z.number().int().positive().max(120_000).optional(),
+});
+
+export const terminalCommandResultSchema = z.object({
+ stdout: z.string(),
+ stderr: z.string(),
+ code: z.number().nullable(),
+ signal: z.string().nullable(),
+ timedOut: z.boolean(),
+});
+
+export type TerminalCommandInput = z.infer<typeof terminalCommandInputSchema>;
+export type TerminalCommandResult = z.infer<typeof terminalCommandResultSchema>;