Guides
How to do things in Glitchgrab, step by step. Looking for the SDK reference? See the docs.
Getting started
- Connect your GitHub orgSign in, connect a GitHub organisation, install the GitHub App and sync new repos so reports become issues
- Create an API tokenGenerate a gg_ token for a repo so your app, server or agent can send reports into it
- Limit a token to your own websitesSet allowed domains on a gg_ token so a copied token cannot use the AI features from another site
- Add Glitchgrab to your Next.js appInstall the glitchgrab SDK, add the report button and turn on automatic error capture in a Next.js app
- Capture errors from your serverReport crashes from API routes, cron jobs and background workers with glitchgrab/server
- Read your org overviewWhat every card on the Overview page means — reports today, failed retries, open issues, PRs, team, triage, issues closed and SEO — and a daily check
AI features
- Turn on the AI report assistantSwitch on AI assist for a repo so reporters get answers from your guides and GLITCH.md, and help writing clear reports
- Write a GLITCH.md for your projectCreate the GLITCH.md brief the AI assistant reads first: what to write, which headings do what, and size limits
- Label issues with AI triageTurn on AI triage so each new issue gets a gg: label for the kind of problem, and correct a wrong label
- Require signed-in users for AI featuresUse a signing secret and signSession so only your logged-in users can use the AI assistant, AI enhance and voice input
- Let reporters flag a problem with GlitchgrabWhat the "Problem with Glitchgrab?" link in the report dialog does, and how to turn it on or off per repo
Reports and issues
- What your users see when they report a bugA walkthrough of the report dialog: the screenshot prompt, the AI assistant, the plain form, attachments, duplicates and what reaches your issue
- File a bug from the dashboard chatDescribe a bug, paste screenshots or speak it in Chat, and turn it into a GitHub issue on any repo — no SDK needed
- Find and manage reportsSearch and filter reports, read a report card's status and source, send fixes to QA and dismiss failed reports
- Assign new issues automaticallySet default assignees per repo (or for many repos at once) so every new Glitchgrab issue lands with the right developer
- A report did not become a GitHub issueTroubleshoot a report that never showed up on GitHub: GitHub App not installed, duplicates, failed reports, wrong token
Team and QA
- Add team members and give them accessHow people join through your GitHub org, what owners and members can see, and granting access to a project's calls and memory
- Add a QA testerAdd a QA tester with no GitHub account, assign their repos, get them signed in, and how they verify fixes with Pass or Fail
- See what your testers are doingWhere tester work time, bugs filed and Pass/Fail verdicts show up, and who is notified on GitHub and WhatsApp when a fix fails QA
- Report a bug as a testerFile a new bug as a QA tester from any website with ⌘⇧G in the Glitchgrab Chrome extension
Calls
- Record calls automatically with Google CalendarConnect Google Calendar so the Glitchgrab bot joins and records your Google Meet client calls on its own
- Send the bot to a callRecord any Google Meet call by pasting its link on the Calls page, or with one click from inside Meet using the Glitchgrab extension
- Why Meet lists the bot under "With potential risks"Why Google Meet puts the Glitchgrab bot in Waiting to join → With potential risks with only a Deny button, how to admit it, and how to skip the warning
- Remove the Glitchgrab bot from a callMake the recording bot leave a Google Meet call early — from the Meet pill, the Calls page, or Meet's People list — without losing what it recorded
- Read a call's transcriptFind a recorded call, understand its recording and transcript status, read speaker names, retry a failed transcript, and delete one call or many at once
- Share a call with your clientMark a recorded call as shared and show its recording, transcript and screenshots inside your own admin panel with the project's server key and glitchgrab/server
- Turn a call into GitHub issuesDraft one GitHub issue per request from a recorded call, correct drafts by chatting, and file the ones you want
- Book demos from your websiteLet prospects book a demo from your real Google Calendar availability — in a dialog on your site or over WhatsApp — and get every demo recorded
Guides and AI agents
- Connect your AI agent to Glitchgrab (MCP)Connect Claude Code, Claude.ai or Claude Desktop to the Glitchgrab MCP server to read reports, issues and recorded calls, comment with screenshots and write guides
- Write guides in the dashboardCreate, edit, verify and publish step-by-step guides that the AI assistant sends people to and your site can show
- Show guides on your own siteRead published guides from the Glitchgrab API with a gg_ token and render them on your own website, with safe HTML
- Write guides from your own serverIssue the project's ggc_ server key under API Tokens → Server keys and create, update or delete its guides from your own code or MCP client, without a Glitchgrab login
Your users
- Collect star ratings from your usersAsk your users for 1–5 star feedback with FeedbackButton, review it on the Feedback page, and publish the best ratings back into your app
- Keep a project's memory with ContextTurn call notes and past bug reports into a searchable record of what a client asked for, decided, complained about and was promised
Integrations
- Send issue events to your webhookGet a signed POST to your own URL when an issue is created, updated, closed or commented on, and verify the X-Glitchgrab-Signature
- Get WhatsApp alerts for your issuesAdd and verify your WhatsApp number to get issue assignment alerts and a daily issue digest, and pause them with Skip today
- Track Google indexing with Search ConsoleConnect Google Search Console properties to see indexed pages, ask Google to re-crawl pages that are not indexed, and file indexing issues
- Watch your Chrome Web Store releasesTrack your Chrome extension's review state and get a WhatsApp message when a version goes live, is rejected, or sits unsubmitted