refactor(tui): Port from Ink to OpenTUI for terminal rendering

OpenTUI comes with a lot more features out-the-box than Ink, most
notably around mouse input and fullscreen display. By simply porting,
the TUI has gained mouse-wheel scrolling for the transcript, auto-
updating themes when light/dark modes are toggled in the environment,
and built-in handling of rendering the app fullscreen.

Author: tomcant

.gitignore

@@ -1,5 +1,5 @@
 # compiled binary
-/agent
+/toolsmith
 
 # dependencies (bun install)
 node_modules

README.md

@@ -1,15 +1,14 @@
-<p align="center">
-  <img src="logo.svg" alt="Agent Toolsmith" width="100%">
-</p>
+<div align="center">
+  <img width="50%" alt="Agent Toolsmith logo" src="./logo.svg" />
+  <h4>A general-purpose AI agent that writes its own tools</h4>
+</div>
 
-# Agent Toolsmith
+---
 
-A general-purpose AI agent that writes its own tools.
-
-It starts with two built-in tools — `evolve` to write a tool and `inspect` to read one back — and writes the rest as it needs them. When it hits a task it can't do yet, it writes a new tool, saves it to disk and uses it right away. New tools persist across sessions, so the agent's capabilities grow the more you use it.
+Starting with just two built-ins — `evolve` for writing and `inspect` for reading — when Toolsmith hits a task it can't do yet, it writes a new tool and uses it right away. New tools persist across sessions, so the agent's capabilities grow the more you use it.
 
 > [!CAUTION]
-> This is a personal experiment for didactic purposes only. It's rough around the edges and not battle-tested in any way. Tool code runs in-process with your privileges — there is no sandbox (for now). The system prompt instructs the model not to write tools that delete data, leak secrets, or make irreversible changes unless asked, but of course this cannot be trusted.
+> This is a personal experiment for didactic purposes only. It's rough around the edges and not battle-tested in any way. **Tool code runs in-process with your privileges** — there is no sandbox for now. The system prompt instructs the model not to write tools that delete data, leak secrets, or make irreversible changes unless asked, but of course this cannot be trusted.
 
 ## How It Works
 

build.ts

@@ -1,29 +1,4 @@
-// `bun build --compile` directly doesn't work because Ink's reconciler
-// dynamically imports `./devtools.js` (gated on `process.env.DEV === 'true'`),
-// and that file has a static `import devtools from 'react-devtools-core'`. Bun's
-// bundler eagerly follows dynamic imports into the bundle graph, so the
-// unresolved `react-devtools-core` fails the build even though the branch is
-// dead in prod. `--external` would fix it for normal bundling but not for
-// `--compile` (compiled binaries have no node_modules at runtime).
-//
-// Fix: stub `react-devtools-core` to an empty module so the eager resolve
-// succeeds. The stub is never reached at runtime as long as `DEV` is unset.
 await Bun.build({
   entrypoints: ["./src/index.ts"],
-  compile: { outfile: "agent" },
-  plugins: [
-    {
-      name: "stub-react-devtools-core",
-      setup(builder) {
-        builder.onResolve({ filter: /^react-devtools-core$/ }, () => ({
-          path: "react-devtools-core",
-          namespace: "stub",
-        }));
-        builder.onLoad({ filter: /.*/, namespace: "stub" }, () => ({
-          contents: "export default {}",
-          loader: "js",
-        }));
-      },
-    },
-  ],
+  compile: { outfile: "toolsmith" },
 });

bun.lock

@@ -14,18 +14,15 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.96.0",
-    "@byteland/ink-scroll-bar": "^1.0.0",
-    "@inkjs/ui": "^2.0.0",
-    "ink": "^7.1.1",
-    "ink-scroll-view": "0.3.7",
-    "marked": "^18.0.6",
-    "marked-terminal": "^7.3.0",
-    "react": "^19.2.7"
+    "@opentui/core": "0.5.3",
+    "@opentui/react": "0.5.3",
+    "opentui-spinner": "^0.0.7",
+    "react": "^19.2.7",
+    "web-tree-sitter": "0.25.10"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.4",
     "@types/bun": "^1.3.14",
-    "@types/marked-terminal": "^6.1.1",
     "@types/react": "^19.2.17"
   },
   "peerDependencies": {

logo.svg

@@ -1,56 +1,26 @@
-import { render } from "ink";
+import { createCliRenderer } from "@opentui/core";
+import { createRoot } from "@opentui/react";
 import { createElement } from "react";
 import { resolveLlmClient } from "./adapters/llm";
 import { createAgent } from "./agent";
 import { createDemoAgent } from "./demo";
 import systemPrompt from "./prompt.md";
 import { App } from "./tui/App.tsx";
-import { initColorScheme } from "./tui/color-scheme.ts";
-
-await initColorScheme();
 
 const agent =
   process.env.DEMO === "1"
     ? await createDemoAgent()
     : await createAgent(resolveLlmClient(systemPrompt));
 
-const { waitUntilExit } = renderFullscreen(createElement(App, { agent, attachApiKey }));
-await waitUntilExit();
+const renderer = await createCliRenderer();
+
+const themeMode = (await renderer.waitForThemeMode(200)) ?? "dark";
+
+createRoot(renderer).render(createElement(App, { agent, attachApiKey, themeMode }));
 
 function attachApiKey(apiKey: string) {
   const client = resolveLlmClient(systemPrompt, { ...process.env, ANTHROPIC_API_KEY: apiKey });
   if (!client) return null;
   agent.setClient(client);
   return agent.modelInfo();
 }
-
-/*
- * Render in the alternate screen with the first frame at the top.
- *
- * Ink's `alternateScreen` switches buffers (`\x1b[?1049h`) but doesn't clear or
- * home the cursor before the first paint, so the frame starts wherever the cursor
- * was previously. Ink writes that escape just before painting, so we intercept it
- * and splice in a clear+home.
- */
-function renderFullscreen(node: ReturnType<typeof createElement>) {
-  const options = { exitOnCtrlC: true, alternateScreen: true };
-  if (!process.stdout.isTTY) return render(node, options);
-
-  const stdout = process.stdout;
-  const originalWrite = stdout.write.bind(stdout);
-  const write = originalWrite as (...args: unknown[]) => boolean;
-
-  stdout.write = (chunk: string | Uint8Array, ...args: unknown[]) => {
-    const result = write(chunk, ...args);
-    if (typeof chunk === "string" && chunk.includes("\x1b[?1049h")) {
-      originalWrite("\x1b[2J\x1b[H"); // clear + home, before Ink's first paint
-    }
-    return result;
-  };
-
-  try {
-    return render(node, options);
-  } finally {
-    stdout.write = originalWrite;
-  }
-}