@autoclawd/autocode 0.4.0

package/Dockerfile

@@ -0,0 +1,57 @@
+# autocode base image — all common runtimes for Claude Code
+# Use this as docker.image in your config for zero-setup multi-language support
+#
+# Build:  docker build -t autocode-base .
+# Config: docker: { image: autocode-base }
+#
+# Includes: Node.js 20, Python 3, Go, Rust, Ruby, Git, common build tools
+# Size: ~1.5 GB (trades disk for zero-config developer experience)
+
+FROM node:20-bookworm
+
+# Avoid interactive prompts during package installation
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Common build tools + git (already in node:20 but be explicit)
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    git \
+    curl \
+    wget \
+    ca-certificates \
+    openssh-client \
+    jq \
+    unzip \
+    # Python
+    python3 \
+    python3-pip \
+    python3-venv \
+    python3-dev \
+    # Ruby
+    ruby \
+    ruby-dev \
+    # Go (via official tarball for latest stable)
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Go (bookworm packages are often outdated)
+ARG GO_VERSION=1.22.2
+RUN curl -fsSL "https://go.dev/dl/go${GO_VERSION}.linux-$(dpkg --print-architecture).tar.gz" \
+    | tar -xz -C /usr/local
+ENV PATH="/usr/local/go/bin:${PATH}"
+
+# Rust is omitted by default (~1.5GB). For Rust repos, use docker.setup:
+#   docker:
+#     setup:
+#       - curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
+
+# Pre-install Claude Code globally
+RUN npm install -g @anthropic-ai/claude-code@latest
+
+# Verify installations
+RUN node --version && python3 --version && go version && ruby --version && git --version
+
+# Workspace directory
+WORKDIR /workspace
+
+LABEL org.opencontainers.image.title="autocode-base"
+LABEL org.opencontainers.image.description="Multi-runtime base image for autocode (Linear → Claude Code → PRs)"

package/README.md

@@ -0,0 +1,169 @@
+# autocode
+
+Linear tickets in, pull requests out. autocode watches your Linear board, spins up Docker containers, runs [Claude Code](https://docs.anthropic.com/en/docs/claude-code), and opens PRs.
+
+## How it works
+
+```
+Linear webhook → autocode → Docker container → Claude Code → git push → PR
+```
+
+1. A ticket moves to "Todo" in Linear
+2. autocode claims it, clones the repo, creates a branch
+3. Claude Code works on it inside a Docker container (multiple iterations)
+4. autocode pushes the changes and opens a PR
+5. Linear ticket moves to "Done" with a link to the PR
+
+## Quick start
+
+```bash
+# Install
+npm install -g autocode
+
+# Prerequisites: Docker running, Claude Code logged in
+# (run `claude` once to create ~/.claude/.credentials.json)
+
+# Interactive setup — validates everything
+autocode init
+
+# Start the webhook server (auto-creates tunnel + Linear webhook)
+autocode serve
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `autocode init` | Interactive setup with preflight checks |
+| `autocode serve` | Start webhook server with auto-tunnel |
+| `autocode run T-123` | Run a single ticket |
+| `autocode run T-123 --dry-run` | Preview without executing |
+| `autocode validate` | Check config syntax |
+| `autocode cleanup` | Remove orphaned Docker containers |
+
+## Configuration
+
+### Host config (`~/.autocode/config.yaml`)
+
+Created by `autocode init`. Contains tokens and global defaults.
+
+```yaml
+linear:
+  apiKey: "lin_api_..."     # or env:LINEAR_API_KEY
+  teamId: TEAM
+  statuses: [Todo]          # which statuses trigger execution
+  assignToMe: false         # only process tickets assigned to you
+  inProgressStatus: In Progress
+  doneStatus: Done
+
+github:
+  token: "ghp_..."          # or env:GITHUB_TOKEN
+
+webhook:
+  port: 3000
+
+docker:
+  image: node:20            # or autocode-base for multi-language
+  memory: 4g
+  # setup:                  # optional commands to run before Claude
+  #   - pip install -r requirements.txt
+
+agent:
+  model: claude-sonnet-4-6
+  maxIterations: 10
+  # timeout: 1800           # per-iteration timeout in seconds
+
+maxConcurrent: 1
+```
+
+### Per-repo config (`.autocode.yaml` or `.autocode.yml`)
+
+Optional. Place in the repo root to customize behavior for that repo.
+
+```yaml
+prompt: "You are working on a Django REST API. Follow PEP 8."
+base: develop              # default branch (instead of main)
+
+agent:
+  model: claude-opus-4-6
+  maxIterations: 20
+
+docker:
+  image: python:3.12
+  setup:
+    - pip install -e ".[dev]"
+```
+
+## Repo routing
+
+Tickets need a `repo:owner/name` label in Linear to tell autocode which repository to work on.
+
+Examples:
+- `repo:acme/backend`
+- `repo:acme/frontend`
+- `repo:https://github.com/acme/monorepo`
+
+## Stacked diffs
+
+When autocode completes a ticket, it automatically adds a `base:autocode/T-123-...` label to the ticket. To stack Ticket B on Ticket A's unmerged PR:
+
+1. Ticket A is processed normally (branches from main)
+2. Copy the `base:autocode/A-123-...` label from Ticket A to Ticket B
+3. Ticket B will branch from A's PR branch instead of main
+
+## Docker images
+
+| Image | Languages | Size | Use when |
+|-------|-----------|------|----------|
+| `node:20` (default) | Node.js | ~300MB | Node/TS repos |
+| `autocode-base` | Node, Python, Go, Rust, Ruby | ~1.5GB | Multi-language repos |
+| Custom | Whatever you need | Varies | Special requirements |
+
+Build the multi-runtime image:
+```bash
+docker build -t autocode-base .
+```
+
+For repos with uncommon dependencies, use `docker.setup` in `.autocode.yaml`:
+```yaml
+docker:
+  setup:
+    - apt-get update && apt-get install -y libpq-dev
+    - pip install -r requirements.txt
+```
+
+autocode also auto-detects common stacks (Python, Go, Ruby) from repo files and installs missing runtimes.
+
+## Environment variables
+
+Any config value can reference environment variables with the `env:` prefix:
+
+```yaml
+linear:
+  apiKey: env:LINEAR_API_KEY
+github:
+  token: env:GITHUB_TOKEN
+```
+
+## Monitoring
+
+The webhook server exposes health endpoints:
+
+```bash
+curl http://localhost:3000/health
+# {"status":"ok","active":1,"queued":0,"capacity":2}
+```
+
+Logs are written to `~/.autocode/logs/autocode-YYYY-MM-DD.log`.
+
+## Security
+
+- Config file is written with `0600` permissions (owner-only read/write)
+- Git credentials use `GIT_ASKPASS` / credential helpers (never in URLs or process list)
+- Webhook signature verification (HMAC-SHA256) when signing secret is configured
+- Request body size limit (1 MB)
+- Token redaction in error messages
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }