start here

getting the box running on your laptop


this gets the box into your app on your own machine, where it edits your code and hot reload shows you the result. you need a react app in a git repo, and one of claude code, opencode or codex installed and signed in. computah doesn't come with its own agent, it uses whichever one you already have

install it

shell
pnpm add @tetraslam13/computah

put the box in your app

it can go anywhere. in a next app i put it in the root layout so it's on every page:

app/layout.tsx
import { Computah } from "@tetraslam13/computah";

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="en">
      <body>
        {children}
        <Computah />
      </body>
    </html>
  );
}

it draws itself inside a shadow root so your styles and its styles never touch each other, and it doesn't depend on anything except react

run the runner

the box is only the window. the thing that actually hands your words to the agent is called the runner, and the way to start it is to run your dev server through it:

package.json
{ "scripts": { "dev": "computah -- next dev" } }

whatever you put after the -- runs alongside it, and stopping one stops the other. it uses the first agent it finds installed (it looks for claude, then opencode, then codex), and if you want a specific one you can say so with computah --agent codex -- next dev

use it

open your app and press Ctrl+. (⌘. on a mac), or click the tiny window button in the bottom right. type what should be different and press return (shift+return if you want a new line)

while it works you get one line telling you what the agent is doing right now, like "reading page.tsx" or "editing counter.tsx", and the page changes under you as it saves files. there's a steps link if you want to see everything it did and a stop link if you change your mind. when it's finished it tells you what it changed in a sentence or two, and there's an undo right there

other stuff it does

knows where you werethe page you were on, any text you had selected, your window size, and anything you pointed at with the "point at it" button all get sent to the agent
queuesyou can send a bunch of requests in a row and they run one at a time, in order
commitseach change is its own commit named computah: plus the start of what you typed. if a change touches a file where you had uncommitted edits it stays uncommitted, so your work and the agent's don't get mixed together. --no-commit turns this off
cleans upif a request fails or you stop it, none of its edits are kept
undoes carefullyundo won't overwrite anything edited since. if later work touched the same lines it tells you and leaves everything alone

this is what it would send from this card if you asked for something right now:

yours to change

this part is yours to mess with. open the box with Ctrl+. (or ⌘. on a mac) and say how it should be different, and only you will see your version

it keeps its records in a .computah folder in your repo and hides that folder from git status without touching your .gitignore

if it says the runner isn't running

that means nothing is answering on 127.0.0.1:4821, which is where the runner listens. start your dev server through computah like above and the box will notice on its own, it keeps checking