π¬ A browser extension and desktop app that turns your clicks into step-by-step guides with annotated screenshots π
TypeScript browser-extensionchrome-extensiondocumentationfirefox-extensionguide-generatorlocal-firstmanifest-v3privacy-firstproductivityreactscreenshotstep-by-step-guidetutorialtypescriptworkflowwxt
docs: describe the most common app, macOS shortcut symbols and the key step chip
Luis Ortizcd21c6e72479
diff --git a/AGENTS.md b/AGENTS.mdindex a04714e..72191b1 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -471,7 +471,16 @@ and then shifted, because the AZERTY number row only gives a digit with Shift. `the dead-key state in an atomic between calls, and `clearDeadKey` zeroes it. The layout calls staysynchronous because Text Input Sources must be read on the main thread, which is where Electron'smain process runs JavaScript. On a Mac, Option is how people type accented letters and symbols, so-`isTextKey` counts an Option key as typing there, and `comboLabel` names the modifiers Cmd and Option.+`isTextKey` counts an Option key as typing there. On a Mac every shortcut Mimik shows is written+with the system's symbols, in its order, `ββ₯β§β`, and no separator: the key steps `comboLabel`+writes, the tips on the recording card and the shortcuts in Settings, all through `shortcutLabel` in+`renderer/lib`, which main imports as well. Control stays `β`, its own key, and only Command,+Super, Meta and `CommandOrControl` become `β`. Elsewhere the names stay as words joined by `+`.+A key step's title draws its shortcut in the same chip the card's tip uses, on the recording card,+in the guide and in the HTML export: `splitAtShortcut` in core finds the step's `keydown:` key in+its title and splits around it, so an AI or hand-written title that still names the key keeps the+chip, and one that does not is plain text. The editor's text field, PDF, Markdown and DOCX stay+plain text.The implementation is `IUIAutomation::ElementFromPoint` and six property reads, plus a walk of thecontrol view when the element has no name. Named elements skip the walk, because every step of it is@@ -1226,7 +1235,7 @@ buttons, where the side panel shows it above Finish, until the next recording st`catch { return null }`, so a rejected key and no network both looked exactly like having no key.`aiFailureKey` and `aiActionKey` moved from the side panel into `capture/ai/errors.ts` for it.-Naming follows the extension. With no key the fallback β the recorded application, or a generic name+Naming follows the extension. With no key the fallback β the application most steps happened in, or a generic namewhere none was identified β is written at once. With one, the guide stays "Untitled guide" underthe shimmer until the descriptions settle and `generateGuideMeta` answers, and the fallback is writtenonly if it returns no title, so the guide always ends up named and never shows an application name@@ -1370,7 +1379,8 @@ that spans a wide window is mostly empty line. Each card is the first step's scrcropped the way the guide shows it β zoomed toward the click on the desktop, around the element inthe extension β then where the guide happened, its title on up to two lines, and its step count anddate, with a star on the picture when it is starred. Where it happened is the most common site among-its steps, with its favicon, or the application the first step names, with the application's own icon; that icon+its steps, with its favicon, or the application most of its steps happened in, counted the same way with ties going to the+earliest (`getMostCommonApp`), with the application's own icon; that iconnever comes from a favicon service, because the request would send the application's name to it. Thedesktop serves it from the operating system instead: a step's `app.id` is the path of the `.app` bundleor `.exe`, `appIconUrl` in the UI env turns it into a `mimik-app-icon:` URL, and main answers with