Omelette
Early beta
Built for coding agent workflows.
Clipboard and screenshot history for working with coding agents, right in your
GNOME top bar.
Omelette is an early beta made mainly for coding agent workflows. Reuse prompts and terminal
output, capture screenshots to share with agents, and keep useful context
within reach as you move between your editor, terminal, and agent conversations.
Save reusable instructions as snippets, annotate screenshots to point
out a bug or UI change, dictate instructions with optional local Voce, and use
Keep awake during long agent runs, and jot things down in a notepad that stays
put between sessions. The command bar also offers a calculator,
quicklinks and emoji.
Everything stays on your machine. No accounts, no sync. Currency conversion is
off by default; Voce only uses the network when you explicitly download a
speech model.
linux/ GNOME Shell extension, GJS / ESM (GNOME 45–49, no build step)
voce/ Optional Whisper dictation backend (GNOME/Wayland, GPL-3.0+)
📸 What it looks like
| GNOME — the command bar | GNOME — history and screenshots |
|---|
| |
Rendered mockups with sample data, not live captures. Layout, strings and
number formatting come from the source; the contents are invented. Built from
docs/mocks/ by docs/build.mjs — see The website.
✨ At a glance
- Clipboard history (text + images)
- Screenshot capture (area / screen)
- Screen color picker (hex)
- Image annotation · arrows · boxes · text
- Keep awake (blocks sleep and blanking)
- Local voice dictation (optional Voce)
- Search · pin · delete
- Pause (incognito)
- Ranked command bar + keyboard nav
- Snippets with placeholders
- Notepad (one persistent scratchpad)
- Calculator · units · dates
- Quicklinks + web search
- Emoji & symbol picker
- Currency conversion (opt-in, network)
- Bluetooth battery gauges · fan speeds
- PDF page extraction (needs poppler)
- Auto-expiry, size caps, settings UI
- Configurable shortcuts
- Password-manager filtering
- Paste injection
Not encrypted at rest — see Storage & privacy.
📦 How to install
Omelette builds from this repo; there are no releases to download.
No build step, but glib-compile-schemas (from libglib2.0-bin) must
compile the bundled GSettings schema once, and again whenever it changes.
glib-compile-schemas "linux/[email protected]/schemas/"
mkdir -p ~/.local/share/gnome-shell/extensions
ln -s "$PWD/linux/[email protected]" ~/.local/share/gnome-shell/extensions/
# X11: Alt+F2 → r → Enter. Wayland: log out and back in.
gnome-extensions enable [email protected]
An omelette skillet icon appears in the top panel. If it doesn't,
gnome-extensions info [email protected] reports the state and the error.
The optional linux/org.dfxe.Omelette.desktop launcher opens preferences and
can be installed with its icon under ~/.local/share/applications and
~/.local/share/icons/hicolor to expose Omelette in the app
drawer.
For private local dictation, build the optional Voce backend after installing
its Ubuntu dependencies:
cd voce
make check test build
make runtime
make install-user
systemctl --user enable --now voce.service
Open voce once to download a Whisper model. Dictation then lives in the
Omelette menu: hold Super+Alt+Space, or toggle with Super+Alt+D.
🐧 GNOME
An omelette skillet icon appears in the top panel. Copy text or an image and it shows up
under Things you copied; PrtScn shots show under Screenshots.
The command bar
The box at the top searches everything at once and ranks the results, each source
under its own heading, focused the moment the popup opens.
| Key | Does |
|---|
↑ ↓ | Move through results, across section boundaries |
Page Up / Page Down | Jump eight rows |
Enter | Activate the selected row |
Esc | Clears the query, then leaves a tool, then closes the popup |
Sections are ordered Answer, Quicklinks, Snippets, Emoji &
symbols, System, Keep awake, PDF, Edit an image, Things you
copied, Screenshots, Notepad — each capped, and
hidden when nothing matches. Ranking is shared by every source: exact beats prefix beats word
boundary beats substring beats loose subsequence (bgcol finds
background-color), and shorter matches win ties.
Activating a row copies it and sends Ctrl+V to the window that had focus
(Ctrl+Shift+V in terminals). If a paste lands somewhere unexpected, raise
Paste delay.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
