FixThis

Android Compose 向け FixThis

Jetpack Compose の UI を指定して変更内容を書き、Claude、Codex、 Cursor などのコーディングエージェントに、必要なソースコンテキストを引き渡します。

FixThis はデバッグ専用です。Compose のデバッグアプリにサイドキックを接続し、 画面をローカルのブラウザーコンソールにミラーリングして、注釈をコンパクトな 引き継ぎ情報に変換します。引き継ぎ情報には、スクリーンショットの範囲、 セマンティクス、ソース候補、信頼度に関する警告が含まれます。

コンポーネントをクリックして選択します。対象が余白、空白部分、 または明確な Compose ノードではないものの場合は、ドラッグします。

現在利用できる機能

• サンプルアプリを約 5 分で試せます。
• Homebrew、npm、または GitHub Releases からデスクトップ CLI/MCP をインストールできます。
• Gradle プラグイン io.github.beyondwin.fixthis.compose を使って、外部アプリに追加できます。
• Claude Code または Codex に ./scripts/bootstrap-mcp.sh --sample でサンプルを設定させることができます。
• エージェントに fixthis install-agent でアプリを設定させることができます。
• Cursor、ChatGPT、または任意のチャットエージェントで Copy Prompt を使えます。
• Claude Code または Codex で Save to MCP を使えます。
• Save to MCP では、範囲を限定して秘匿化した Android 診断ベースラインを添付できます。 これを望まない場合は、セッションを Manual または Off に切り替えてください。Copy Prompt では収集は開始されません。
• ADB と 127.0.0.1 を使ってローカルで実行されます。外部 API 呼び出しはありません。

クイックスタート：エージェントにアプリへ FixThis をインストールさせる

Claude Code / Codex ブートストラッププロンプト

Jetpack Compose Android アプリのルートから、これを Claude Code または Codex に貼り付けます。

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/`.

エージェントは次を実行します。

# 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

Homebrew にすでにインストールされている場合は、 brew update && brew upgrade beyondwin/tools/fixthis を実行し、 fixthis --version を確認してください。

fixthis install-agent は Gradle プラグインを適用し、MCP 設定を書き込み、 .fixthis/project.json と .fixthis/agent-setup.* を作成します。doctor が NEEDS_INSTALL を報告するかメタデータが不足している場合は、./gradlew fixthisSetup を実行し、 fixthis install-agent --project-dir . --target all --verify --json を再実行してください。 レポートで求められたら Claude Code または Codex を再起動し、 fixthis_open_feedback_console を呼び出します。手動で確認するには、 fixthis doctor --project-dir . --json を使います。

公開済みプラグイン：

plugins {
    id("io.github.beyondwin.fixthis.compose") version "1.5.0"
}

このプラグインはデバッグ専用のサイドキックを追加し、リリースビルドには適用されません。

クイックスタート：サンプルアプリからエージェントへの引き継ぎ

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 はサンプルのデバッグ APK をインストールして起動し、 http://127.0.0.1:<port> で FixThis Studio を開きます。

コンソールで：

1. Annotate をクリックします。
2. UI 要素をクリックするか、範囲をドラッグします。
3. 希望する変更内容を入力します。
4. この画面のほかの箇所についても繰り返します。
5. チャットエージェントには Copy Prompt を、Claude Code / Codex には Save to MCP を使います。

番号付きの注釈が表示され、Markdown をコピーするかローカルの MCP 引き継ぎ情報を保存すれば完了です。

メンテナーは、接続済みデバイスで Copy Prompt の手順を検証できます。

npm run real-copy-prompt:smoke -- --strict

目的に合わせて選ぶ

目的	こちらから開始
アプリに手を加えずに試す	サンプルのクイックスタート
デバッグビルドに追加する	アプリに追加
エージェントを接続する	エージェントを接続
このリポジトリから MCP をブートストラップする	MCP.md
コンソールを使う	コンソールの概要
プロダクトを理解する	プロダクト
障害を診断する	トラブルシューティング
コントラクトを確認する	ドキュメントのインデックス
コントリビュートする	CONTRIBUTING.md

読者	こちらから開始
初めて利用する方	サンプルのクイックスタート
外部アプリの開発者	アプリに追加
このリポジトリのエージェント	AGENTS.md と プロジェクトマップ
メンテナー	ドキュメントのインデックス と プロジェクトマップ
コントラクトまたは CLI の変更	リファレンスコントラクト

スクリーンショットだけではだめなのですか？

対象が明確な場合は、スクリーンショットで十分です。FixThis は、UI が 複雑で、リストとして描画されていたり、主にコンポーザブル名で識別されたりする場合に役立ちます。

• 行番号と一致理由を含む、ソース候補の上位 3 件
• 呼び出し箇所、コンポーネント、コピー、レイアウト、相互運用性のいずれかを示す editSurface ヒント
• 同一のカードを区別できるインスタンスのグループ化
• 回転した画面や変更後の画面が保存に紛れ込まないようにする画面フィンガープリント
• 視覚情報のみ、古い情報、AndroidView/WebView の可能性を正直に示す信頼度
• Save to MCP 時に上限を設けたランタイム診断情報
• 作業を重複させない、再試行に安全なバッチ処理

モジュール

モジュール	役割
:app (sample/)	検証用サンプル
:fixthis-compose-core	純粋な Kotlin ドメイン
:fixthis-compose-sidekick	デバッグ用 Android ランタイム
:fixthis-gradle-plugin	ソースインデックスとデバッグ設定
:fixthis-cli	デスクトップ CLI
:fixthis-mcp	MCP サーバーとローカルコンソール

詳細：プロダクト、判断の根拠、 アーキテクチャ。

ステータス

公開されているインストール方法：

• Gradle プラグイン io.github.beyondwin.fixthis.compose
• Maven io.github.beyondwin:fixthis-compose-sidekick および fixthis-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

ライブダッシュボード：リリース準備状況。

main は最新のタグより先行している場合があります。CHANGELOG とリリースノートを参照してください。

このリポジトリのエージェントは AGENTS.md をお読みください。

信頼性

FixThis はお使いのマシン上で動作します。sidekick は ADB 経由で通信し、コンソールは localhost にバインドされ、Save to MCP は .fixthis/ の下に書き込みます。スクリーンショットには 機密性の高いピクセルが含まれる場合があります。共有する前に内容を確認してください。 .fixthis/ をコミットしないでください。

詳細：プライバシー、セキュリティ、 脅威モデル。

V1 の範囲は限定されています。Compose デバッグビルド、ローカル ADB、MCP を優先した引き渡し、 ベストエフォートのソース候補、クラウドへのアップロードなしです。ロードマップを参照してください。

ライセンス

MIT。サードパーティの通知は NOTICE にあります。