git404hub

what is heckle fr?

rbsriram/heckle — explained in plain English

Analysis updated 2026-05-18

3TypeScriptAudience · vibe coderComplexity · 3/5Setup · moderate

tl;dr

Heckle lets you report app bugs by talking or typing, then automatically hands your coding agent a task with the console and network evidence attached.

vibe map

mindmap
  root((Heckle))
    What it does
      Voice or text bug reports
      Captures console and network
      Waits for approval
      Tracks Fixed status
    Tech stack
      TypeScript
      Node.js
      Ollama
      MCP
    Use cases
      Live QA during dev
      Replay past bugs
      Staging capture widget
    Agents
      Claude Code
      Cursor
      Codex

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Report a bug by speaking or typing instead of screenshotting and writing it up manually.

VIBE 2

Automatically capture console errors, network calls, and DOM state to hand to a coding agent as evidence.

VIBE 3

Replay a previously reported bug to confirm a fix actually resolved it.

VIBE 4

Let a non-technical reporter file a bug from a staging site using a lightweight capture-only widget.

what's the stack?

TypeScriptNode.jsOllamaMCP

how it stacks up fr

rbsriram/heckle000madz000/payload-test-api-route-handleraliansari22/pdfclear
Stars333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencevibe coderdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Node 24 or newer and a drafting model such as Ollama running locally.

No license information is stated in the README.

in plain english

Heckle is a QA tool built for people who develop apps with the help of AI coding agents. Instead of screenshotting a bug and typing a paragraph to explain it to your agent, you just say what is wrong out loud or type it, and Heckle turns that into a clear task. It attaches the relevant console errors and network details automatically, then hands the task to your coding agent, but nothing happens until you approve it. The author built it after getting tired of being the one who had to watch the app, notice bugs, and manually relay every detail back to an agent that could not see the screen itself. Heckle watches the page for you: it captures the DOM, console errors, and network calls tied to the exact steps you took, so the agent has real evidence instead of a guess. After you approve a task, a live status line shows what the agent is doing, and Heckle marks it Fixed or Did not land based on whether the code actually changed, not just a hopeful assumption. It also remembers what you flagged before so you never have to explain the same bug twice, and it runs locally on your machine using a local model by default, so nothing has to leave your computer. Heckle runs on macOS, Windows, and Linux, though voice input built into the device is macOS only for now. It needs Node 24 or newer, plus a drafting model, with Ollama running the qwen3:14b model as the local default, or an OpenAI-compatible cloud provider if you prefer. A coding agent such as Claude Code, Cursor, or Codex is optional, without one, approved tasks are saved to a local file instead. To try it, you run a single npx command against your existing dev server, no cloning or global install required. Heckle then prints a local link and adds a small button to your app for talking to it. Every approved report is saved as a versioned, replayable artifact, and Heckle can rerun these to check whether a fix actually resolved the issue before marking it complete. It also exposes its data and replay tools to coding agents over MCP, and includes a rule-based instant edit path for small, literal changes like copy or color tweaks.

prompts (copy fr)

prompt 1
Show me how to run Heckle against my existing npm run dev server using npx heckle-dev.
prompt 2
Explain how to configure Heckle to use a cloud drafting model instead of the local Ollama default.
prompt 3
How do I register Heckle as an MCP tool for Claude Code so my agent can pull open issues?
prompt 4
Write the HTML snippet to embed Heckle's capture-only widget on a staging page for non-technical testers.

Frequently asked questions

what is heckle fr?

Heckle lets you report app bugs by talking or typing, then automatically hands your coding agent a task with the console and network evidence attached.

What language is heckle written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Ollama.

What license does heckle use?

No license information is stated in the README.

How hard is heckle to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is heckle for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.