# computah

make this app better

okay so this is a little window you put in your app. you type what you want to be different, and an agent goes and edits the app's code while you sit there and watch it happen

![asking the box for a stopwatch and watching the counter turn into one](/demo.gif)

## how to get it

install it:

```sh
pnpm add @tetraslam13/computah
```

then put the box anywhere in a react app, as long as the app lives in a git repo:

```tsx
import { Computah } from "@tetraslam13/computah";

<Computah />;
```

and run your dev server through computah instead of on its own:

```sh
computah -- next dev
```

open your app, press `Ctrl+.` (`⌘.` on a mac) and type whatever you want changed. it uses the coding agent you're already signed into (claude code, opencode or codex) so there's no account to make and no api key to paste anywhere. the longer version of all this is on [start here](/start-here)

## you can mess with this site btw

these docs are a computah app too :D the framed thing below is yours, so open the box and tell it what to turn into

_(on the web page there's a little interactive piece here, `apps/docs/playground/home.tsx`, that visitors can change by typing into the box)_

nobody else sees your version, so do whatever. if you make something i like i can make it the real one for everyone. i edit the rest of the site the same way, by typing at it, and everything that's been changed like that is listed on [changes](/changes) with the exact words that were typed

## where this came from

patrick collison [posted](https://x.com/patrickc/status/2116636967517798672) that he's been putting "a freeform text input that's hooked up to an agent that yolo implements whatever is submitted" into all his personal apps, and i wanted that in all of mine without rebuilding it every time. so now it's a library

## the cards

there are arrows at the bottom of every card, or you can use the arrow keys, or type a card's number to jump straight to it. `/` searches

2. [start here](/start-here.md): getting the box running on your laptop
3. [styling it](/styling.md): making the box look like your app
4. [ways to use it](/ways-to-use-it.md): the different setups, from laptop to public site
5. [serve it](/serve-it.md): letting the runner serve the app itself
6. [people and trust](/people-and-trust.md): who sees the box and whose app a change goes into
7. [letting anyone change it](/guests.md): letting strangers change chosen pieces of a public app
8. [how a change travels](/how-a-change-travels.md): what happens between typing and everyone seeing it
9. [on exe.dev](/on-exe-dev.md): running it on exe.dev, whose login already knows you
10. [on vercel](/on-vercel.md): push mode, for hosts that can't run the runner
11. [adapters](/adapters.md): swapping the agent, identity, host or sandbox
12. [sandboxes](/sandboxes.md): running the agent on a throwaway machine
13. [safety](/safety.md): who can make the runner change your code
14. [reference](/reference.md): every prop, flag and config field
15. [changes](/changes.md): every change typed into this site that stuck
