Captures

Arrives in the next build

The Captures window arrives in the next build. It is not in 2.2.0.

A capture is a picture of your screen with numbered marks on it. Each mark carries a comment. You make one for a coding agent: "this button is wrong", with the button boxed. The agent reads the picture and the comments, numbered the same way.

The update adds Captures to the rail once, right after the to-do list. If it is not there, right-click an empty part of the rail, then Add a widget. See the menu bar.

Taking a capture

Press Capture in the window, or the shortcut from anywhere: Ctrl+Shift+Alt+S, with Cmd in place of Ctrl on macOS. When another app holds that shortcut, the window says so. The Capture button still works.

The screen under the cursor freezes, the windows of Mnemosyne OS included.

1. Drag a region, or press Enter for the whole screen.
2. Draw on it. Each mark gets its number and its comment field.
3. Pick a folder and an agent with the chips.
4. Save, or Save and capture again.

Esc leaves a field, then cancels.

The marks

Key	Mark
R	Box
A	Arrow
N	Numbered pin
T	Note on the picture
1 to 5	Colour of the mark

Ctrl+Z undoes the last mark. Delete removes the chosen one. S draws the region again, as long as there is no mark yet. The wheel zooms, and Space with a drag moves the picture. 0 brings back the whole screen. Ctrl+C copies the picture with its marks.

Press ? for the card of shortcuts. The keyboard button in the window opens the same card.

For which agent

The agent chips list the coding agents that wrote in the last 3 hours. The list comes from their transcripts on disk. Any agent leaves the capture open to all. When you pick one, the capture lands in that agent's inbox as a message.

A mark drawn on a window of Mnemosyne OS also records which window it was on.

The window

• On top: Capture, the shortcut, the rewind switch, and the status filter: All, New, Read, Handled.
• On the left: the folders, with All first. The default folder is Inbox. You create a folder in the capture itself, from the folder chips.
• In the centre: one tile per capture, newest first. A tile shows the marked picture, its status, its number of marks and its agent.
• On the right: the capture you opened.

In the opened capture, you can:

• Edit the title, each comment and the note about the whole capture.
• Change the status, the folder and the agent.
• Copy the picture with its marks, to paste it in a chat or a mail.
• Tick Show without the marks.
• Throw away the capture. It asks for a second click.

A note written on the picture cannot change any more. Its text and the picture would then say two different things.

The capture says who read it, and who handled it and when.

The rewind

The rewind keeps the last 10 seconds of the screen under the cursor, in memory only. A moment that already passed can then be captured and marked. In the capture, ← and → step one frame back or forward. Add Shift to step one second.

The rewind is off at every launch. Turn it on with the switch in the window. It stops by itself when the screen locks, the computer sleeps, or the app closes. The window gives the reason. While it runs, a line shows its frame rate, its memory and its number of frames.

From across the board

Zoom the canvas out and the window becomes a contact sheet of the latest 12 captures. The ones nobody opened yet are outlined. The number of new captures is written large. A click brings the camera back to the window.

Where they live, and how agents read them

Captures are stored under ~/.mnemosyne/captures, one subfolder per capture folder. Each capture there has a plain picture, a Markdown note and a JSON record. A capture with marks also has its marked picture.

An agent reaches them through three doors of the app:

• captures.new lists the captures, by default the ones nobody opened.
• captures.get reads one, with its comments numbered like its marks. It marks the capture read.
• captures.done says the agent handled it, and how.