@anturno/cli 0.1.0

package/README.md

@@ -0,0 +1,39 @@
+# anturno
+
+A coding agent, in the terminal or one shot.
+
+## Install
+
+Needs [Bun](https://bun.sh) 1.3 or newer — the agent's tools are written
+against `Bun.*`, so it is the runtime, not just the installer.
+
+```sh
+bun install -g @anturno/cli
+```
+
+## Use
+
+```sh
+anturno                     # open the terminal app in this directory
+anturno "fix the flaky test"  # answer one prompt and exit
+anturno login               # sign in to a model provider
+anturno help                # everything else
+```
+
+`anturno bridge` lends this machine to a hosted anturno: the laptop dials the
+server and answers file and shell operations locally, so a hosted session can
+work in a folder that never leaves it.
+
+## Sessions
+
+Every run is a session with a transcript on disk. `--resume <id>` continues
+one, `--fork <id>` continues a copy of one under a new id, and in the terminal
+app `/resume` and `/fork` do the same. With `ANTURNO_CHECKPOINTS=1` on a local
+git checkout, the working tree is snapshotted before every turn: `/undo` in the
+app, or `anturno --resume <id> --undo`, puts it back. `/verify` asks a fresh
+verifier subagent whether the work is actually done before you believe it.
+
+## Developing
+
+From a checkout of the monorepo, `bun run cli` runs this package from source
+and `bun run build --filter=@anturno/cli` produces the bundle that ships.