@action-llama/action-llama 0.1.4 → 0.1.5

package/README.md

@@ -56,7 +56,7 @@ Once setup finishes:
 
 ```bash
 cd my-project
-al start
+npx al start    # if using local install
 ```
 
 The dev agent will poll every 5 minutes looking for issues that match its filter: the issue must have the trigger label (default: `agent`) **and** be assigned to the configured user. When it finds a match, it clones the repo, creates a branch, implements the changes described in the issue, runs tests, and opens a PR.
@@ -80,6 +80,8 @@ Credentials are stored separately in `~/.action-llama-credentials/` (shared acro
 
 ## CLI commands
 
+If you installed globally (`npm install -g @action-llama/action-llama`), you can use `al` directly. Otherwise, prefix commands with `npx` (e.g., `npx al start`).
+
 | Command | Description |
 |---------|-------------|
 | `al new <name>` | Create a new project (interactive setup for credentials, model, and agents) |
@@ -164,6 +166,30 @@ To use webhooks instead of polling, enable them during `al new` and add a webhoo
 
 Payloads are validated with HMAC-SHA256 (`x-hub-signature-256`). Webhook filters in `webhooks.filters` support matching on `source`, `repos`, `events`, `actions`, `labels`, `assignee`, `author`, and `branches` (AND logic; omitted fields are not checked).
 
+#### Local development with ngrok
+
+If you're developing locally and need GitHub to reach your machine, use [ngrok](https://ngrok.com) to create a public tunnel:
+
+```bash
+# Install ngrok (macOS)
+brew install ngrok
+
+# Start a tunnel pointing at the Action Llama gateway port
+ngrok http 8080
+```
+
+ngrok will print a forwarding URL like `https://a1b2c3d4.ngrok-free.app`. Use that as your GitHub webhook Payload URL:
+
+```
+https://a1b2c3d4.ngrok-free.app/webhooks/github
+```
+
+Keep the ngrok process running alongside `al start`. The tunnel stays active until you stop it. For a stable URL across restarts, sign up for a free ngrok account and use a static domain:
+
+```bash
+ngrok http 8080 --url=your-name.ngrok-free.app
+```
+
 ### Docker mode
 
 Set `"docker": { "enabled": true }` in `config.json`. Agents run in isolated containers with credentials mounted read-only at `/credentials/`, a read-only root FS, dropped capabilities, non-root user, and PID/memory/CPU limits. Each container gets a unique shutdown secret for the anti-exfiltration kill switch. The Docker image is built automatically on first run from `docker/Dockerfile`.

package/dist/cli/commands/new.js

@@ -71,7 +71,7 @@ Setup complete!
 
 Next steps:
   cd ${name}
-  al start
+  npx al start
 `);
 }
 //# sourceMappingURL=new.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@action-llama/action-llama",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Automated development agents triggered by cron or webhooks. BYOM — bring your own model.",
   "type": "module",
   "license": "MIT",