Menyediakan feedback UI Jetpack Compose dan handoff konteks source code ke AI coding agent melalui local MCP server.
Juga dikenal sebagai beyondwin/FixThis, @beyondwin/fixthis
- Stars
- 5
- Tools
- —
- Unduhan, 30 hari
- 357
- Versi terbaru
- 1.5.0
- Commit terakhir
- 28 Okt 2026
- Lisensi
- MIT
Apa itu FixThis MCP?
FixThis adalah MCP server. Menyediakan feedback UI Jetpack Compose dan handoff konteks source code ke AI coding agent melalui local MCP server.
Ringkasan dibuat dari README proyek
Tentang FixThis MCP server
Developer Android yang bekerja dengan Jetpack Compose dapat menggunakan FixThis untuk menjembatani celah antara bug visual UI dan konteks source code. Dengan menyematkan debug sidekick ke aplikasi Compose, tool ini memungkinkan pengguna untuk menunjuk elemen UI tertentu di konsol browser lokal dan memberikan anotasi perubahan yang diinginkan. Proses ini menghasilkan handoff ringkas yang berisi bounds screenshot, semantik, dan kandidat source code yang dapat dikirim langsung ke coding agent.
Local MCP server ini berjalan melalui ADB dan localhost, memastikan tidak ada data yang dikirim ke API eksternal. Tool ini dirancang untuk digunakan dengan agent seperti Claude Code atau Codex, yang dapat mengotomatiskan instalasi Gradle plugin dan konfigurasi MCP. Pengguna dapat memilih untuk menyalin prompt secara manual untuk interface chat atau menggunakan fitur Save to MCP untuk melampirkan Android diagnostics yang telah diredaksi ke dalam request mereka. Sistem ini menyediakan detail teknis spesifik seperti nomor baris dan hint editSurface untuk membantu agent mengidentifikasi komponen composable yang tepat.
Apa yang bisa Anda lakukan dengannya
- 1Automated agent installationAI agent dapat mengonfigurasi proyek Jetpack Compose secara otomatis dengan menjalankan command install-agent dan menerapkan Gradle plugin yang diperlukan.
- 2Visual UI debuggingDeveloper dapat memilih komponen spesifik atau melakukan drag pada area tertentu di konsol berbasis browser untuk mendeskripsikan perubahan layout atau spacing.
- 3Contextual code handoffAlih-alih hanya menggunakan screenshot sederhana, tool ini menyediakan kandidat source code teratas dan nomor baris kepada agent untuk pengeditan yang presisi.
- 4Diagnostic data attachmentPengguna dapat menyertakan Android diagnostics yang sudah dibatasi (bounded) dan diredaksi saat menyimpan sesi ke MCP client.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal FixThis MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal FixThis MCP di Claude Code
$ claude mcp add fixthis -- npx -y @beyondwin/fixthisInstal FixThis MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"fixthis": {
"command": "npx",
"args": [
"-y",
"@beyondwin/fixthis"
]
}
}
}Instal FixThis MCP di VS Code
.vscode/mcp.json
{
"servers": {
"fixthis": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@beyondwin/fixthis"
]
}
}
}Instal FixThis MCP di VS Code CLI
$ code --add-mcp '{"name":"fixthis","type":"stdio","command":"npx","args":["-y","@beyondwin/fixthis"]}'Instal FixThis MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"fixthis": {
"command": "npx",
"args": [
"-y",
"@beyondwin/fixthis"
]
}
}
}Instal FixThis MCP di Codex
$ codex mcp add fixthis -- npx -y @beyondwin/fixthisInstal FixThis MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.fixthis] command = "npx" args = ["-y", "@beyondwin/fixthis"]
Instal FixThis MCP di Gemini CLI
$ gemini mcp add -s user fixthis npx -- -y @beyondwin/fixthisInstal FixThis MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"fixthis": {
"command": "npx",
"args": [
"-y",
"@beyondwin/fixthis"
]
}
}
}Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaubeyondwin/fixthis is public and reachablegithub.com/beyondwin/fixthis ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@beyondwin/fixthis names beyondwin/fixthis as sourcenpmjs.com/package/@beyondwin/fixthis ↗Lolos
- Provenance build (atestasi Sigstore)Sigstore attestation for @beyondwin/fixthisnpmjs.com/package/@beyondwin/fixthis/v/1.5.0#provenance ↗Lolos
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-28github.com/beyondwin/fixthis ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @beyondwin/fixthisLolos
- Tidak ada advisory kritis pada paket atau dependensinya1 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubFixThis for Android Compose

Point at a Jetpack Compose UI, write the change, and hand Claude, Codex, Cursor, or another coding agent the source context it needs.
FixThis is debug-only. It attaches a sidekick to a Compose debug app, mirrors the screen into a local browser console, and turns annotations into a compact handoff: screenshot bounds, semantics, source candidates, and confidence warnings.
Click a component to select it. Drag when the target is spacing, empty room, or something that is not a clean Compose node.
Works Today
- Try the sample app in about five minutes.
- Install the desktop CLI/MCP with Homebrew, npm, or GitHub Releases.
- Add it to an external app with the Gradle plugin
io.github.beyondwin.fixthis.compose. - Let Claude Code or Codex configure the sample with
./scripts/bootstrap-mcp.sh --sample. - Let an agent configure your app with
fixthis install-agent. - Use Copy Prompt with Cursor, ChatGPT, or any chat agent.
- Use Save to MCP with Claude Code or Codex.
- Save to MCP can attach a bounded, redacted Android diagnostics baseline. Switch the session to Manual or Off if you do not want that. Copy Prompt never starts collection.
- Runs locally over ADB and
127.0.0.1. No external API calls.
Quick Start: Agent Installs FixThis in Your App
Claude Code / Codex Bootstrap Prompt
Paste this into Claude Code or Codex from the root of a Jetpack Compose Android app:
Install FixThis in this project and configure it for this agent.
Use this order:
1. Run `fixthis install-agent --project-dir . --target all --verify --json`.
2. Use the JSON `readiness.state` and `actions[]` as the source of truth.
3. If `requiresUserAction` is true, tell me the exact blocking action.
4. Do not call `fixthis_open_feedback_console` until `readyForMcpTooling` is true, or until the report's `agent_after_restart` action is reached after restart.
Restart Claude Code or Codex if the report asks for it.
Do not configure release builds. Do not commit `.fixthis/`.
The agent should run:
# macOS
brew install beyondwin/tools/fixthis
# Node
npm install -g @beyondwin/fixthis
# macOS/Linux fallback
curl -fsSL https://raw.githubusercontent.com/beyondwin/FixThis/main/scripts/install-fixthis.sh \
| bash -s -- --version v1.5.0
fixthis install-agent --project-dir . --target all --verify --json
If Homebrew already has it, run
brew update && brew upgrade beyondwin/tools/fixthis and check
fixthis --version.
fixthis install-agent applies the Gradle plugin, writes MCP config, and
writes .fixthis/project.json plus .fixthis/agent-setup.*. If doctor
reports NEEDS_INSTALL or metadata is missing, run ./gradlew fixthisSetup
and rerun fixthis install-agent --project-dir . --target all --verify --json.
Restart Claude Code or Codex when the report asks, then call
fixthis_open_feedback_console. For a manual check, use
fixthis doctor --project-dir . --json.
Published plugin:
plugins {
id("io.github.beyondwin.fixthis.compose") version "1.5.0"
}
The plugin adds the debug-only sidekick and keeps release builds out.
Quick Start: Sample App to Agent Handoff
git clone <this-repo> && cd FixThis
./gradlew :fixthis-cli:installDist :fixthis-mcp:installDist
fixthis-cli/build/install/fixthis/bin/fixthis doctor --package io.github.beyondwin.fixthis.sample
fixthis-cli/build/install/fixthis/bin/fixthis run --package io.github.beyondwin.fixthis.sample
fixthis run installs the sample debug APK, launches it, and opens FixThis
Studio at http://127.0.0.1:<port>.
In the console:
- Click Annotate.
- Click a UI element, or drag an area.
- Type the change you want.
- Repeat for other spots on this screen.
- Copy Prompt for a chat agent, or Save to MCP for Claude Code / Codex.
You are done when a numbered annotation is visible and you have copied Markdown or saved a local MCP handoff.
Maintainers can prove that Copy Prompt path on a connected device:
npm run real-copy-prompt:smoke -- --strict
Pick Your Path
| Goal | Start here |
|---|---|
| Try it without touching your app | Sample quick start |
| Add it to your debug build | Add to your app |
| Connect an agent | Connect your agent |
| Bootstrap MCP from this repo | MCP.md |
| Use the console | Console tour |
| Understand the product | Product |
| Diagnose a failure | Troubleshooting |
| Inspect contracts | Docs index |
| Contribute | CONTRIBUTING.md |
| Reader | Start here |
|---|---|
| First-time user | Sample quick start |
| External app developer | Add to your app |
| Agent in this repo | AGENTS.md and project map |
| Maintainer | Docs index and project map |
| Contract or CLI change | Reference contracts |
Why not just a screenshot?
A screenshot is enough when the target is obvious. FixThis helps when the UI is dense, list-rendered, or named mostly by composable:
- Top-3 source candidates with line numbers and match reasons
editSurfacehints for call site vs component vs copy vs layout vs interop- Instance grouping so identical cards stay distinct
- Screen fingerprint so a rotated or changed screen cannot sneak into a save
- Honest confidence: visual-only, stale, or possible AndroidView/WebView
- Bounded runtime diagnostics on Save to MCP
- Retry-safe batches that do not duplicate work
Modules
| Module | Role |
|---|---|
:app (sample/) |
Validation sample |
:fixthis-compose-core |
Pure Kotlin domain |
:fixthis-compose-sidekick |
Debug Android runtime |
:fixthis-gradle-plugin |
Source index and debug wiring |
:fixthis-cli |
Desktop CLI |
:fixthis-mcp |
MCP server and local console |
More: Product, decisions, architecture.
Status
Public install paths:
- Gradle plugin
io.github.beyondwin.fixthis.compose - Maven
io.github.beyondwin:fixthis-compose-sidekickandfixthis-compose-core - Homebrew
brew install beyondwin/tools/fixthis - GitHub Release
fixthis-cli-mcp-vX.Y.Z.tar.gz - npm
@beyondwin/fixthis - MCP Registry
io.github.beyondwin/fixthis
Live dashboard: Release readiness.
main may be ahead of the latest tag. See CHANGELOG
and release notes.
Agents in this repo should read AGENTS.md.
Trust
FixThis stays on your machine. The sidekick talks over ADB, the console binds
to localhost, and Save to MCP writes under .fixthis/. Screenshots can
still contain sensitive pixels. Review them before sharing. Do not commit
.fixthis/.
Details: Privacy, Security, Threat model.
V1 stays narrow: Compose debug builds, local ADB, MCP-first handoff, best-effort source candidates, no cloud upload. See Roadmap.
License
Pertanyaan tentang FixThis MCP
Bagaimana cara menambahkan FixThis MCP ke Claude Code?
Jalankan claude mcp add fixthis -- npx -y @beyondwin/fixthis di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan FixThis MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apakah FixThis mengirim data ke cloud?
Tidak, tool ini berjalan secara lokal melalui ADB dan localhost tanpa ada panggilan API eksternal.
Bagaimana cara menggunakan FixThis dengan Claude Code atau Codex?
Anda dapat menggunakan fitur 'Save to MCP' atau menggunakan bootstrap prompt yang tersedia untuk mengonfigurasi agent Anda.