@lovenyberg/ove 0.1.0

package/.dockerignore

@@ -0,0 +1,7 @@
+node_modules/
+repos/
+.env
+ove.db
+.git/
+docs/
+*.md

package/.env.example

@@ -0,0 +1,30 @@
+# Slack (Socket Mode)
+SLACK_BOT_TOKEN=xoxb-...
+SLACK_APP_TOKEN=xapp-...
+
+# WhatsApp
+WHATSAPP_ENABLED=false
+
+# Telegram
+# TELEGRAM_BOT_TOKEN=123456:ABC-DEF...
+
+# Discord
+# DISCORD_BOT_TOKEN=MTIz...
+
+# HTTP API + Web UI
+# HTTP_API_PORT=3000
+# HTTP_API_KEY=your-secret-key
+
+# GitHub (polling for @mentions in issue/PR comments)
+# GITHUB_POLL_REPOS=owner/repo1,owner/repo2
+# GITHUB_BOT_NAME=ove
+# GITHUB_POLL_INTERVAL=30000
+
+# CLI mode (auto-enabled when no other adapters configured)
+# CLI_MODE=true
+
+# Repos directory
+REPOS_DIR=./repos
+
+# Config file path (optional, defaults to ./config.json)
+# CONFIG_PATH=./config.json

package/.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install
+      - run: bun test

package/.github/workflows/pages.yml

@@ -0,0 +1,33 @@
+name: Deploy Pages
+
+on:
+  push:
+    branches: [main]
+    paths: [docs/**]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/configure-pages@v5
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs
+
+      - id: deployment
+        uses: actions/deploy-pages@v4

package/.github/workflows/publish.yml

@@ -0,0 +1,45 @@
+name: Publish Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install
+      - run: bun test
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - uses: oven-sh/setup-bun@v2
+
+      - run: bun install
+
+      # Update version from release tag (safe: GITHUB_REF_NAME is not user-controlled)
+      - name: Set version from tag
+        env:
+          REF_NAME: ${{ github.ref_name }}
+        run: |
+          VERSION="${REF_NAME#v}"
+          npm version "$VERSION" --no-git-tag-version --allow-same-version
+
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CLAUDE.md

@@ -0,0 +1,28 @@
+# Ove
+
+Your grumpy but meticulous dev companion — routes chat messages to Claude Code CLI in isolated worktrees.
+
+## Stack
+- Bun + TypeScript
+- @slack/bolt (Socket Mode) for Slack
+- baileys for WhatsApp
+- grammy for Telegram
+- discord.js for Discord
+- Bun.serve for HTTP API + Web UI
+- gh CLI for GitHub polling
+- bun:sqlite for task queue
+- claude -p CLI for code tasks
+
+## Structure
+- src/adapters/ — chat platform adapters (Slack, WhatsApp, Telegram, Discord, CLI) and event adapters (GitHub, HTTP API)
+- src/queue.ts — SQLite task queue
+- src/runners/ — agent runner implementations (Claude, future Codex)
+- src/repos.ts — git clone/pull/worktree management
+- src/router.ts — message → task mapping
+- src/config.ts — repo/user configuration
+
+## Conventions
+- No classes unless necessary, prefer functions and plain objects
+- Use bun:sqlite directly, no ORMs
+- Use bun:test for testing
+- Structured JSON logging via src/logger.ts

package/Dockerfile

@@ -0,0 +1,37 @@
+FROM oven/bun:1 AS base
+
+# System deps: git for repo management, ssh for private repos
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends git openssh-client && \
+    rm -rf /var/lib/apt/lists/*
+
+# Claude CLI (installed via npm since bun global install has quirks)
+RUN bunx --bun npm i -g @anthropic-ai/claude-code
+
+WORKDIR /app
+
+# Install dependencies
+COPY package.json bun.lock ./
+RUN bun install --frozen-lockfile --production
+
+# Copy source
+COPY bin/ bin/
+COPY src/ src/
+COPY tsconfig.json ./
+COPY config.example.json .env.example ./
+
+# Non-root user (Claude CLI refuses --dangerously-skip-permissions as root)
+# Default UID/GID 1000 matches most host users; override with --build-arg
+ARG UID=1000
+ARG GID=1000
+RUN groupadd -g $GID ove 2>/dev/null || true && \
+    useradd -m -s /bin/bash -u $UID -g $GID ove 2>/dev/null || true && \
+    mkdir -p repos && \
+    chown -R $UID:$GID /app
+USER $UID
+
+# Git safe.directory for mounted volumes
+RUN git config --global --add safe.directory '*'
+
+ENTRYPOINT ["bun", "run", "bin/ove.ts"]
+CMD ["start"]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Love Nyberg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,183 @@
+<p align="center">
+  <img src="logo.png" width="180" alt="Ove" />
+</p>
+
+<h1 align="center">Ove</h1>
+
+<p align="center">
+  Your grumpy but meticulous dev companion.<br>
+  <a href="https://jacksoncage.github.io/ove">Docs</a> · <a href="https://github.com/jacksoncage/ove">GitHub</a> · <a href="https://github.com/jacksoncage/ove/pkgs/npm/ove">Package</a>
+</p>
+
+---
+
+Talk to Ove from Slack, WhatsApp, Telegram, Discord, GitHub issues, a Web UI, or the terminal — he'll grumble about it, but he'll review your PRs, fix your issues, run your tests, brainstorm ideas, and scaffold new projects. Properly.
+
+## Quick Start
+
+```bash
+npm install -g @jacksoncage/ove
+ove init    # interactive setup — creates config.json and .env
+ove start
+```
+
+## Prerequisites
+
+- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated
+- [GitHub CLI](https://cli.github.com) (`gh`) installed and authenticated
+- SSH access to your git repos
+
+## Commands
+
+```
+review PR #N on <repo>      Code review with inline comments
+fix issue #N on <repo>      Read issue, implement fix, create PR
+simplify <path> in <repo>   Reduce complexity, create PR
+validate <repo>             Run tests and linter
+discuss <topic>             Brainstorm ideas (no code changes)
+create project <name>       Scaffold a new project
+
+Scheduling:
+<task> every day at <time>   Schedule a recurring task
+list schedules              See your scheduled tasks
+remove schedule #N          Remove a scheduled task
+
+Meta:
+status                      Queue stats
+history                     Recent tasks
+clear                       Reset conversation
+```
+
+## Deployment
+
+Three ways to run Ove. Pick what fits. See the [full guide](https://jacksoncage.github.io/ove#getting-started) for details.
+
+### Local
+
+```bash
+npm install -g @jacksoncage/ove
+ove init
+ove start
+```
+
+Requires [Bun](https://bun.sh), Claude Code CLI, and GitHub CLI on your machine.
+
+### Docker
+
+```bash
+ove init                    # generate config locally
+docker compose up -d        # start container
+docker compose logs -f      # watch logs
+```
+
+The image includes Bun, git, and Claude CLI. Mounts `config.json`, `.env`, `repos/`, and SSH keys from the host.
+
+### VM
+
+Ove runs well on a small VM (2 CPU, 4 GB RAM). Install Bun, Claude Code, and GitHub CLI, then run as a systemd service:
+
+```bash
+git clone git@github.com:jacksoncage/ove.git && cd ove
+bun install
+ove init
+sudo cp deploy/ove.service /etc/systemd/system/ove.service
+sudo systemctl enable --now ove
+```
+
+## Transport Setup
+
+### Slack
+
+1. Create app at [api.slack.com/apps](https://api.slack.com/apps)
+2. Enable **Socket Mode** → generate App-Level Token (`xapp-...`)
+3. Bot scopes: `chat:write`, `channels:history`, `groups:history`, `im:history`, `mpim:history`, `app_mentions:read`
+4. Event subscriptions: `message.im`, `app_mention`
+5. **App Home** → Messages Tab → "Allow users to send messages"
+6. Install to workspace → copy Bot Token (`xoxb-...`)
+
+### Telegram
+
+1. Message [@BotFather](https://t.me/BotFather) → `/newbot`
+2. Copy the bot token
+3. Set `TELEGRAM_BOT_TOKEN=<token>` in `.env`
+
+### Discord
+
+1. Create app at [discord.com/developers](https://discord.com/developers/applications)
+2. Bot → enable **Message Content Intent**
+3. Copy bot token
+4. Invite bot to server with `bot` scope + `Send Messages`, `Read Message History`
+5. Set `DISCORD_BOT_TOKEN=<token>` in `.env`
+
+### HTTP API + Web UI
+
+1. Set `HTTP_API_PORT=3000` and `HTTP_API_KEY=<your-secret>` in `.env`
+2. Open `http://localhost:3000` for the Web UI
+3. Or call the API directly: `curl -X POST http://localhost:3000/api/message -H "X-API-Key: <key>" -H "Content-Type: application/json" -d '{"text": "validate my-app"}'`
+
+### GitHub (issue/PR comments)
+
+1. Set `GITHUB_POLL_REPOS=owner/repo1,owner/repo2` in `.env`
+2. Optionally set `GITHUB_BOT_NAME=ove` (default) and `GITHUB_POLL_INTERVAL=30000`
+3. Mention `@ove` in an issue or PR comment to trigger a task
+4. Ove replies with a comment when the task completes
+
+### WhatsApp
+
+1. Set `WHATSAPP_ENABLED=true` in `.env`
+2. Scan the QR code printed in the terminal on first start
+
+## Config
+
+```json
+{
+  "repos": {
+    "my-app": {
+      "url": "git@github.com:org/my-app.git",
+      "defaultBranch": "main"
+    }
+  },
+  "users": {
+    "slack:U0ABC1234": { "name": "alice", "repos": ["my-app"] },
+    "telegram:123456789": { "name": "alice", "repos": ["my-app"] },
+    "discord:987654321": { "name": "alice", "repos": ["my-app"] },
+    "github:alice": { "name": "alice", "repos": ["my-app"] },
+    "http:anon": { "name": "alice", "repos": ["my-app"] },
+    "cli:local": { "name": "alice", "repos": ["my-app"] }
+  },
+  "claude": { "maxTurns": 10 },
+  "cron": [
+    {
+      "schedule": "0 9 * * 1-5",
+      "repo": "my-app",
+      "prompt": "Run lint and tests.",
+      "userId": "slack:U0ABC1234"
+    }
+  ]
+}
+```
+
+Static cron jobs go in `config.json`. Users can also create schedules via chat — these are stored in SQLite and managed with `list schedules` / `remove schedule #N`.
+
+## Testing
+
+```bash
+bun test    # 150 tests
+```
+
+## How It Works
+
+1. Message arrives via any transport (Slack, WhatsApp, Telegram, Discord, CLI, HTTP API, or GitHub comment)
+2. Chat adapters use `handleMessage`, event adapters use `handleEvent`
+3. Router parses intent and extracts repo/args
+4. Task gets queued in SQLite (one per repo at a time)
+5. Worker creates an isolated git worktree
+6. Runs `claude -p` with streaming NDJSON output
+7. Status updates stream back (chat: edits a message, HTTP: SSE, GitHub: single comment)
+8. Result sent back, worktree cleaned up
+
+See [example conversations](docs/examples.md) for all flows.
+
+## License
+
+MIT

package/bin/ove.ts

@@ -0,0 +1,72 @@
+#!/usr/bin/env bun
+
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { validateConfig, runSetup } from "../src/setup";
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (command === "init") {
+  if (existsSync("config.json")) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await rl.question("  Config already exists. Overwrite? (y/n): ");
+    rl.close();
+    if (answer.trim().toLowerCase() !== "y") {
+      console.log("  Aborted.");
+      process.exit(0);
+    }
+  }
+  await runSetup();
+  process.exit(0);
+}
+
+if (command === "start" || !command) {
+  process.stdout.write("\n  Checking config...\n");
+  const { valid, issues } = validateConfig();
+
+  if (!valid) {
+    for (const issue of issues) {
+      process.stdout.write(`  ⚠ ${issue}\n`);
+    }
+    process.stdout.write("\n");
+
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await rl.question("  Want to fix these now? (y/n): ");
+    rl.close();
+
+    if (answer.trim().toLowerCase() === "y") {
+      await runSetup({ fixOnly: issues });
+    }
+  }
+
+  process.stdout.write("  Starting Ove...\n\n");
+  const entry = join(import.meta.dir, "..", "src", "index.ts");
+  await import(entry);
+} else if (command === "test") {
+  console.log("Run: bun test");
+  process.exit(0);
+} else if (command === "help" || command === "--help" || command === "-h") {
+  console.log(`
+ove - Your grumpy but meticulous dev companion
+
+Usage:
+  ove              Start Ove (auto-detects Slack/CLI from env)
+  ove start        Same as above
+  ove init         Interactive setup — creates config.json and .env
+  ove help         Show this message
+
+Environment:
+  SLACK_BOT_TOKEN  Slack bot token (xoxb-...)
+  SLACK_APP_TOKEN  Slack app token (xapp-...)
+  CLI_MODE=true    Force CLI mode
+  REPOS_DIR        Directory for git repos (default: ./repos)
+
+More info: https://jacksoncage.github.io/ove
+`);
+  process.exit(0);
+} else {
+  console.log(`Unknown command: ${command}. Run 'ove help' for usage.`);
+  process.exit(1);
+}