Better Response

Better Response is a small, free agent plugin that improves the agent's reply when plain text is hard to use. Its UI engine is Engawa: the agent authors a validated tree, and Engawa renders it as an MCP App without another LLM call.

Website · Privacy · Terms · Issues

Questions and bug reports go to the issue tracker; support is best-effort on a noncommercial project. MIT licensed.

Repository standard

This repository is a pnpm monorepo:

apps/better-response/          Website, Streamable HTTP MCP server, and MCP App renderer
packages/engawa/       Engawa schema, renderer, components, and styles
plugins/better-response/dist/  Installable skill, host metadata, logo, and MCP URL

apps/ contains deployable services, packages/ contains framework packages, and plugins/<name>/dist contains the files installed into an agent host. Better Response has one small plugin distribution shared by Cursor and Codex. It points both hosts to the Visualize MCP server owned entirely by apps/better-response; no server or renderer is installed locally. On main, the plugin is Better Response (Dev) and connects to the development server; install from the production branch for the released plugin.

The remaining dotfolders are host entrypoints, not competing layouts:

.agents/plugins/marketplace.json   Codex repository marketplace
.cursor-plugin/marketplace.json    Cursor repository marketplace
.cursor/mcp.json                   Cursor CLI localhost HTTP configuration
plugins/better-response/dist/.codex-plugin/     Required Codex manifest
plugins/better-response/dist/.cursor-plugin/    Required Cursor manifest

The two plugin manifests and two marketplace catalogs cannot be merged because the hosts require different paths and schemas. Both installable manifests connect to the production Streamable HTTP endpoint. The isolated development launcher overrides only that URL to localhost, so local and production consumers use the same MCP server and transport.

The MCP App source lives under apps/better-response/mcp. Its Vite build produces the ignored apps/better-response/mcp/dist/app.html immediately before Next.js builds. The MCP route serves that generated resource, and Next.js includes it in the deployment output. It is never a committed or manually synchronized plugin artifact.

A second bundle beside it, mcp/demo.html, renders a fixed payload through the same substrate, renderer, and registered components, and the website's /demo route serves it into an iframe so the landing page demonstrates the real thing rather than a screenshot. It needs its own vite.demo.config.ts because viteSingleFile inlines dynamic imports, which rollup rejects for more than one input.

Related MCP server: ggui

Verify

pnpm install
pnpm probe

The probe builds the MCP App and Next.js project, starts the production build locally, and runs the full vertical over its Streamable HTTP route.

Develop through Codex

pnpm dev

pnpm dev:codex is the same command. This is the complete local development loop, run by agent-playground from agent-playground.json. It builds the hosted MCP App, starts it in Vite watch mode, starts the watched Next.js website and MCP route at http://127.0.0.1:3100, and launches a fresh, isolated Codex desktop instance whose Better Response plugin points at http://127.0.0.1:3100/api/mcp.

The isolated instance has its own Codex home and app profile under ~/.agent-playground/runs/. It borrows your current access token but never your refresh token, installs Better Response from a staged copy of plugins/better-response/dist as the only local plugin, and seeds two threads from playground/fixtures: Create beef steak shopping list and Find Cube Attain 2026 changes (cut before the first markdown comparison table). Your own tasks, configuration, personal plugins, and ~/.agents/skills are not loaded. Codex still provides its own bundled first-party plugins, including its own Visualize; pick Better Response: Visualize from the / menu. Close the isolated instance to stop the local server and remove its state.

Keep that instance open while developing. Next.js reloads the MCP route, Vite rebuilds the MCP App, and plugin edits are reinstalled through the Codex CLI. Start a new Codex task after changing the skill or tool contract so that the task receives the new context.

Open either seeded thread and invoke /visualize (or $ → Visualize): the shopping-list thread for the checklist path, or the Cube Attain thread for an Engawa DataGrid instead of Markdown. The agent may also use Better Response without a manual invocation whenever the available interface would be materially easier to use than a static response.

To add a fixture, have the conversation in your everyday Codex, then run pnpm exec agent-playground threads and pnpm exec agent-playground export <thread-id> --out playground/fixtures/<name>. The export removes paths, reasoning, developer instructions, and usage data, and refuses to write if it still finds something that looks like a secret.

To update the personal Codex installation explicitly instead:

pnpm install:codex

That command mirrors the plugin into ~/plugins/better-response, applies the Codex cachebuster, and reinstalls better-response@personal. The installed plugin connects to https://betterresponse-dev.vercel.app/api/mcp; fully restart the normal Codex instance if it retains the prior plugin configuration.

Develop through Cursor

pnpm dev:cursor

This launches the Cursor equivalent of the Codex loop: the same watched local MCP route, plus a separate Cursor desktop instance connected to http://127.0.0.1:3100/api/mcp.

The launcher keeps a persistent isolated Electron profile under ~/.better-response/cursor-dev (--user-data-dir and --extensions-dir) so the test instance can run beside everyday Cursor without loading everyday chats or settings. It does not override HOME, because that breaks Cursor's Keychain access. Cursor still loads local plugins from ~/.cursor/plugins/local, so the launcher points that Better Response install at localhost for the session and restores the production plugin files when you close the isolated window. Keep the everyday Cursor window closed during this session if you do not want it to share that localhost plugin. The isolated profile is kept so a one-time sign-in can persist across runs.

Keep that instance open while developing. Next.js reloads the MCP route, Vite rebuilds the MCP App, and skill edits are copied into the isolated plugin install. Start a new agent chat after changing the skill or tool contract so that the chat receives the new context.

Discuss a recipe, invoke /visualize, and submit the prompt.

To update the everyday Cursor installation explicitly instead:

mkdir -p "$HOME/.cursor/plugins/local"
pnpm install:cursor

That command mirrors the plugin into ~/.cursor/plugins/local/better-response. The installed plugin connects to https://betterresponse-dev.vercel.app/api/mcp. It skips the sync when Cursor's local plugin directory does not exist. After syncing, use Cursor's plugin reload; fully restart Cursor if it retains the prior plugin configuration. Use a real directory rather than a symlink. Do not keep a marketplace-installed Better Response enabled alongside the local copy.

For server-only or Cursor CLI development, run pnpm dev:server; the project-level .cursor/mcp.json points to the localhost HTTP route. pnpm dev, pnpm dev:cursor, and pnpm dev:server stop a leftover Next.js worker from a previous session before starting, so killing only the parent Node process no longer blocks the next run.

Environments

Commit subjects follow Conventional Commits: fix: releases a patch, feat: a minor, and feat!: a major. semantic-release computes every version from them, so nobody edits versions by hand. The pipeline is the shared one in enkind/.github; plugin-release.json describes this repository to it. CI checks commit subjects and runs the typecheck, the Storybook build, and pnpm probe on every pull request and push, and probes each deployed endpoint after deploying. To try the development server in ChatGPT, add its MCP URL as a connector in developer mode.

To release, run gh workflow run ci.yml --ref main. Production is deployed and probed before the GitHub release and the production branch are published. Every release, dev or stable, attaches better-response-<version>.zip.

Scope

Better Response is a free, noncommercial project that follows SemVer from its 1.0.0 public release: additions advance the minor version and breaking contract changes the major version. The first product slice stops at local interaction inside the rendered view: nothing the user touches there is sent back to the agent.