O
ooolzhas/annotatekit
Visual feedback for iOS apps that goes straight to your coding agent
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"ooolzhas-annotatekit": {
"command": "npx",
"args": ["fetches"]
}
}
}Parsed from the README we fetched on 2026-10-29; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"ooolzhas-annotatekit": {
"command": "npx",
"args": ["fetches"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio ooolzhas-annotatekit -- npx fetches
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 27 ★ · ooolzhas/annotatekit · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-10-30 · last seen 2026-11-14 · seen 16× · listed by 1 sources
- Score
- score 103 · 27 ★ · 1 sources · repo
- Install
npx fetches
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx fetches. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: 开源项目. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
ooolzhas/annotatekit；first catalogued 2026-10-30；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.AnnotateKit
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
Visual feedback for iOS apps that goes straight to your coding agent.
Tap, draw and comment on your running app. Hit Send. Your agent gets the screenshots, the exact coordinates and your notes.
annotatekit.com
1. In your running app, in the Simulator or on your iPhone, tap the Annotate pill. The screen
freezes.
2. Draw around anything, tap an element to select it, or hold to pin an exact spot.
Say what should change.
3. Hit ↑. Claude Code, already open on your Mac, starts working. Annotate mode stays open and
narrates it: Claude received your notes → Claude is working… → All changes applied ·
Reinstalling, while each note's badge spins until the agent resolves it and then turns into a
green check. The dot on the pill is green while an agent listens, yellow while it reconnects, and
red when nothing does. It works the same from a physical iPhone, with no extra setup.
No copy/paste and no tagging views: every pixel is annotatable. It works with SwiftUI and UIKit,
and everything is compiled out of Release builds.
This is Cursor's Annotate for native iOS. It runs inside your DEBUG build
the way Cursor's runs inside its browser, so it can read the real view and accessibility tree.
## Install
### Let your agent do it
Tell Claude Code (or Cursor, Codex…):
> Set up AnnotateKit from github.com/ooolzhas/annotatekit in this app.
The repo ships an annotate-setup skill that walks an agent
through every project shape (Xcode project, XcodeGen, Tuist, SwiftPM), the CLI and the connection.
In Claude Code, installing the plugin gives you the skill, the MCP server and the CLI in one go:
/plugin install annotate --marketplace ooolzhas/annotatekit
On Claude Code older than 2.1.275, run /plugin marketplace add ooolzhas/annotatekit, then
/plugin install annotate@annotatekit. After that, ask: "Set up AnnotateKit in this app."
### By hand
1. The overlay. Add https://github.com/ooolzhas/annotatekit with Swift Package Manager and
link AnnotateKit to your app target (iOS 17+). Then:
swift
import AnnotateKit
@main
struct MyApp: App {
init() {
Annotate.install() // DEBUG-only; a no-op in Release
var body: some Scene { WindowGroup { ContentView() } }
Add .annotate/ to your .gitignore.
2. The CLI (skip this if you use the Claude Code plugin):
sh
brew install ooolzhas/tap/annotate # or: npm install -g annotate-ios
# or: mint install ooolzhas/annotatekit
3. Connect your agent. Pick one:
| Agent | How sends reach it |
| Claude Code + channels (recommended) | Pushed into your open session the moment you hit Send, even while Claude is idle. Start with claude --dangerously-load-development-channels plugin:annotate@annotatekit, or server:annotate without the plugin. |
| Claude Code, no flags | Run /annotate-watch. A watcher picks up each Send. |
| Unattended | annotate run in the project root runs claude -p per Send (--permission-mode acceptEdits, resuming the conversation). |
| Cursor / Codex / VS Code / Claude desktop / any MCP client | Add the server (below) and ask the agent to "keep calling annotationwait": each call blocks until you Send, then returns the notes. Or say "check my latest annotation" now and then. |
Channels are a Claude Code research preview. During the
Tap, draw and comment on your running app. Hit Send. Your agent gets the screenshots, the exact coordinates and your notes.
annotatekit.com
1. In your running app, in the Simulator or on your iPhone, tap the Annotate pill. The screen
freezes.
2. Draw around anything, tap an element to select it, or hold to pin an exact spot.
Say what should change.
3. Hit ↑. Claude Code, already open on your Mac, starts working. Annotate mode stays open and
narrates it: Claude received your notes → Claude is working… → All changes applied ·
Reinstalling, while each note's badge spins until the agent resolves it and then turns into a
green check. The dot on the pill is green while an agent listens, yellow while it reconnects, and
red when nothing does. It works the same from a physical iPhone, with no extra setup.
No copy/paste and no tagging views: every pixel is annotatable. It works with SwiftUI and UIKit,
and everything is compiled out of Release builds.
This is Cursor's Annotate for native iOS. It runs inside your DEBUG build
the way Cursor's runs inside its browser, so it can read the real view and accessibility tree.
## Install
### Let your agent do it
Tell Claude Code (or Cursor, Codex…):
> Set up AnnotateKit from github.com/ooolzhas/annotatekit in this app.
The repo ships an annotate-setup skill that walks an agent
through every project shape (Xcode project, XcodeGen, Tuist, SwiftPM), the CLI and the connection.
In Claude Code, installing the plugin gives you the skill, the MCP server and the CLI in one go:
/plugin install annotate --marketplace ooolzhas/annotatekit
On Claude Code older than 2.1.275, run /plugin marketplace add ooolzhas/annotatekit, then
/plugin install annotate@annotatekit. After that, ask: "Set up AnnotateKit in this app."
### By hand
1. The overlay. Add https://github.com/ooolzhas/annotatekit with Swift Package Manager and
link AnnotateKit to your app target (iOS 17+). Then:
swift
import AnnotateKit
@main
struct MyApp: App {
init() {
Annotate.install() // DEBUG-only; a no-op in Release
var body: some Scene { WindowGroup { ContentView() } }
Add .annotate/ to your .gitignore.
2. The CLI (skip this if you use the Claude Code plugin):
sh
brew install ooolzhas/tap/annotate # or: npm install -g annotate-ios
# or: mint install ooolzhas/annotatekit
3. Connect your agent. Pick one:
| Agent | How sends reach it |
| Claude Code + channels (recommended) | Pushed into your open session the moment you hit Send, even while Claude is idle. Start with claude --dangerously-load-development-channels plugin:annotate@annotatekit, or server:annotate without the plugin. |
| Claude Code, no flags | Run /annotate-watch. A watcher picks up each Send. |
| Unattended | annotate run in the project root runs claude -p per Send (--permission-mode acceptEdits, resuming the conversation). |
| Cursor / Codex / VS Code / Claude desktop / any MCP client | Add the server (below) and ask the agent to "keep calling annotationwait": each call blocks until you Send, then returns the notes. Or say "check my latest annotation" now and then. |
Channels are a Claude Code research preview. During the
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/ooolzhas-annotatekit/)
- Source
- github · https://github.com/ooolzhas/annotatekit
- Browse by field
- Open source
- Traction
- 27 ★
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.