Deiko memory

Task memory for coding agents from the Deiko Mac app: search past briefs, list tasks and where each stands, read a task's history, and save what the agent did. Local stdio, reads the board on your Mac.

GitHub
2

Documentation

Deiko

Point at it. Say it. Your agent remembers it.

Show your coding agent what you mean by pointing, drawing and talking,
and manage every task's context in a free board that lives on your Mac.
For Claude Code, Cursor, Codex and any MCP agent. Free and open source.

MIT licence Latest release macOS 14 or later CI MCP memory server

Show • Remember • Install • How it works • Privacy • Self-hosting • Contributing

Coding agents have two blind spots. They can't see what you're looking at, so you type paragraphs about a screen they never saw. And they forget: every new chat starts from zero, so you explain Tuesday's work again on Friday. Deiko fixes both, on your Mac.

Show your agent what you mean

The same bug reported two ways: typed out, and shown with Deiko

  1. Double-tap Right Option to start. A red bar shows while Deiko listens.
  2. Point and talk. Rest the cursor on what you mean, or hold Left Option and draw around it. Say what should change, in any language you mix.
  3. Tap Right Option to stop. A coin appears with Deiko's reading of what you said.
  4. Drag the coin onto your agent. The brief is pasted into that chat and sent.

The brief carries the crops, the exact text under your cursor and your words, lined up so the agent knows which "this" you meant. Secrets on screen are redacted; a screenshot that shows a credential is withheld.

Keep every task's context, on your Mac

The Deiko board: briefs grouped into tasks, each with what happened

Every brief is filed into the piece of work it continues, and each task keeps a note of where it stands, what was decided and what each agent reported back. The next brief on that work carries it, so a new chat starts where the last one stopped. It all lives in a free board on your Mac:

  • See and steer it. Every task and brief in one window. Move briefs, answer "Same work?", edit or forget any note, pin project rules, search by meaning, and hand a task off as Markdown.
  • Your agents can use it. The memory server gives MCP agents five tools: search_briefs, list_tasks, get_task, get_brief and save_outcome. One click in Settings connects Claude Code, Codex, Cursor, Gemini CLI, VS Code and Antigravity.
  • Agents report back. When an agent finishes a brief it saves what it did, decided and left open, in any agent. In Claude Code a Stop hook makes sure it does.

More in docs/memory.md.

Install

curl -fsSL https://deiko.app/install.sh | sh

Needs macOS 14 or later on Apple silicon. The script installs the latest release to /Applications and launches it (read it first). A first-run window asks for four permissions and explains each one. For the disk image, updating and uninstalling, see docs/install.md.

[!IMPORTANT] Security note. Deiko asks for Accessibility, Screen Recording, Microphone and Speech Recognition, and captures only while a session runs (a red bar stays on screen the whole time). Screenshots never leave your Mac; your voice goes to Whisper on Groq or stays on-device (details). The app is signed with its own certificate and not yet notarized by Apple, so read the install script before running it, or build from source. Report vulnerabilities privately: SECURITY.md.

How it works

How Deiko works: capture, brief, filing, board and memory server on your Mac; the brief goes to your agent; an optional relay handles transcription and filing

Speech is transcribed by Whisper (through Deiko's relay, or your own Groq key) or by Apple's on-device recogniser. Filing uses a keyword and meaning search on your Mac, then asks Jev which task a brief continues. The pipeline, the memory server and the relay are all in this repository; see docs/architecture.md.

Works with

Any agent you can type to. Drop the coin on its window and the brief is pasted and sent: Claude Code in a terminal or an IDE, Cursor, Codex, or ChatGPT and Claude.ai in the browser. Browser chats can't call tools, so their briefs carry the task's history inline.

Task memory over MCP connects in one click to Claude Code, Codex, Cursor, Gemini CLI, VS Code and Antigravity, and any other MCP client can run the server directly.

Privacy

StoredOnly on your Mac, in ~/Library/Application Support/Deiko. Recordings are deleted once the brief is made.
Sent for processingYour voice to Whisper (Groq), the transcript for a summary, and titles and summaries for filing (Jev via OpenRouter). Nothing is kept.
Never sentScreenshots, OCR and accessibility text, except inside the brief you hand to your own agent.

The relay's code is in this repository, so you can check it, or run your own. Full details: docs/privacy.md.

Pricing

Deiko is free and open source. Every Mac gets two hours of Deiko's hosted transcription a month, with summaries and task filing included; past that it transcribes on-device until the month resets, and your own Groq key works with no limit. Pro is $6.99 a month, $69 a year or $169 once, and raises the hosted transcription to ten hours a month.

Build from source

make setup           # Node dependencies
make signing-setup   # once, so macOS permissions survive rebuilds
make install         # build, sign, install and launch
make test            # Swift and Node test suites

Requires Xcode 26 and Node 22. See CONTRIBUTING.md for the repository layout and conventions.

Contributing

Issues and pull requests are welcome. Start with CONTRIBUTING.md; report security issues privately as described in SECURITY.md.

License

MIT. Bundled third-party components keep their own licences; see NOTICE and apps/macos/licenses.

deiko.app • Changelog • Issues