liutaio 0.1.4 → 0.1.6

package/README.md

@@ -24,12 +24,12 @@ You need three things:
 
 1. **Docker** installed and running
 2. **SSH keys** in `~/.ssh/` that can push to your repo
-3. An **agents.md** file in your repo describing the work to do (see [Writing Your agents.md](#writing-your-agentsmd))
+3. An **agent.md** file in your repo describing the work to do (see [Writing Your agent.md](#writing-your-agentmd))
 
 Then just run:
 
 ```bash
-liutaio agents.md 10 my-feature-branch
+liutaio agent.md 10 my-feature-branch
 ```
 
 That's it. Liutaio figures out authentication, builds the container, clones your repo, installs dependencies, and starts working.
@@ -52,7 +52,7 @@ If you've ever used Claude Code on your machine, you're already set. If not, Liu
 If you don't want to touch your host credentials, or you're on a machine where Claude Code isn't installed, use `--oauth`:
 
 ```bash
-liutaio agents.md 10 my-branch --oauth
+liutaio agent.md 10 my-branch --oauth
 ```
 
 Liutaio will show you a URL to open in your browser. After authorising, you'll see a code on the page — paste it back into the terminal. Your credentials are then cached in a Docker volume, so you only need to do this once.
@@ -60,7 +60,7 @@ Liutaio will show you a URL to open in your browser. After authorising, you'll s
 To re-authenticate later (e.g. switching accounts):
 
 ```bash
-liutaio agents.md 10 my-branch --fresh-login
+liutaio agent.md 10 my-branch --fresh-login
 ```
 
 ### Cached OAuth credentials
@@ -95,9 +95,9 @@ Each iteration works on exactly one ticket. After completing it (code committed,
 
 If the container crashes or you stop it (`docker stop`), it pushes whatever work is on the base branch before shutting down — you never lose progress.
 
-## Writing Your agents.md
+## Writing Your agent.md
 
-The `agents.md` file tells Claude Code what to do. Put it anywhere in your repo (you pass the path as the first argument). Here's a minimal example:
+The `agent.md` file tells Claude Code what to do. Put it anywhere in your repo (you pass the path as the first argument). Here's a minimal example:
 
 ```markdown
 # My Feature
@@ -131,7 +131,7 @@ Maintain a `progress.md` file tracking what's been done.
 When all tickets are complete, output: <promise>COMPLETE</promise>
 ```
 
-See `agents-template.md` for a more complete template.
+See `agent-template.md` for a more complete template.
 
 ### Key conventions
 
@@ -175,20 +175,20 @@ npm install --prefix packages/client
 Pass private tokens with `--env`:
 
 ```bash
-liutaio agents.md 10 my-branch --env MY_NPM_TOKEN=ghp_xxxx
+liutaio agent.md 10 my-branch --env MY_NPM_TOKEN=ghp_xxxx
 ```
 
 ## CLI Reference
 
 ```
-liutaio <agents-file> <iterations> <base-branch> [options]
+liutaio <agent-file> <iterations> <base-branch> [options]
 ```
 
 ### Arguments
 
 | Argument | Description |
 |----------|-------------|
-| `agents-file` | Path to your agents.md relative to repo root |
+| `agent-file` | Path to your agent.md relative to repo root |
 | `iterations` | Maximum number of loop iterations (one ticket per iteration) |
 | `base-branch` | Name of the branch to create from main |
 
@@ -227,7 +227,7 @@ docker logs -f liutaio-my-branch
 docker exec -it liutaio-my-branch bash
 
 # Check progress on your host (updated after each ticket)
-cat path/to/agents-dir/progress.md
+cat path/to/agent-dir/progress.md
 
 # Stop gracefully (pushes work before exiting)
 docker stop liutaio-my-branch
@@ -265,14 +265,14 @@ Check that you're copying the entire code from the callback page (including any
 Liutaio uses Claude Code's public OAuth client ID to authenticate. If Anthropic rotates this ID in a future update, OAuth login will fail. You can override it by passing the new client ID:
 
 ```bash
-liutaio agents.md 10 my-branch --env LIUTAIO_OAUTH_CLIENT_ID=new-client-id-here
+liutaio agent.md 10 my-branch --env LIUTAIO_OAUTH_CLIENT_ID=new-client-id-here
 ```
 
 You can find the current client ID by running `claude auth login` on your host and inspecting the authorization URL it generates.
 
 ### Loop doesn't stop after all work is done
 
-The loop looks for `<promise>COMPLETE</promise>` in the session output. Make sure your agents.md instructs Claude to output this exact string when finished.
+The loop looks for `<promise>COMPLETE</promise>` in the session output. Make sure your agent.md instructs Claude to output this exact string when finished.
 
 ## License
 

package/bin/liutaio

@@ -17,5 +17,11 @@ if [[ "${1:-}" == "--version" || "${1:-}" == "-v" ]]; then
   exit 0
 fi
 
+# Handle --agent-template
+if [[ "${1:-}" == "--agent-template" ]]; then
+  cat "$LIUTAIO_HOME/agent-template.md"
+  exit 0
+fi
+
 # Delegate to run.sh with all arguments
 exec "$LIUTAIO_HOME/docker/run.sh" "$@"

package/docker/entrypoint.sh

@@ -7,9 +7,9 @@ BASE_BRANCH="${3:-}"
 LOGDIR="${4:-/tmp/liutaio}"
 
 if [ -z "$AGENTS_FILE" ] || [ -z "$ITERATIONS" ] || [ -z "$BASE_BRANCH" ]; then
-  echo "Usage: liutaio <agents-file> <iterations> <base-branch> [log-dir]"
+  echo "Usage: liutaio <agent-file> <iterations> <base-branch> [log-dir]"
   echo ""
-  echo "  agents-file  Path to agents.md relative to repo root"
+  echo "  agent-file   Path to agent.md relative to repo root"
   echo "  iterations   Number of ralph loop iterations"
   echo "  base-branch  Name of the base branch to create from main"
   echo "  log-dir      Log directory (default: /tmp/liutaio)"
@@ -174,7 +174,7 @@ echo ""
 echo "============================================"
 echo "  Liutaio"
 echo "============================================"
-echo "  Agents file : $AGENTS_FILE"
+echo "  Agent file  : $AGENTS_FILE"
 echo "  Iterations  : $ITERATIONS"
 echo "  Base branch : $BASE_BRANCH"
 echo "  Log dir     : $LOGDIR"
@@ -193,9 +193,9 @@ if [ -n "$REAL_REMOTE" ]; then
   echo "  Remote set to: $REAL_REMOTE"
 fi
 
-# Copy agents file (and its directory) from host if not on main
+# Copy agent file (and its directory) from host if not on main
 if [ ! -f "/workspace/$AGENTS_FILE" ] && [ -f "/repo/$AGENTS_FILE" ]; then
-  echo "  Agents file not on main — copying from host repo..."
+  echo "  Agent file not on main — copying from host repo..."
   mkdir -p "/workspace/$AGENTS_DIR"
   cp -r "/repo/$AGENTS_DIR/." "/workspace/$AGENTS_DIR/"
   echo "  Copied: $AGENTS_DIR/"

package/docker/run.sh

@@ -4,7 +4,7 @@ set -euo pipefail
 # ─── Liutaio — run Claude Code loops with auto-detecting auth ───
 #
 # Usage:
-#   liutaio <agents-file> <iterations> <base-branch> [options]
+#   liutaio <agent-file> <iterations> <base-branch> [options]
 #
 # Authentication (checked in this order):
 #   1. Cached OAuth credentials (Docker volume from a previous --oauth run)
@@ -69,10 +69,10 @@ if [ -z "$AGENTS_FILE" ] || [ -z "$ITERATIONS" ] || [ -z "$BASE_BRANCH" ]; then
   echo "Liutaio — run Claude Code loops with auto-detecting auth"
   echo ""
   echo "Usage:"
-  echo "  liutaio <agents-file> <iterations> <base-branch> [options]"
+  echo "  liutaio <agent-file> <iterations> <base-branch> [options]"
   echo ""
   echo "Arguments:"
-  echo "  agents-file   Path to agents.md relative to repo root"
+  echo "  agent-file    Path to agent.md relative to repo root"
   echo "  iterations    Number of loop iterations"
   echo "  base-branch   Name of the base branch to create from main"
   echo ""
@@ -86,6 +86,8 @@ if [ -z "$AGENTS_FILE" ] || [ -z "$ITERATIONS" ] || [ -z "$BASE_BRANCH" ]; then
   echo "  --node-version V  Node.js version (default: 22, or LIUTAIO_NODE_VERSION)"
   echo "  --repo PATH       Path to git repo (default: auto-detect from cwd)"
   echo "  --env KEY=VALUE   Pass env var into the container (repeatable)"
+  echo "  --agent-template  Print the agent.md template to stdout"
+  echo "  --version, -v     Show version number"
   echo ""
   echo "Authentication (checked in this order):"
   echo "  1. Cached OAuth credentials (Docker volume from a previous --oauth run)"
@@ -94,9 +96,9 @@ if [ -z "$AGENTS_FILE" ] || [ -z "$ITERATIONS" ] || [ -z "$BASE_BRANCH" ]; then
   echo "  4. Interactive OAuth login (prompts in the terminal)"
   echo ""
   echo "Examples:"
-  echo "  liutaio agents.md 10 my-branch              # auto-detect auth"
-  echo "  liutaio agents.md 10 my-branch --oauth       # force OAuth login"
-  echo "  liutaio agents.md 10 my-branch --fresh-login # re-authenticate"
+  echo "  liutaio agent.md 10 my-branch              # auto-detect auth"
+  echo "  liutaio agent.md 10 my-branch --oauth       # force OAuth login"
+  echo "  liutaio agent.md 10 my-branch --fresh-login # re-authenticate"
   exit 1
 fi
 
@@ -111,9 +113,9 @@ fi
 
 CONTAINER_NAME="${CONTAINER_NAME:-liutaio-${BASE_BRANCH}}"
 
-# ─── Validate agents file exists ─────────────────────────────────────
+# ─── Validate agent file exists ──────────────────────────────────────
 if [ ! -f "$REPO_ROOT/$AGENTS_FILE" ]; then
-  echo "Error: agents file not found: $REPO_ROOT/$AGENTS_FILE"
+  echo "Error: agent file not found: $REPO_ROOT/$AGENTS_FILE"
   exit 1
 fi
 
@@ -340,7 +342,7 @@ echo "============================================"
 echo "  Liutaio"
 echo "============================================"
 echo "  Container  : $CONTAINER_NAME"
-echo "  Agents     : $AGENTS_FILE"
+echo "  Agent      : $AGENTS_FILE"
 echo "  Iterations : $ITERATIONS"
 echo "  Base branch: $BASE_BRANCH"
 echo "  Node       : $NODE_VERSION"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "liutaio",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Run AI coding agents in Docker containers — autonomously, safely, and with zero setup.",
   "license": "MIT",
   "bin": {
@@ -9,7 +9,7 @@
   "files": [
     "bin/",
     "docker/",
-    "agents-template.md",
+    "agent-template.md",
     "LICENSE",
     "README.md"
   ],
@@ -24,7 +24,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/narleybrittes/liutaio.git"
+    "url": "git+https://github.com/narley/liutaio.git"
   },
   "engines": {
     "node": ">=18"