Aki

Project intro

Aki is a free Mac sidebar for people who run several AI coding agents at once. The author's problem was concrete: with more than ten Claude Code sessions running in parallel, one per feature in its own git worktree, the fixes were fast but explaining where to fix was slow — screenshot, paste, describe the button, switch tab, wrong tab. Aki turns that into point, say it, send: press Shift-Cmd-A, click an element, drag an area or hold Option for a line of text, type what should change, and press Cmd-Return. The note lands in the right agent session with the exact element — a unique CSS selector, its text and HTML, even the React component's file in dev builds — over a local MCP server (read_annotations, wait_for_annotations, get_annotation_image, resolve_annotation) or the aki command, and the agent fixes it and marks each one resolved. Routing is automatic: a page on localhost belongs to the session serving that port, found via its process, folder and worktree; anything else goes to the session picked in the sidebar. Each mark is text first, with a small crop only when what was marked is visual, so the agent spends tokens on the fix instead of reading a full screenshot. The same sidebar shows one ring per session — working, waiting for you, marks pending — plus weekly Claude and Codex limit meters with pace, tokens and cost at API prices, and a screenshot-cleanup tool that moves old screenshots to the Trash. It works with Claude Code, Codex, Gemini CLI, Cursor, OpenCode and anything that speaks MCP, across Chrome, Brave, Edge, Arc, Finder, Figma, Xcode and terminals. It is native Swift (SwiftPM, no Xcode project) with a small HTTP server only on 127.0.0.1, marks stored on the Mac in ~/.aki, no account, free under FSL-1.1-ALv2, installed with one curl command or a DMG. Honest limits, as the author states them: Apple Silicon and macOS 14 or later only; Aki types the request into the session by itself in the Orca terminal, while other terminals pick marks up via MCP or 'aki wait'; and it is young, so expect rough edges. The demo URL is the product site (a Mac app, not a web app): the site itself is interactive and lets visitors mark the page, and the app is installed from it.