/fasterfixes

Turn messy client feedback into agent-ready bug reports.

Website  •  Docs  •  Twitter

About

During the review phase of a web project, clients send feedback through WhatsApp messages, scattered screenshots, and vague descriptions with no link to the page. Developers then spend time deciphering what was meant, finding the right page, and turning it into something actionable.

Faster Fixes replaces that workflow. Clients leave feedback directly on the website through a lightweight widget. The system captures the full context automatically — screenshot, page URL, DOM selector, browser metadata, and React component tree when available. Developers consume that feedback from a dashboard or directly from their AI coding agent via MCP.

The goal is a short path from client comment to resolved fix:

client feedback → structured context → AI agent fixes it

How It Works

1. Collect feedback with the widget

Install the React widget in your application. Clients click anywhere on the page to leave feedback. The widget captures the screenshot, element selector, component tree, and browser info automatically — no setup required from the client.

import { FeedbackProvider } from "@fasterfixes/react";

function App() {
  return (
    <FeedbackProvider apiKey="your-project-api-key">
      <YourApp />
    </FeedbackProvider>
  );
}

2. Review feedback on the dashboard

Open the Faster Fixes dashboard to see all feedback items organized by project and page. Each item includes the client's comment alongside the captured context. Copy any item as a structured markdown report, ready to paste into your AI coding agent.

3. Or let your agent handle it via MCP

Connect the Faster Fixes MCP server to your editor. Your AI coding agent can fetch new feedback, read the full context, locate the relevant code, fix the issue, and mark it as resolved — without leaving the terminal.

claude mcp add faster-fixes -s project \
  --env FASTER_FIXES_TOKEN=ff_agent_xxx \
  --env FASTER_FIXES_PROJECT=proj_xxx \
  -- npx -y @fasterfixes/mcp

The MCP server works with Claude Code, Cursor, VS Code, Windsurf, Codex, and Zed.

Features

• Visual feedback widget — clients click on elements to leave feedback, no training needed
• Automatic context capture — screenshot, page URL, DOM selector, component tree, browser info
• Developer dashboard — organized view of all feedback across projects
• Markdown export — copy any feedback item as a structured bug report for AI agents
• MCP server — AI coding agents fetch and resolve feedback programmatically
• Agent skill — install as a skill for autonomous feedback-to-fix workflows
• GitHub integration — automatically create issues from feedback items
• Team collaboration — organizations, projects, and role-based access
• Review links — share a link with clients so they can leave feedback without an account

Packages

This monorepo publishes three npm packages:

MCP Setup

The MCP server exposes two tools: list_feedbacks and update_feedback_status. It connects to the Faster Fixes API using an organization-scoped agent token.

{
  "mcpServers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

{
  "mcpServers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

{
  "servers": {
    "faster-fixes": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

{
  "mcpServers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

[mcp_servers.faster-fixes]
command = "npx"
args = ["-y", "@fasterfixes/mcp"]

[mcp_servers.faster-fixes.env]
FASTER_FIXES_TOKEN = "ff_agent_your_token_here"
FASTER_FIXES_PROJECT = "proj_your_project_id"

{
  "context_servers": {
    "faster-fixes": {
      "command": "npx",
      "args": ["-y", "@fasterfixes/mcp"],
      "env": {
        "FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
        "FASTER_FIXES_PROJECT": "proj_your_project_id"
      }
    }
  }
}

You can find your agent token and project ID in Organization Settings on the dashboard.

Built With

• Next.js — app framework
• React — UI library
• Prisma — database ORM
• tRPC — type-safe API layer
• Tailwind CSS — styling
• Better Auth — authentication
• Stripe — billing
• Inngest — background jobs
• Turborepo — monorepo tooling

License

This repository is licensed under the GNU AGPLv3 License.

The widget packages (@fasterfixes/core, @fasterfixes/react) and the MCP server (@fasterfixes/mcp) are licensed under MIT for unrestricted use in your applications.