Anno

English · 简体中文 · 日本語 · 한국어 · Français · Español · Deutsch · Italiano · Português · ไทย

Anno

Anno は、AI コーディングエージェント向けのローカルファーストな HTML レビューワークスペースです。ローカルの HTML ファイルの隔離コピーをブラウザーで開き、テキストや書式の直接編集、要素へのコメント、範囲注釈、スライドを考慮したレビューをサポートします。その後、エージェントが受け取り、検証済みの単独 HTML ファイルに反映できる、永続的な引き継ぎデータを返します。

このリポジトリには、共有 MCP サーバーとホストに依存しないスキル、ホストがサポートする場合のネイティブプラグインマニフェスト、そして Cursor、Google Antigravity、Windsurf、GitHub Copilot、Meta Muse Code 向けのすぐにコピーできる MCP テンプレートが含まれています。DeepSeek Harness のサポートは、DeepSeek Harness で構築されたプロセス内ネイティブプラグインである philmingdao/anno-dsh-native で別途管理されています。Muse Code のサポートは引き続き実験的です。

特長

• 127.0.0.1 にバインドするローカル専用 HTTP エディター
• 元のファイルは上書きされません
• テキスト、タイポグラフィ、色、位置、ページメモ、要素、範囲を直接編集
• 永続的で冪等なエージェントへの引き継ぎ
• 既存の needs_codex セッションとの下位互換性
• サポート対象ホスト間で MCP と SKILL.md の実装を共有
• 簡体字中国語と英語の UI、ライトテーマとダークテーマ

スクリーンショット

レビュ―エディターでは、HTML の隔離コピーをブラウザーで開きます。テキストやスタイルを直接編集し、要素や範囲にコメントを残して、収集した変更をワンクリックでエージェントに引き継げます。

必要条件

• Node.js 22 以降
• ローカル stdio MCP サーバーをサポートし、ローカルファイルにアクセスできるホスト
• レビューエディター用のブラウザー

サポート対象のエージェントツール

Codex、Claude Code、WorkBuddy、CodeBuddy では、パッケージ化されたプラグインマニフェストを使用します。Cursor、Google Antigravity、Windsurf、GitHub Copilot CLI/Chat、Muse Code は、ホスト固有の設定テンプレートを通じて、同じローカル stdio MCP サーバーに接続します。DeepSeek Harness は独立したネイティブの anno-dsh-native リポジトリを使用します。このリポジトリは MCP ブリッジを介さず、DSH プロファイル、ツールレジストリ、エージェントのライフサイクルと直接統合します。

すぐに使える設定とホストの制限事項については、エージェントツールの統合を参照してください。

エージェントツール	統合方式	ステータス
Codex	ネイティブプラグイン + MCP	サポート対象
Claude Code	ネイティブプラグイン + MCP	サポート対象
WorkBuddy / CodeBuddy	ネイティブプラグイン + MCP	サポート対象
Cursor	ローカル stdio MCP	サポート対象
Google Antigravity	ローカル stdio MCP	サポート対象
Windsurf	ローカル stdio MCP	サポート対象
GitHub Copilot CLI / Chat	ローカル stdio MCP	ローカルでサポート
DeepSeek Harness	独立したネイティブ DSH プラグイン	0.1.0-rc.6 で検証済み
Meta Muse Code	ローカル stdio MCP	実験的

ワンコマンドインストール

リポジトリのクローンやビルドは不要です。インストーラーは利用可能なエージェントツールを検出し、対話形式で選択できるようにします。また、既存の JSON/JSONC 設定には anno の項目だけをマージし、共有スキルをインストールし、変更前にタイムスタンプ付きのバックアップを作成して、MCP ハンドシェイクを実行します。

npx -y @philmingdao/[email protected] setup

無人インストールやホスト固有のインストールには、次を使用します。

npx -y @philmingdao/[email protected] setup --host cursor
npx -y @philmingdao/[email protected] setup --host cursor,windsurf,copilot
npx -y @philmingdao/[email protected] setup --host antigravity --scope project

macOS、Linux、Windows で同じコマンドを使用できます。共通の前提条件は Node.js 22+ のみです。次のコマンドで Anno を確認するか、安全に削除できます。

npx -y @philmingdao/[email protected] doctor --host cursor
npx -y @philmingdao/[email protected] uninstall --host cursor

DeepSeek Harness には、別のリポジトリに専用のネイティブ実装があります。GitHub から現在のソースを直接インストールします。

dsh plugin --profile web add github:philmingdao/anno-dsh-native
dsh web

インストール、アーキテクチャ、互換性、ソースチェックアウトのテストについては、philmingdao/anno-dsh-native を参照してください。このプラグインは DeepSeek Harness 自体を通じて開発・検証されており、Anno 向けに保守されている DeepSeek ソリューションです。

Codex、Claude Code、WorkBuddy、CodeBuddy は、それぞれのネイティブプラグインシステムを通じてインストールされます。Cursor にはネイティブプラグイン互換の MCP/Skill レイアウトが、Antigravity には完全なネイティブプラグインバンドルが提供されます。Windsurf と Copilot には、MCP と Skill の設定が提供されます。Muse Code では公開されている設定仕様が安定していないため、確認済みの設定パスが必要です。

npx -y @philmingdao/[email protected] setup --host muse --config /absolute/path/to/mcp.json

ネイティブのショートカットも利用できます。

copilot plugin install philmingdao/anno:plugins/anno

Anno が Cursor Marketplace に登録された後は、Cursor ユーザーはマーケットプレイスからリポジトリのネイティブプラグインを直接インストールできます。ダウンロードしたパッケージから作業する場合、Antigravity CLI では agy plugin install /path/to/host-plugins/antigravity を使ってパッケージ化されたディレクトリをインストールできます。

手動設定の代替手段

ユニバーサルインストーラーの使用を推奨します。次のバージョン固定テンプレートは、確認と手動マージが必要な管理環境向けに用意されています。

エージェントツール	テンプレート	設定先
Cursor	cursor/mcp.json	プロジェクトの .cursor/mcp.json または ~/.cursor/mcp.json
Google Antigravity	antigravity/mcp_config.json	プロジェクトの .agents/mcp_config.json または ~/.gemini/config/mcp_config.json
Windsurf	windsurf/mcp_config.json	~/.codeium/windsurf/mcp_config.json にマージ
GitHub Copilot CLI	github-copilot/mcp-config.json	~/.copilot/mcp-config.json にマージ
VS Code の GitHub Copilot Chat	github-copilot/vscode-mcp.json	プロジェクトの .vscode/mcp.json
Meta Muse Code	muse-code/mcp.json	ビルドの MCP マネージャーからインポート。実験的

Copilot CLI は MCP を通じて直接設定することもできます。

copilot mcp add anno --env ANNO_HOST=copilot -- npx -y @philmingdao/[email protected] mcp

保存後、ホストの MCP サーバー一覧を再起動または更新してください。GitHub のクラウドコーディングエージェントでは Anno のループバックレビュー URL を公開できないため、Copilot をローカルで使用してください。Muse Code のサポートは、公開されている MCP 設定仕様がまだ安定していないため、引き続き実験的です。

MCP サーバーを直接使用する

stdio MCP クライアントであれば、次を起動できます。

npx -y @philmingdao/[email protected] mcp

開発

npm install
npm test
npm run pack:check

コア MCP パッケージは plugins/anno にあります。DeepSeek Harness の実装は、独立した anno-dsh-native リポジトリで保守されています。生成された依存関係とローカルのレビューセッションはコミットされません。

データとプライバシー

Anno は HTML と注釈をローカルで処理します。エディターはループバックインターフェースのみで待ち受け、ホストヘッダーとオリジンヘッダーを検証します。汎用ホストではセッションを ~/.anno に保存します。Codex では、macOS 上で互換性のあるデフォルトの保存先として ~/Library/Application Support/Codex/anno を使用します。別のディレクトリを指定するには、ANNO_DATA_DIR を設定してください。

Anno はレビュー対象のファイルをアップロードしません。接続先のエージェントホストは、そのホスト独自のデータポリシーに従って、下書きと注釈を処理する場合があります。

互換性

ホスト固有の動作と制限については、docs/compatibility.md をご覧ください。

ライセンス

MIT。バンドルされている WDXL Lubrifont フォントには、plugins/anno/assets/OFL-WDXL-Lubrifont.txt に記載されている個別の SIL Open Font License が引き続き適用されます。