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
pnpm add @tetraslam13/computahput 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:
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:
{ "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 were | the 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 |
| queues | you can send a bunch of requests in a row and they run one at a time, in order |
| commits | each 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 up | if a request fails or you stop it, none of its edits are kept |
| undoes carefully | undo 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:
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