@phamvuhoang/otto 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# @phamvuhoang/otto
+
+CLI for **[Otto](https://github.com/phamvuhoang/otto)** — a harness that drives the
+[Claude Code](https://docs.anthropic.com/claude/docs/claude-code) CLI against a target
+repository in an iterating implementer → reviewer loop, running `claude` directly on the host.
+Docker is not required.
+
+Exposes two bin entries (thin wrappers over
+**[`@phamvuhoang/otto-core`](https://www.npmjs.com/package/@phamvuhoang/otto-core)**):
+
+- **`otto-afk`** — plan/PRD-driven loop. Iterates until the agent emits `<promise>NO MORE TASKS</promise>`.
+- **`otto-ghafk`** — GitHub-issue-driven loop. Pulls open issues and lets the agent pick the next task.
+
+> **Security:** Otto runs Claude with `--permission-mode bypassPermissions`. The default
+> `OTTO_RUNNER=sandbox` uses Claude Code's native OS sandbox (Seatbelt on macOS) to confine
+> writes to the workspace. Point it only at repositories and prompts you trust. See
+> [SECURITY.md](https://github.com/phamvuhoang/otto/blob/main/SECURITY.md).
+
+## Install
+
+```bash
+npm i -g @phamvuhoang/otto
+```
+
+## Use
+
+```bash
+cd /path/to/your/workspace
+otto-afk "<plan-and-prd>" 5      # plan/PRD loop
+otto-ghafk 5                     # GitHub-issue loop
+otto-afk --help                  # flags, env vars
+otto-afk --print-config          # diagnose workspace / runner / sandbox config
+```
+
+Requires an authenticated Claude Code login (and `gh` for `otto-ghafk`). First-run
+setup, per-OS notes, and the full flag/env reference are in the
+**[main README](https://github.com/phamvuhoang/otto#readme)** and
+**[QUICKSTART](https://github.com/phamvuhoang/otto/blob/main/QUICKSTART.md)**.
+
+## License
+
+[MIT](https://github.com/phamvuhoang/otto/blob/main/LICENSE) © Henry Pham.

package/bin/otto-afk.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { runAfk } from "@phamvuhoang/otto-core";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const pkgPath = join(here, "..", "package.json");
+const cliVersion = JSON.parse(readFileSync(pkgPath, "utf8")).version;
+
+runAfk(process.argv.slice(2), { cliVersion }).catch((e) => {
+  console.error(e?.stack ?? e);
+  process.exit(1);
+});

package/bin/otto-ghafk.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { runGhAfk } from "@phamvuhoang/otto-core";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const pkgPath = join(here, "..", "package.json");
+const cliVersion = JSON.parse(readFileSync(pkgPath, "utf8")).version;
+
+runGhAfk(process.argv.slice(2), { cliVersion }).catch((e) => {
+  console.error(e?.stack ?? e);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@phamvuhoang/otto",
+  "version": "0.1.0",
+  "description": "CLI for the otto AFK loop (otto-afk, otto-ghafk).",
+  "type": "module",
+  "license": "MIT",
+  "author": "Henry Pham <phamvuhoang@gmail.com>",
+  "homepage": "https://github.com/phamvuhoang/otto/tree/main/apps/cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phamvuhoang/otto.git",
+    "directory": "apps/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/phamvuhoang/otto/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "claude",
+    "ai-agent",
+    "afk",
+    "automation",
+    "cli"
+  ],
+  "bin": {
+    "otto-afk": "./bin/otto-afk.js",
+    "otto-ghafk": "./bin/otto-ghafk.js"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "README.md"
+  ],
+  "dependencies": {
+    "@phamvuhoang/otto-core": "^0.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/afk.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+set -eo pipefail
+
+# Workspace = caller's cwd. Dockerfile resolution = bundled (packages/core).
+# Arg validation handled by otto-afk JS (supports --help, --print-config).
+if command -v otto-afk >/dev/null 2>&1; then
+  exec otto-afk "$@"
+fi
+if [ -x "./node_modules/.bin/otto-afk" ]; then
+  exec ./node_modules/.bin/otto-afk "$@"
+fi
+exec npx -y @phamvuhoang/otto otto-afk "$@"

package/scripts/ghafk.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+set -eo pipefail
+
+# Workspace = caller's cwd. Dockerfile resolution = bundled (packages/core).
+# Arg validation handled by otto-ghafk JS (supports --help, --print-config).
+if command -v otto-ghafk >/dev/null 2>&1; then
+  exec otto-ghafk "$@"
+fi
+if [ -x "./node_modules/.bin/otto-ghafk" ]; then
+  exec ./node_modules/.bin/otto-ghafk "$@"
+fi
+exec npx -y @phamvuhoang/otto otto-ghafk "$@"