IMG_2041.jpg
button.buy “Buy”↑↓Buy⇧⌘A
Point
Press ⇧⌘A, then click an element, drag an area or ⌥ a line of text. Aki reads what is under your mark.
Show your AI agent exactly what to fix.
Point at anything on your Mac. Aki sends the exact text and element to the right agent session — a picture only when it helps, so it spends fewer tokens.
Or install from Terminal
$ curl -fsSL https://aki-updates.vercel.app/aki-install.sh | shWorks with
ChromeSafariArcFirefoxFigmaXcodeVS CodeCursorZedGhosttyiTerm2WarpNotionSlackLinearClaude CodeCodexGemini CLI
Aki, running on a Mac
←→space
Hover and the element lights up with its selector. The arrows walk the screen; ⌘↑ makes it bigger, ⌘↓ smaller.
Works with the agents you already use, in any terminal or editor
Claude CodeCodexCursorGemini CLIOpenCodeGrok
OrcaGhosttyiTerm2WarpTerminalVS CodeZed
Many agents at once
Running five agents at once?
Every note lands in the right terminal. A page on localhost goes to the worktree serving that port; anything else goes to the ring you pick. No copy-paste, no “wait, which tab was that?”
One project at a time? You still stop describing UI in words.
Three steps. Zero explaining.
Queue· 3
1Center it and make it huge
2Use the product render here✎×
3Blue pill, like the store
Say it
Type what should change. Queue as many marks as you like; edit or remove any of them.
⏺ aki · read_annotations 3 pending for ~/halo ⏺ Update(src/halo/Hero.tsx) ✓ resolve_annotation 1, 2, 3
Send
⌘⏎. Your agent reads it over MCP, fixes it and marks each one resolved.
Everything it does. All on your Mac.
123456
Any app
Browsers, Finder, Figma, Xcode, terminals. If it is on your screen, you can mark it.
Save
button.btn.primary “Save”↑↓selectortextHTMLReact file
Chrome, Brave, Edge, Arc — no extension
Aki asks the page what is under your mark: the exact element, a unique selector, its text and HTML — even the React component’s file in dev builds.
localhost:3000haloapidocs
The right session, by itself
A page on localhost belongs to a project. Aki sends the marks to the agent session working on it.
Send to the terminal now 54321
Your agent wakes up
Seconds after you send, the agent picks your marks up on its own. No copy, no paste.
section.hero
div.ctas
button.buy
↑↓←→
Walk the screen with the arrows
↑ ↓ ← → go to the next thing above, below or beside. ⇧ with an arrow adds it to the mark. ⌘↑ takes what’s around it, ⌘↓ goes back inside, down to CSS ::after arrows. ⏎ marks what’s outlined.
Text readSave changesCrop
Text → text onlyText first, a picture when it helps
Each mark sends the text it covers; a small picture goes along only when what you marked is visual. A screenshot can cost over a thousand tokens — the text in it, a few dozen.
haloClaude CodeContext5hWeek
A ring for every session
One ring per agent session, grouped by project: working, waiting for you, marks pending, context and usage limits. Click one to mark for that session.
🕘Aki History⚙︎Aki Settings▤Toggle Aki Sidebar
Raycast, Alfred and Spotlight
Start marking from your launcher. Aki adds its own Raycast commands, and each one can get its own hotkey.
Light, dark, your accent
Follows your Mac’s appearance live, with Aki’s red, your Mac’s accent or the system colour.
127.0.0.1~/.akiStored on your Mac
The server runs inside the app, on 127.0.0.1. Your marks are stored on your Mac and go only to the agent you choose.
$ aki list 3 marks for ~/halo $ aki wait … $ aki done aki_17…ab12
MCP and the aki command
Agents read, wait for and resolve your marks over MCP, or with aki list, aki wait and aki done.
Center it and make it huge8 KBUse the product render here64 KBBlue pill, like the store6 KB⇧⌘H
History that cleans up
⇧⌘H shows everything you marked and its size. Done marks and old pictures go away on their own, and updates install themselves.
menu stays open
Marks without stealing focus
Like ⌘⇧4: the app below keeps its focus. An open menu stays open, a selection stays selected. Hold ⇧ to use the page below; let go and Aki is back.
Copied · ⌘V pastes itIssue #42Button looks off here
The crop is on your clipboard
Each mark’s picture also goes to the clipboard, so ⌘V pastes it anywhere: a chat, a doc, an issue. Settings turns it off.
Why not just send a screenshot?
Without Akiscreenshot → ⌘Tab → paste → explain
⇧⌘4drag a screenshot⌘Tabfind the right session⌘Vexplain it in wordswrong session?again
Time
~2 min
Tokens
~1,600 per screenshot
With Akipoint → type → ⌘⏎
⇧⌘Aclick ittype what should change⌘⏎right session ✓
Time
~10 s
Tokens
~40 for the text
 Aki |    Screenshot apps | Screen recording | Copying from DevTools |    Element pickers installed in your app | ⧉Browser annotation extensions | ▣Design modes inside an app | |
|---|---|---|---|---|---|---|---|
| Your agent gets the exact element | |||||||
| Your agent reads it directly, no pasting | |||||||
| Works in any app, not only a browser | |||||||
| Many marks in one message | |||||||
| Goes to the right agent session on its own | |||||||
| Nothing to install in your project | |||||||
| Keeps the editor and terminal you use | |||||||
| Stays on your Mac | |||||||
| Score | 8 | 4.5 | 4 | 4.5 | 3.5 | 6 | 4.5 |
yespartlyno
Examples are popular tools in each group; features vary by tool and version.
FSL-1.1-ALv2
Free to use. FSL licensed.
Free to use under FSL-1.1-ALv2. The license permits use and modification, restricts defined competing uses, and grants Apache-2.0 after two years for each version. See the license supplied with your version.
Source on GitHubHelp the project
Voluntary support for Aki, without a purchase, subscription or promised benefit.
Continue to PayPal. Available cards, currencies, account requirements and fees depend on PayPal and your country. Aki does not receive your card details.
Continue to PayPal soon—Network: —
—USDT on TRON (TRC20) only. Check the network and recipient: transfers may be irreversible, and the transaction is public.
FAQ
Good questions.
What do I need to run it?
A Mac with Apple Silicon on macOS 14 or later, and a coding agent that speaks MCP, like Claude Code or Codex.
Which agents does it work with?
Claude Code and Codex connect in one click (Settings → Agents). Any agent that speaks MCP can read your marks. It runs alongside whatever you use: Orca, Ghostty, iTerm2, Warp, Terminal, or the terminal inside VS Code, Cursor or Zed.
Do I need a browser extension?
No. Aki works over any app. In Chrome it reads the element under your mark through Apple Events (turn on “Allow JavaScript from Apple Events” once). An extension comes later, for what that cannot reach.
How does it know which agent gets my marks?
Each agent session is a ring on the sidebar, grouped by project. A page on localhost goes to the session working on that project. Anything else goes to the session you picked, or the last one you used.
Does anything leave my computer?
Aki stores marks on your Mac and shares them with your chosen agent over local MCP. That agent may send content to its AI provider. Updates and downloads contact external services.
How much does it cost?
Free to use under FSL-1.1-ALv2. The license permits use and modification, restricts defined competing uses, and grants Apache-2.0 after two years for each version. See the license supplied with your version.
Why “Aki”?
It sounds like “aqui”, Portuguese for “here”. Which is exactly what you say when you point at something.
Coming soon for macOS
Stop describing. Start pointing.
Or install from Terminal
$ curl -fsSL https://aki-updates.vercel.app/aki-install.sh | shClick anywhere here.