Faster Fixes

/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

Add the widget to any website: WordPress, Webflow, static HTML, or an app built with any framework. Paste one tag, replacing the Project ID with your own:

<script
  src="https://cdn.jsdelivr.net/npm/@fasterfixes/widget@1/dist/widget.iife.js"
  data-project-id="proj_your_project_id"
  defer
></script>

In a React application, use the React embed instead. It mounts the same widget:

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

function App() {
  return (
    <FeedbackProvider projectId="proj_your_project_id">
      <YourApp />
    </FeedbackProvider>
  );
}

In a Vue or Nuxt application, use the Vue embed:

import { createFasterFixes } from "@fasterfixes/vue";

createApp(App)
  .use(createFasterFixes({ projectId: "proj_your_project_id" }))
  .mount("#app");

In an Angular or Analog application, use the Angular embed:

import { provideFasterFixes } from "@fasterfixes/angular";

export const appConfig: ApplicationConfig = {
  providers: [provideFasterFixes({ projectId: "proj_your_project_id" })],
};

In a Svelte or SvelteKit application, use the Svelte embed in the root component or layout:

<script lang="ts">
  import { initFasterFixes } from "@fasterfixes/svelte";

  initFasterFixes({ projectId: "proj_your_project_id" });
</script>

Clients click anywhere on the page to leave feedback. The widget captures the screenshot, element selector, browser info, and the React component tree on React sites automatically, with no setup required from the client. See the script embed, React, Vue, Angular and Svelte docs.

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 seven 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/widget, @fasterfixes/react, @fasterfixes/vue, @fasterfixes/angular, @fasterfixes/svelte, @fasterfixes/core) and the MCP server (@fasterfixes/mcp) are licensed under MIT for unrestricted use in your applications.