Annotate any page
Not just localhost. Click a button, a card or the whole page, say what you want, and add a screenshot or recording. jotkit captures the selector, computed CSS and framework component so your agent knows exactly what you meant.
Click and ship.
jotkit by Good Banana® lets you leave tagged comments on any web page. jotkit keeps them in an append-only ledger on your machine and hands them to your coding agents, which claim the work, do it, and record what they changed.
npm i -g @jotkit/jotkitGet startedRequires Node.js 24. macOS and Linux.
Three simple steps.
Install and pair
npm i -g @jotkit/jotkit then jotkit init. That creates your ledger, starts the local daemon, installs the agent skills and prints a pairing code for the browser extension.
Annotate
Open the toolbar on any page. Pick an element or comment on the page, tag it, and choose whether it belongs to a repository or stays global. Attach a screenshot or a recording if it helps.
Hand it to an agent
Your agent reads the comments over MCP, claims one, does the work and logs the outcome. Or run jotkit acp serve and let it work the backlog across every registered repository while you do something else.
Click it. Say it. Ship it.
Details that are attached to the actual element on the page, so your agent has the context it needs and you stay in control of how far it goes.
Lands in the right repo
Run jotkit link in a repository and attach comments to it, or keep them global. Each one carries the branch and commit you were on, so it reaches the right agent in the right repo.
You set the limits
Choose per comment how much freedom your agent gets: Read only, Ask, Allow edits, or Auto, which can also run commands like tests. Read only is the default.
Works with your agents
Claude Code, Codex, Cursor, Gemini CLI, Devin and Windsurf pick up your comments over MCP or ACP. Or run jotkit acp serve and walk away: it works the backlog, commits the result and tells you when it's done.
Nothing gets lost
Every comment, claim and outcome is kept on your machine. Agents never touch your comments, two agents can't claim the same one, and any commit an agent reports is checked against git.
Local and private
The extension talks only to the jotkit daemon on your own computer. No account, no subscription, no telemetry, no servers. Your comments and your code never leave the machine.
Questions worth asking.
Is jotkit really free?
Yes. No account, no subscription, no paid tier. It is free to use but it is not open source: the source stays private and the license does not permit redistribution.
Does anything leave my machine?
No. The browser extension only ever connects to the jotkit daemon on 127.0.0.1. There is no backend, no analytics and no sync service. Your comments, page captures and source code stay local.
Which coding agents work with it?
Anything that speaks MCP or ACP. Add jotkit mcp as an MCP server in Claude Code, or point jotkit acp at an ACP agent. Without either, agents can drive the CLI directly.
Do I need the CLI, or is the extension enough?
You need both. The extension is a client for the local daemon that ships with the CLI, so install jotkit first, run jotkit init, then pair the extension with the code it prints.
What if port 4817 is already taken?
jotkit picks the next free port automatically, remembers it, and prints the address it settled on. You can also set an explicit port in ~/.jotkit/config.json.
Can an agent change files without me watching?
Only if you allow it. Unattended runs default to deny-writes. You raise autonomy per comment or per repository, and only a comment you wrote can raise its own.
Jot it down with jotkit and let your agents handle the rest.
One command to install, one to start. Everything stays on your machine.
npm i -g @jotkit/jotkit && jotkit initRead the docs