npm - @lovenyberg/ove - Versions diffs - 0.5.2 → 0.6.1 - Mend

@lovenyberg/ove 0.5.2 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (28) hide show

package/README.md +13 -1
package/deploy/ove.service +16 -0
package/package.json +1 -1
package/src/config.test.ts +6 -0
package/src/config.ts +5 -1
package/src/flows.test.ts +1 -1
package/src/handlers.ts +75 -70
package/.dockerignore +0 -7
package/.github/workflows/ci.yml +0 -16
package/.github/workflows/pages.yml +0 -33
package/.github/workflows/publish.yml +0 -45
package/Dockerfile +0 -37
package/bun.lock +0 -503
package/bunfig.toml +0 -2
package/docker-compose.yml +0 -15
package/docs/examples.md +0 -247
package/docs/favicon.ico +0 -0
package/docs/index.html +0 -980
package/docs/logo.png +0 -0
package/docs/plans/2026-02-21-codex-runner-design.md +0 -51
package/docs/plans/2026-02-21-codex-runner-plan.md +0 -475
package/docs/plans/2026-02-22-repo-autodiscovery-design.md +0 -98
package/docs/plans/2026-02-22-repo-autodiscovery-plan.md +0 -826
package/docs/plans/2026-02-23-conversation-repo-memory.md +0 -272
package/docs/plans/2026-02-25-landing-page-harmonization-design.md +0 -89
package/docs/plans/2026-02-25-landing-page-harmonization-plan.md +0 -604
package/logo.png +0 -0
package/public/logo.png +0 -0

package/docs/index.html DELETED Viewed

@@ -1,980 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <link rel="icon" href="favicon.ico">
-  <title>Ove — Your Grumpy Dev Companion</title>
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-  <style>
-    :root {
-      --bg: #1a1a1a;
-      --bg-panel: #161616;
-      --bg-item: #1e1e1e;
-      --bg-item-hover: #252525;
-      --border: #2a2a2a;
-      --border-light: #333;
-      --text: #e0e0e0;
-      --text-dim: #777;
-      --text-muted: #555;
-      --accent: #8ab4f8;
-      --green: #4ade80;
-      --red: #f28b82;
-      --amber: #fbbf24;
-    }
-    * { margin: 0; padding: 0; box-sizing: border-box; }
-    html { scroll-behavior: smooth; }
-    body {
-      font-family: "Inter", system-ui, -apple-system, sans-serif;
-      color: var(--text);
-      line-height: 1.7;
-      background: var(--bg);
-      font-size: 16px;
-      -webkit-font-smoothing: antialiased;
-    }
-    /* ─── HEADER ─── */
-    header {
-      display: flex;
-      align-items: center;
-      justify-content: space-between;
-      padding: 0.5rem 1rem;
-      border-bottom: 1px solid var(--border);
-      background: var(--bg-panel);
-      position: sticky;
-      top: 0;
-      z-index: 100;
-    }
-    .header-left {
-      display: flex;
-      align-items: center;
-      gap: 1rem;
-    }
-    .header-logo {
-      width: 24px;
-      height: 24px;
-      border-radius: 3px;
-      object-fit: cover;
-    }
-    .header-left h1 {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.85rem;
-      font-weight: 600;
-      letter-spacing: 0.05em;
-    }
-    .nav-link {
-      color: var(--text-dim);
-      text-decoration: none;
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.7rem;
-      padding: 0.2rem 0.5rem;
-      border: 1px solid var(--border);
-      border-radius: 3px;
-      transition: all 0.15s;
-    }
-    .nav-link:hover {
-      color: var(--text);
-      border-color: var(--border-light);
-      background: var(--bg-item);
-    }
-    /* ─── HERO ─── */
-    .hero {
-      display: flex;
-      align-items: center;
-      justify-content: center;
-      padding: 64px 32px;
-      border-bottom: 1px solid var(--border);
-    }
-    .hero-inner {
-      display: grid;
-      grid-template-columns: auto 1fr;
-      gap: 48px;
-      align-items: center;
-      max-width: 900px;
-    }
-    .hero-portrait {
-      width: 140px;
-      height: 140px;
-      border-radius: 4px;
-      border: 1px solid var(--border);
-      box-shadow: 0 12px 32px rgba(0,0,0,0.3);
-      object-fit: cover;
-    }
-    .hero-text h1 {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 2.5rem;
-      font-weight: 700;
-      color: var(--text);
-      letter-spacing: -0.02em;
-      line-height: 1;
-      margin-bottom: 6px;
-    }
-    .hero-subtitle {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.8rem;
-      color: var(--text-dim);
-      font-weight: 400;
-      letter-spacing: 0.08em;
-      text-transform: uppercase;
-      margin-bottom: 20px;
-    }
-    .hero-quote {
-      font-style: italic;
-      color: var(--text-dim);
-      font-size: 1.05rem;
-      line-height: 1.5;
-      margin-bottom: 24px;
-      max-width: 420px;
-    }
-    .hero-quote span {
-      color: var(--text-muted);
-      font-style: normal;
-      font-size: 0.8rem;
-    }
-    .btn {
-      display: inline-block;
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.8rem;
-      font-weight: 500;
-      text-decoration: none;
-      padding: 10px 24px;
-      border: 1px solid var(--border-light);
-      color: var(--accent);
-      background: transparent;
-      border-radius: 3px;
-      transition: all 0.15s;
-      letter-spacing: 0.02em;
-    }
-    .btn:hover {
-      background: var(--accent);
-      color: var(--bg);
-      border-color: var(--accent);
-    }
-    .btn-ghost {
-      border-color: var(--border);
-      color: var(--text-dim);
-    }
-    .btn-ghost:hover {
-      border-color: var(--text-dim);
-      color: var(--text);
-      background: transparent;
-    }
-    /* ─── INSTALL BAR ─── */
-    .install-bar {
-      background: var(--bg-panel);
-      border-bottom: 1px solid var(--border);
-      padding: 16px 32px;
-      text-align: center;
-    }
-    .install-bar code {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.82rem;
-      color: var(--accent);
-      letter-spacing: -0.02em;
-    }
-    .install-bar code::before {
-      content: "$ ";
-      color: var(--text-muted);
-    }
-    /* ─── MAIN CONTENT ─── */
-    .container {
-      max-width: 740px;
-      margin: 0 auto;
-      padding: 0 32px;
-    }
-    .section {
-      padding: 64px 0;
-      border-bottom: 1px solid var(--border);
-    }
-    .section:last-child {
-      border-bottom: none;
-    }
-    /* ─── SECTION HEADERS ─── */
-    h2 {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 1.3rem;
-      font-weight: 700;
-      color: var(--text);
-      margin-bottom: 8px;
-      letter-spacing: -0.01em;
-    }
-    .section-note {
-      color: var(--text-dim);
-      font-style: italic;
-      margin-bottom: 32px;
-      font-size: 0.9rem;
-    }
-    h3 {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.9rem;
-      font-weight: 500;
-      color: var(--accent);
-      margin: 32px 0 10px;
-      letter-spacing: 0.01em;
-    }
-    h3:first-child,
-    .section-note + h3 {
-      margin-top: 0;
-    }
-    /* ─── FEATURES ─── */
-    .features {
-      display: grid;
-      grid-template-columns: 1fr 1fr;
-      gap: 1px;
-      background: var(--border);
-      border: 1px solid var(--border);
-      margin-top: 32px;
-    }
-    .feature {
-      padding: 24px 20px;
-      background: var(--bg);
-    }
-    .feature-label {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.65rem;
-      text-transform: uppercase;
-      letter-spacing: 0.12em;
-      color: var(--text-muted);
-      margin-bottom: 8px;
-    }
-    .feature h3 {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.95rem;
-      color: var(--text);
-      margin: 0 0 8px;
-      font-weight: 500;
-    }
-    .feature p {
-      color: var(--text-dim);
-      font-size: 0.85rem;
-      line-height: 1.55;
-      margin-bottom: 10px;
-    }
-    .feature code {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.75rem;
-      color: var(--accent);
-      background: var(--bg-item);
-      padding: 3px 8px;
-      border: 1px solid var(--border);
-      display: inline-block;
-    }
-    /* ─── PERSONALITY QUOTES ─── */
-    .ove-says {
-      border-left: 2px solid var(--accent);
-      padding: 14px 0 14px 20px;
-      margin: 32px 0;
-      font-style: italic;
-      color: var(--text-dim);
-      font-size: 0.95rem;
-    }
-    .ove-says .attr {
-      display: block;
-      font-style: normal;
-      color: var(--text-muted);
-      font-size: 0.75rem;
-      margin-top: 6px;
-      font-family: "JetBrains Mono", monospace;
-    }
-    /* ─── CODE BLOCKS ─── */
-    pre {
-      background: var(--bg-panel);
-      border: 1px solid var(--border);
-      padding: 16px 18px;
-      overflow-x: auto;
-      font-size: 0.8rem;
-      margin: 14px 0;
-      line-height: 1.65;
-      position: relative;
-      border-radius: 3px;
-    }
-    pre::before {
-      content: attr(data-label);
-      position: absolute;
-      top: 0;
-      right: 0;
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.6rem;
-      text-transform: uppercase;
-      letter-spacing: 0.1em;
-      color: var(--text-muted);
-      padding: 4px 10px;
-      background: var(--bg-item);
-      border-left: 1px solid var(--border);
-      border-bottom: 1px solid var(--border);
-      border-radius: 0 3px 0 3px;
-    }
-    code {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.85em;
-    }
-    pre code {
-      color: var(--text);
-      font-size: 1em;
-    }
-    p code {
-      background: var(--bg-item);
-      border: 1px solid var(--border);
-      padding: 1px 6px;
-      color: var(--accent);
-      font-size: 0.82em;
-      border-radius: 2px;
-    }
-    /* ─── LISTS ─── */
-    .steps {
-      margin: 16px 0;
-      padding-left: 0;
-      list-style: none;
-      counter-reset: step;
-    }
-    .steps li {
-      counter-increment: step;
-      padding: 8px 0 8px 36px;
-      position: relative;
-      border-bottom: 1px solid var(--border);
-      font-size: 0.95rem;
-    }
-    .steps li:last-child {
-      border-bottom: none;
-    }
-    .steps li::before {
-      content: counter(step);
-      position: absolute;
-      left: 0;
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.75rem;
-      color: var(--text-muted);
-      width: 22px;
-      text-align: right;
-    }
-    /* ─── LINKS ─── */
-    a {
-      color: var(--accent);
-      text-decoration: none;
-      border-bottom: 1px solid var(--border);
-      transition: border-color 0.15s;
-    }
-    a:hover {
-      border-bottom-color: var(--accent);
-    }
-    strong {
-      color: var(--text);
-      font-weight: 500;
-    }
-    p {
-      margin-bottom: 12px;
-    }
-    p:last-child {
-      margin-bottom: 0;
-    }
-    /* ─── COMMANDS TABLE ─── */
-    .cmd-grid {
-      display: grid;
-      grid-template-columns: auto 1fr;
-      gap: 0;
-      border: 1px solid var(--border);
-      font-size: 0.88rem;
-    }
-    .cmd-grid dt,
-    .cmd-grid dd {
-      padding: 10px 16px;
-      border-bottom: 1px solid var(--border);
-    }
-    .cmd-grid dt:last-of-type,
-    .cmd-grid dd:last-of-type {
-      border-bottom: none;
-    }
-    .cmd-grid dt {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.78rem;
-      color: var(--accent);
-      background: var(--bg-panel);
-      white-space: nowrap;
-      border-right: 1px solid var(--border);
-    }
-    .cmd-grid dd {
-      color: var(--text-dim);
-    }
-    /* ─── HOW IT WORKS ─── */
-    .pipeline {
-      margin: 24px 0;
-      padding-left: 0;
-      list-style: none;
-    }
-    .pipeline li {
-      display: flex;
-      gap: 16px;
-      padding: 14px 0;
-      border-bottom: 1px solid var(--border);
-      align-items: baseline;
-      font-size: 0.95rem;
-    }
-    .pipeline li:last-child {
-      border-bottom: none;
-    }
-    .pipeline .step-n {
-      font-family: "JetBrains Mono", monospace;
-      font-size: 0.7rem;
-      color: var(--text-muted);
-      flex-shrink: 0;
-      width: 16px;
-      text-align: right;
-    }
-    .pipeline .step-arrow {
-      color: var(--border-light);
-      flex-shrink: 0;
-      font-size: 0.8rem;
-    }
-    /* ─── FOOTER ─── */
-    footer {
-      padding: 40px 32px;
-      text-align: center;
-      color: var(--text-dim);
-      font-size: 0.78rem;
-      border-top: 1px solid var(--border);
-      font-family: "JetBrains Mono", monospace;
-      letter-spacing: 0.02em;
-    }
-    footer a {
-      color: var(--text-muted);
-      border-bottom: none;
-    }
-    footer a:hover {
-      color: var(--accent);
-    }
-    /* ─── RESPONSIVE ─── */
-    @media (max-width: 700px) {
-      .hero-inner {
-        grid-template-columns: 1fr;
-        text-align: center;
-        gap: 32px;
-      }
-      .hero-portrait {
-        width: 120px;
-        height: 120px;
-        margin: 0 auto;
-      }
-      .hero-quote {
-        margin: 0 auto 32px;
-      }
-      .hero-actions {
-        justify-content: center;
-      }
-      .hero-text h1 {
-        font-size: 2rem;
-      }
-      .features {
-        grid-template-columns: 1fr;
-      }
-      .cmd-grid {
-        grid-template-columns: 1fr;
-      }
-      .cmd-grid dt {
-        border-right: none;
-        border-bottom: none;
-        padding-bottom: 0;
-      }
-      .cmd-grid dd {
-        padding-top: 2px;
-      }
-    }
-    /* ─── ANIMATIONS ─── */
-    @media (prefers-reduced-motion: no-preference) {
-      .hero-portrait {
-        animation: fadeUp 0.8s ease both;
-      }
-      .hero-text h1 {
-        animation: fadeUp 0.7s ease 0.1s both;
-      }
-      .hero-subtitle {
-        animation: fadeUp 0.7s ease 0.2s both;
-      }
-      .hero-quote {
-        animation: fadeUp 0.7s ease 0.3s both;
-      }
-      .hero-actions {
-        animation: fadeUp 0.7s ease 0.4s both;
-      }
-    }
-    @keyframes fadeUp {
-      from {
-        opacity: 0;
-        transform: translateY(16px);
-      }
-      to {
-        opacity: 1;
-        transform: translateY(0);
-      }
-    }
-  </style>
-</head>
-<body>
-<header>
-  <div class="header-left">
-    <img class="header-logo" src="logo.png" alt="">
-    <h1>ove</h1>
-    <a class="nav-link" href="#features">features</a>
-    <a class="nav-link" href="#getting-started">setup</a>
-    <a class="nav-link" href="#commands">commands</a>
-    <a class="nav-link" href="#deploy">deploy</a>
-  </div>
-  <a class="nav-link" href="https://github.com/jacksoncage/ove">github</a>
-</header>
-<section class="hero">
-  <div class="hero-inner">
-    <img class="hero-portrait" src="logo.png" alt="Ove, grumpy but reliable">
-    <div class="hero-text">
-      <h1>Ove</h1>
-      <div class="hero-subtitle">Dev companion</div>
-      <p class="hero-quote">
-        "Just tell me what's wrong. I'll figure it out."
-        <span>— Ove, on every conversation</span>
-      </p>
-      <div class="hero-actions">
-        <a class="btn" href="#getting-started">Get started</a>
-        <a class="btn btn-ghost" href="https://github.com/jacksoncage/ove">GitHub</a>
-      </div>
-    </div>
-  </div>
-</section>
-<div class="install-bar">
-  <code>npm install -g @lovenyberg/ove</code>
-</div>
-<div class="container">
-  <section class="section" id="features">
-    <h2>What Ove Does</h2>
-    <p class="section-note">He grumbles, but he gets it done. Properly.</p>
-    <p>Talk to Ove like you'd talk to a colleague. Ask questions, describe problems, paste error logs, think out loud &mdash; he understands natural language. No need to memorize commands. Just chat.</p>
-<pre data-label="just chat">"the login page throws a 500 after submitting"
-"can you check what's breaking the auth tests on my-app?"
-"how does the payment webhook work?"
-"refactor the user service, it's getting messy"</pre>
-    <p>Ove figures out the intent, picks the right repo, and gets to work. For common tasks, there are also shorthand commands &mdash; but they're shortcuts, not requirements.</p>
-    <div class="features">
-      <div class="feature">
-        <div class="feature-label">01 &mdash; Review</div>
-        <h3>Code Review</h3>
-        <p>Tell Ove to review a PR. He'll go through every line, find the bugs you missed, and leave comments. Thorough as always.</p>
-        <code>review PR #42 on my-app</code>
-      </div>
-      <div class="feature">
-        <div class="feature-label">02 &mdash; Fix</div>
-        <h3>Fix Issues</h3>
-        <p>Point Ove at a GitHub issue. He'll read it, explore the code, implement the fix, write tests, and open a PR.</p>
-        <code>fix issue #15 on my-app</code>
-      </div>
-      <div class="feature">
-        <div class="feature-label">03 &mdash; Validate</div>
-        <h3>Validate</h3>
-        <p>Run the test suite and linter. Ove reports every failure with the look of a man who knew this would happen.</p>
-        <code>validate my-app</code>
-      </div>
-      <div class="feature">
-        <div class="feature-label">04 &mdash; Discuss</div>
-        <h3>Brainstorm</h3>
-        <p>Discuss ideas with Ove. He'll ask the questions you forgot to ask, poke holes in your plan, and suggest what actually works.</p>
-        <code>discuss notification service</code>
-      </div>
-      <div class="feature">
-        <div class="feature-label">05 &mdash; Schedule</div>
-        <h3>Scheduled Tasks</h3>
-        <p>Tell Ove to do something on a schedule. He'll parse your natural language, set it up, and run it on time. Every time.</p>
-        <code>lint and check every day at 9</code>
-      </div>
-      <div class="feature">
-        <div class="feature-label">06 &mdash; Manage</div>
-        <h3>Task Management</h3>
-        <p>See what's running, what's queued, and kill anything that's gone sideways. Different repos run in parallel, same repo stays serial.</p>
-        <code>tasks</code> &nbsp; <code>cancel &lt;id&gt;</code>
-      </div>
-    </div>
-    <div class="ove-says">
-      "People today don't even know how a worktree works. In my day we used patches. On paper."
-      <span class="attr">— Ove, probably</span>
-    </div>
-  </section>
-  <section class="section" id="getting-started">
-    <h2>Getting Started</h2>
-    <p class="section-note">Three ways to run Ove. Pick what fits. No excuses.</p>
-    <h3>Prerequisites</h3>
-    <ol class="steps">
-      <li><a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code CLI</a> installed and authenticated (default runner)</li>
-      <li>Or <a href="https://github.com/openai/codex">OpenAI Codex CLI</a> installed and authenticated (alternative runner)</li>
-      <li><a href="https://cli.github.com">GitHub CLI</a> (<code>gh</code>) installed and authenticated</li>
-      <li>SSH access to your Git repos</li>
-    </ol>
-    <h3>1. Local</h3>
-    <p>Install globally, run the interactive setup, start.</p>
-<pre data-label="shell">npm install -g @lovenyberg/ove
-ove init     # walks you through config
-ove start</pre>
-    <p>Requires <a href="https://bun.sh">Bun</a> runtime on your machine.</p>
-    <h3>2. Docker</h3>
-    <p>Generate config locally, then run everything in a container. The image includes Bun, git, and Claude CLI.</p>
-<pre data-label="shell"># Generate config on host first
-ove init
-# Start the container
-docker compose up -d
-# Watch logs
-docker compose logs -f</pre>
-    <p>Mounts <code>config.json</code>, <code>.env</code>, <code>repos/</code>, and <code>~/.ssh</code> from the host. Set <code>ANTHROPIC_API_KEY</code> in <code>.env</code> or your shell.</p>
-    <h3>3. VM</h3>
-    <p>Best for always-on setups. A small VM (2 CPU, 4 GB RAM) is enough. See the <a href="#deploy">full VM guide</a> below.</p>
-<pre data-label="shell">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</pre>
-    <h3>Configure</h3>
-    <p><code>ove init</code> creates <code>config.json</code> and <code>.env</code> interactively. It asks for your transports, tokens, repos, and users. You can also edit them directly:</p>
-<pre data-label="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 },
-  "runner": { "name": "claude" },
-  "cron": [
-    {
-      "schedule": "0 9 * * 1-5",
-      "repo": "my-app",
-      "prompt": "Run lint and tests.",
-      "userId": "slack:U0ABC1234"
-    }
-  ]
-}</pre>
-    <p>Set <code>"runner"</code> globally to <code>{"name": "codex"}</code> to use OpenAI Codex, or override per-repo with a <code>"runner"</code> field inside the repo config. Supported runners: <code>claude</code> (default), <code>codex</code>.</p>
-    <p>Static cron jobs go in <code>config.json</code>. Users can also create schedules from chat &mdash; just say something like <code>lint and check every day at 9</code>. These are stored in SQLite and managed with <code>list schedules</code> / <code>remove schedule #N</code>.</p>
-    <div class="ove-says">
-      "Read the instructions before you start. I wrote them for a reason."
-      <span class="attr">— Ove</span>
-    </div>
-  </section>
-  <section class="section" id="commands">
-    <h2>Commands</h2>
-    <p class="section-note">Shortcuts for common tasks. You can also just type what you need in plain language.</p>
-    <dl class="cmd-grid">
-      <dt>review PR #N on &lt;repo&gt;</dt>
-      <dd>Code review with inline comments</dd>
-      <dt>fix issue #N on &lt;repo&gt;</dt>
-      <dd>Read issue, implement fix, create PR</dd>
-      <dt>simplify &lt;path&gt; in &lt;repo&gt;</dt>
-      <dd>Reduce complexity, create PR</dd>
-      <dt>validate &lt;repo&gt;</dt>
-      <dd>Run tests and linter</dd>
-      <dt>discuss &lt;topic&gt;</dt>
-      <dd>Brainstorm ideas, no code changes</dd>
-      <dt>create project &lt;name&gt;</dt>
-      <dd>Scaffold a new project</dd>
-      <dt>&lt;task&gt; every day/weekday at &lt;time&gt;</dt>
-      <dd>Schedule a recurring task</dd>
-      <dt>list schedules</dt>
-      <dd>See your scheduled tasks</dd>
-      <dt>remove schedule #N</dt>
-      <dd>Remove a scheduled task</dd>
-      <dt>tasks</dt>
-      <dd>List running and pending tasks</dd>
-      <dt>cancel &lt;id&gt;</dt>
-      <dd>Kill a running or pending task</dd>
-      <dt>status</dt>
-      <dd>Queue stats</dd>
-      <dt>history</dt>
-      <dd>Recent tasks</dd>
-      <dt>clear</dt>
-      <dd>Reset conversation</dd>
-      <dt>help</dt>
-      <dd>Show commands</dd>
-    </dl>
-  </section>
-  <section class="section">
-    <h2>How It Works</h2>
-    <p class="section-note">Parallel where it matters. Serial where it must be. Proper.</p>
-    <ol class="pipeline">
-      <li><span class="step-n">1</span><span class="step-arrow">&rsaquo;</span> Message arrives via Slack, WhatsApp, Telegram, Discord, CLI, HTTP API, or GitHub comment</li>
-      <li><span class="step-n">2</span><span class="step-arrow">&rsaquo;</span> Router parses intent and extracts repo/args</li>
-      <li><span class="step-n">3</span><span class="step-arrow">&rsaquo;</span> Task gets queued in SQLite &mdash; one per repo at a time, different repos run in parallel</li>
-      <li><span class="step-n">4</span><span class="step-arrow">&rsaquo;</span> Worker loop picks up tasks concurrently (up to 5 parallel)</li>
-      <li><span class="step-n">5</span><span class="step-arrow">&rsaquo;</span> Each task gets an isolated git worktree</li>
-      <li><span class="step-n">6</span><span class="step-arrow">&rsaquo;</span> Runs the configured runner (<code>claude -p</code> or <code>codex exec</code>) with streaming JSON output</li>
-      <li><span class="step-n">7</span><span class="step-arrow">&rsaquo;</span> Status updates stream back &mdash; chat edits, SSE, or GitHub comment</li>
-      <li><span class="step-n">8</span><span class="step-arrow">&rsaquo;</span> Result sent back, worktree cleaned up &mdash; use <code>tasks</code> to monitor, <code>cancel &lt;id&gt;</code> to stop</li>
-    </ol>
-  </section>
-  <section class="section" id="skills">
-    <h2>Skills</h2>
-    <p class="section-note">Teach Ove's Claude instances your conventions. Manually.</p>
-    <p>Ove spawns <a href="https://code.claude.com/docs/en/skills">Claude Code CLI</a> in isolated worktrees. The spawned instances automatically pick up <strong>skills</strong> &mdash; reusable instruction sets that follow the <a href="https://agentskills.io">Agent Skills</a> open standard.</p>
-    <p>Skills are configured <strong>manually</strong> on the host machine running Ove:</p>
-    <dl class="cmd-grid">
-      <dt>~/.claude/skills/</dt>
-      <dd>Personal skills &mdash; available across all repos on this machine</dd>
-      <dt>.claude/skills/</dt>
-      <dd>Per-repo skills &mdash; committed to each repo Ove manages</dd>
-      <dt>Plugins</dt>
-      <dd>Installed via <code>claude plugins add</code> &mdash; available where enabled</dd>
-    </dl>
-    <p>When Ove runs a task, Claude Code picks up all three levels. Drop a <code>SKILL.md</code> with domain knowledge, coding conventions, review checklists, or deployment workflows &mdash; and every task on that repo benefits.</p>
-<pre data-label="example: .claude/skills/review/SKILL.md">---
-name: review
-description: Review code using our team standards
----
-When reviewing code, check for:
-1. Error handling covers all failure modes
-2. Tests cover the happy path and at least one edge case
-3. No secrets or credentials in code</pre>
-    <p>See the <a href="https://code.claude.com/docs/en/skills">Claude Code skills docs</a> for frontmatter options, argument passing, subagent execution, and more.</p>
-    <div class="ove-says">
-      "Skills are just instructions in a file. Not magic. But they work."
-      <span class="attr">&mdash; Ove</span>
-    </div>
-  </section>
-  <section class="section" id="transports">
-    <h2>Transport Setup</h2>
-    <p class="section-note">Enable what you need. Ove doesn't judge. Much.</p>
-    <h3>Slack</h3>
-    <ol class="steps">
-      <li>Create a Slack app at <a href="https://api.slack.com/apps">api.slack.com/apps</a></li>
-      <li>Enable <strong>Socket Mode</strong> &mdash; generate an App-Level Token (<code>xapp-...</code>)</li>
-      <li>Add bot scopes: <code>chat:write</code>, <code>channels:history</code>, <code>groups:history</code>, <code>im:history</code>, <code>mpim:history</code>, <code>app_mentions:read</code></li>
-      <li>Enable <strong>Event Subscriptions</strong>: <code>message.im</code>, <code>app_mention</code></li>
-      <li><strong>App Home</strong> &rarr; enable Messages Tab &rarr; "Allow users to send messages"</li>
-      <li>Install to workspace &mdash; copy Bot Token (<code>xoxb-...</code>)</li>
-      <li>Add both tokens to <code>.env</code></li>
-    </ol>
-    <h3>Telegram</h3>
-    <ol class="steps">
-      <li>Message <a href="https://t.me/BotFather">@BotFather</a> &rarr; <code>/newbot</code></li>
-      <li>Copy the bot token</li>
-      <li>Set <code>TELEGRAM_BOT_TOKEN=&lt;token&gt;</code> in <code>.env</code></li>
-    </ol>
-    <h3>Discord</h3>
-    <ol class="steps">
-      <li>Create an app at <a href="https://discord.com/developers/applications">discord.com/developers</a></li>
-      <li>Bot &rarr; enable <strong>Message Content Intent</strong></li>
-      <li>Copy the bot token</li>
-      <li>Invite to server with <code>bot</code> scope + <code>Send Messages</code>, <code>Read Message History</code></li>
-      <li>Set <code>DISCORD_BOT_TOKEN=&lt;token&gt;</code> in <code>.env</code></li>
-    </ol>
-    <h3>HTTP API + Web UI</h3>
-    <ol class="steps">
-      <li>Set <code>HTTP_API_PORT=3000</code> and <code>HTTP_API_KEY=&lt;your-secret&gt;</code> in <code>.env</code></li>
-      <li>Open <code>http://localhost:3000</code> for the Web UI</li>
-      <li>Or call the API: <code>curl -X POST http://localhost:3000/api/message -H "X-API-Key: &lt;key&gt;" -d '{"text":"validate my-app"}'</code></li>
-    </ol>
-    <h3>GitHub (issue/PR comments)</h3>
-    <ol class="steps">
-      <li>Set <code>GITHUB_POLL_REPOS=owner/repo1,owner/repo2</code> in <code>.env</code></li>
-      <li>Optionally set <code>GITHUB_BOT_NAME=ove</code> (default) and <code>GITHUB_POLL_INTERVAL=30000</code></li>
-      <li>Mention <code>@ove</code> in an issue or PR comment to trigger a task</li>
-      <li>Ove replies with a comment when the task completes</li>
-    </ol>
-    <h3>WhatsApp</h3>
-    <ol class="steps">
-      <li>Set <code>WHATSAPP_ENABLED=true</code> and <code>WHATSAPP_PHONE=&lt;your-number&gt;</code> in <code>.env</code></li>
-      <li>Start Ove and enter the pairing code on your phone (WhatsApp &rarr; Linked Devices &rarr; Link a Device)</li>
-      <li>Set <code>WHATSAPP_ALLOWED_CHATS=&lt;phone1&gt;,&lt;phone2&gt;</code> to limit which chats Ove listens to. Without this, Ove responds to <strong>all</strong> your outgoing messages in every chat. Use phone numbers (e.g. <code>46701234567</code>) for individual chats or full JIDs (e.g. <code>120363xxx@g.us</code>) for groups.</li>
-    </ol>
-  </section>
-  <section class="section" id="deploy">
-    <h2>Deployment Details</h2>
-    <p class="section-note">Pick your method. They all work. Ove doesn't care.</p>
-    <h3>Docker</h3>
-    <p>The Dockerfile builds an image with Bun, git, openssh-client, and Claude CLI baked in. Install Codex CLI separately if needed. Just mount your config and go.</p>
-<pre data-label="docker-compose.yml">services:
-  ove:
-    build: .
-    env_file: .env
-    environment:
-      - ANTHROPIC_API_KEY
-    volumes:
-      - ./config.json:/app/config.json:ro
-      - ./repos:/app/repos
-      - ~/.ssh:/root/.ssh:ro
-    restart: unless-stopped</pre>
-    <p>Run <code>ove init</code> on the host first to generate <code>config.json</code> and <code>.env</code>, then <code>docker compose up -d</code>. Repos and the SQLite database persist in the <code>repos/</code> volume.</p>
-    <h3>VM</h3>
-    <p>Ove runs on a small VM (2 CPU, 4 GB RAM) where Claude Code and GitHub CLI are set up. Ubuntu 22.04+, Debian 12+. Hetzner, DigitalOcean, whatever you have.</p>
-    <h3>1. Install prerequisites</h3>
-<pre data-label="shell"># Bun
-curl -fsSL https://bun.sh/install | bash
-# Claude Code (default runner)
-npm install -g @anthropic-ai/claude-code
-# Or Codex CLI (alternative runner)
-# npm install -g @openai/codex
-# GitHub CLI
-sudo apt install gh
-gh auth login
-# SSH key for git
-ssh-keygen -t ed25519
-# Add the public key to GitHub</pre>
-    <h3>2. Authenticate Claude Code</h3>
-<pre data-label="shell"># Run once to authenticate
-claude
-# Verify it works
-claude -p "say hello" --output-format text</pre>
-    <h3>3. Clone and configure</h3>
-<pre data-label="shell">git clone git@github.com:jacksoncage/ove.git
-cd ove
-bun install
-ove init    # interactive setup</pre>
-    <h3>4. Run as a systemd service</h3>
-<pre data-label="shell"># Copy the service file
-sudo cp deploy/ove.service /etc/systemd/system/ove.service
-# Enable and start
-sudo systemctl enable ove
-sudo systemctl start ove
-# Check logs
-journalctl -u ove -f</pre>
-    <h3>5. Verify</h3>
-    <p>Send Ove a message on any configured transport and type <code>help</code>. He should respond. Grumpily.</p>
-    <div class="ove-says">
-      "If the service doesn't start, check the logs. That's what they're there for. I'm not going to hold your hand."
-      <span class="attr">— Ove, on debugging</span>
-    </div>
-  </section>
-</div>
-<footer>
-  Built by <a href="https://www.jacksoncage.se/">Love Billingskog Nyberg</a> &middot; Powered by <a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code</a> &amp; <a href="https://github.com/openai/codex">Codex</a>
-</footer>
-</body>
-</html>