GitTinkerer¶

Comment-to-code automation.

Links¶

See it in action: https://github.com/NNTin/test/pull/6

Coverage report not included in docs.

Architecture¶

flowchart LR
  Dev[Developer]

  subgraph GitHub[GitHub]
    PR[Pull Request]
    Comments[PR Comments]
    API[GitHub API]
    Repo[Git Repository]
    Webhook[GitHub Webhook Delivery]
  end

  subgraph VPS[VPS]
    subgraph GT["GitTinkerer (this repo)"]
      Entry["bin/gittinkerer (bash)"]
      Work[Workspace manager]
      Codex[Codex runner]
      Git[Git commit/push]
      Reply[Reply publisher]
      Art[Artifacts writer]
    end

    subgraph Web["Web UI (same repo)"]
      Svelte["Svelte app (web/)"]
    end

    Service["HTTP service (service/)"]

    CodexCLI["Codex CLI (installed/authenticated)"]
  end

  subgraph Traefik["Traefik (elsewhere)"]
    Proxy[Reverse proxy]
  end

  Dev -->|writes comment| Comments
  Dev -->|uses web UI| Proxy
  Proxy -->|routes HTTP| Svelte

  Comments --> Webhook
  Webhook -->|HTTP POST| Service
  Service -->|spawn| Entry

  Entry --> Work
  Work --> Repo

  Entry --> Codex
  Codex --> CodexCLI

  Entry --> Git
  Git --> Repo

  Entry --> Reply
  Reply --> API

  Entry --> Art

Note¶

Code is closed source on GitHub due to potential prompt injection risk or risk of having the AI push sensitive information. GitHub repos are regularly scraped for vulnerabilities.