Feedbacks

Free, Apache-2.0 visual feedback, session replay and debugging context.

Show the problem with a screenshot, exact text suggestion or video + session recording. Keep the discussion, event timeline, browser diagnostics and approved project context together. Your team and coding agent can investigate the evidence, make the agreed change and record verification. The complete product is free to self-host; you provide the infrastructure and any AI tools you use.

Set up a team server first. The order is: server → install and connect the Chrome extension → project context, optional GitHub App and members → each developer's personal MCP setup. One installation serves your team; the extension does not host a server. Follow the complete setup flow, or the separate DevOps installation guide.

Website · Why Feedbacks · Self-hosting · Extension · Coding assistants & Codex plugin · API & MCP · Roadmap · Contributing

What it does

• Show exactly what changed: screenshot pins, annotation, full-page capture and selected-text replacement suggestions.
• Replay the bug: video or session-only recording with one timeline for activity, console, network and performance. Save and annotate frames.
• Take the evidence: complete thread bundles with discussion, media, recordings, diagnostics and checksums; scoped agent reads and recording exports.
• Give agents context: approved project instructions, reviewer guidance and responsibilities through MCP, API and CLI.
• Move the work forward: assignments, categories, tags, saved views and point progress; optional GitHub Issues across repositories and installations, with multiple configured Apps and one owner-selected App per project.
• Review beyond the extension: scoped guest links, PDF/image review, an optional text widget, surveys/NPS, scheduled public-page QA, native mobile clients and signed webhooks.
• Own the whole service: Apache-2.0 server and clients, PostgreSQL and private S3-compatible storage. One installation serves one organization.

Recording guide · Debug bundles · Text suggestions · More review workflows

Feedbacks is an early 0.x release. Each application deployment serves one organization. Public registration, billing, SSO and shared-database customer tenancy are not implemented. See architecture and deployment boundaries.

Run locally

Requirements: Node.js 22 or 24, npm, and Docker Compose for PostgreSQL.

git clone https://github.com/Softinator-TechLabs/feedbacks-oss.git
cd feedbacks-oss
npm ci
cp .env.example .env
docker compose -f compose.dev.yaml up -d --wait
npm run bootstrap
npm run build
npm run dev:server

Before bootstrap, add BOOTSTRAP_EMAIL, BOOTSTRAP_NAME and a unique BOOTSTRAP_PASSWORD to your local .env. Bootstrap creates the first owner once. Remove the bootstrap password afterward. Open localhost:3000. The example database password is for the loopback-only development database.

For live client edits, run npm run dev:web in another terminal and set APP_ORIGIN=http://localhost:5173 in .env before restarting the server. Use that origin in the browser. For the standalone public website, use npm run dev:site.

Production requires HTTPS, PostgreSQL and private S3-compatible storage. Follow the deployment guide for configuration, first-owner setup and recovery.

Browser extension

Build with npm run build:extension. Load the dist/extension/unpacked/ directory from Chrome's Load unpacked, or use the ZIP in dist/extension/. Enter your own Feedbacks server address and approve pairing in the web application. Website-wide permission is a separate optional action. Existing saved server connections remain available.

Repository map

Agent development

Start with AGENTS.md and the documentation map. Claude Code and Gemini CLI have thin adapters to the same instructions. See supported skills and client setup. For an isolated app with synthetic data and no deployment credentials:

npm ci
npm run harness:dev

The command builds the app and prints its loopback URL and private local access-file path. Each run has a disposable database and independent port.

Development

npm run check
# Optional native PostgreSQL concurrency tests (initdb and pg_ctl on PATH):
npm run test:postgres

check runs formatting, architecture/docs checks, type checking, tests, all builds, an isolated app smoke check and release-content checks. CI also runs the native PostgreSQL tests, dependency audit and secret scanning. A passing build is not evidence of production deployment or capacity.

License and community

The application, extension and website source are Apache-2.0 licensed. Dependencies retain their licenses. Read contribution guidelines, community standards, security reporting and trademark guidance.