Ask Claude Code or Codex questions in a desktop overlay.
Good to know
Closing a conversation discards Ask's text and session; agent-owned logs may remain. `ASK_CWD` defaults to the home directory.
Get it on GitHub
Unclaimed
Are you @clickety-clacks?Claim this page to keep it up to date
This page was written by 
Are you @clickety-clacks?Claim this page to keep it up to date
Talk to Claude Code or Codex, launch applications, and find files, windows, repositories, and agents from one prompt.
What you can do with Omarchy Ask
Keep independent agent conversations open in resizable windows.
Good to know
Each window has its own session; closing it ends that session.
Approve or deny agent tool requests, or opt into automatic approvals.
Good to know
YOLO only selects an allow option offered by the agent; it does not change the agent's sandbox.
Launch applications and run Omarchy menu actions from the prompt.
1 other tool for launch appsGood to know
`Return` sends a chat prompt unless a result is deliberately selected; `searchDebounceMs` defaults to 270 ms.
Resize conversation text and tune scrolling while reading streamed replies.
Good to know
Text size and motion settings are shared across conversations and saved across restarts.
Find files and Git repositories, open or edit them, reveal folders, and copy paths.
1 other tool for find filesGood to know
Search defaults to the home directory; repository discovery defaults to six levels. Focused results retain up to 100 files or repositories.
Find open windows and switch to them from the prompt.
2 other tools for switch windowsGood to know
Focused window search retains up to 40 windows.
Calculate expressions and unit conversions and copy the answer.
1 other tool for calculateGood to know
Results depend on a recognized calculation in the query.
Show all 18
Use Ask keyboard shortcuts that overlap desktop bindings.
Good to know
Shortcut precedence requires Hyprland 0.56.2 commit efb50993780079460b0cbed1363e2166a2de1d9f and matching build dependencies; other environments retain system-shortcut precedence.
Choose the coding agent, model and thinking level for new conversations.
Good to know
Model access depends on the installed agent and account; existing sessions keep their selection.
Send a correction while a Codex turn is still running.
Good to know
Only enabled when the ACP agent advertises steering support.
Start a new agent session after a connection failure while keeping previous text visible.
Good to know
Previous conversation text is not replayed to the new agent.
Choose custom commands for launching the bridge and ACP adapter.
Good to know
Commands must be JSON argv arrays; the adapter must support the selected agent protocol.
Receive desktop attention when an unfocused pinned conversation finishes a reply.
Good to know
Uses native window urgency; display depends on the compositor or an optional attention service.
Find Agentd Hub agents and open their existing window or tmux session.
Good to know
Requires a configured Hub and Python 3; terminal attachment needs Ghostty and tmux. Existing-window resolution can be inconclusive for roaming mosh connections.
Open remote agent tmux sessions over Eternal Terminal, mosh or SSH.
Good to know
Install the chosen client; Eternal Terminal also needs remote `etserver`. Host reachability checks are cached for a week.
Paste images into agent prompts and retain their thumbnails beside the submitted text.
Good to know
PNG, JPEG, GIF and WebP only; 5 MiB per image and 20 MiB per draft. No resizing or conversion; wait for the reply before another image paste.
Find and present windows on a Scottland desktop.
Good to know
Requires the Wayfire IPC socket; shortcut precedence remains native. Window presentation falls back to focus if the presentation request is unsupported.
Before you upgrade Omarchy Ask
Newest firstInstall `wl-paste` (provided by wl-clipboard) if it is unavailable; image clipboard reading invokes it.
Read the evidence
Ensure `python3` is installed for agent-to-window discovery; the bundled resolver uses the host Python runtime.
Read the evidence
Matching files now sort newest-modified first in mixed results and `@` file search.
Read the evidence
Show 10 older
Mixed results now show category counts, Go matches and balanced examples; single-match categories show their item directly. Ask also adds a desktop menu entry.
Use `Ctrl+,` for the unified settings window instead of `Super+,`; agent choices apply immediately to new conversations. The window also contains Hub configuration and scroll tuning.
Read the evidence
`Ctrl+,` now opens a movable settings window containing the scroll-motion curve instead of the separate motion editor; the overlay returns after settings close.
Read the evidence
`useHyprlandShortcutSubmap` is ignored and Ask no longer enters or resets modal submaps. Automatic module loading reserves only Ask shortcuts; without support, system bindings win conflicts.
Restart Omarchy Shell after updating. For shortcut precedence, provide the supported Hyprland build, matching development headers, Node, make, pkg-config and a C++23 compiler; otherwise system conflicts take precedence.
Application matches now appear before menu, file, repository and window results.
Read the evidence
Ensure system `codex` or `claude` is installed on `PATH` and authenticated, or set `CODEX_PATH` or `CLAUDE_CODE_EXECUTABLE`; bundled-harness fallback is no longer used.
Read the evidence
Without a saved Ask override, new sessions follow Omarchy's Default Agent and its model/thinking settings instead of always defaulting to Claude.
Read the evidence
Pinned windows now leave borders, rounding and clipping to Hyprland; overlays retain their themed frame.
Read the evidence
Outside-click dismissal waits 750 ms after keyboard activity, reducing accidental overlay closure while typing.
Read the evidence
Omarchy Ask release history 4
Find agents through an Agentd Hub and open their local or remote terminal sessions.
Details
`&` searches Hub agents; remote tmux sessions open in Ghostty using configurable `et`, `mosh` or `ssh` transport. This release also adds image paste and transcript thumbnails, streaming file search, and a settings window on `Ctrl+,`.
Also: Paste images into chat, search files as results arrive, use unified settings and switch to windows on Scottland.
Available in v0.8.0; update the plugin, run `npm ci` in `bridge`, then restart Omarchy Shell. Hub agents need Python 3; remote attachment needs Ghostty, tmux and the chosen transport. Eternal Terminal needs `etserver` on the remote host.
Added: Find Agentd Hub agents and open their existing wind…Added: Open remote agent tmux sessions over Eternal Termin…Added: Paste images into agent prompts and retain their th…Action required / inferred: Paste images into agent prompts and retain their th…Action required: Find Agentd Hub agents and open their existing wind…Improved: Find files and Git repositories, open or edit them,…Behavior changed: Find files and Git repositories, open or edit them,…Behavior changed / inferred: Launch applications and run Omarchy menu actions fr…Behavior changed: Choose the coding agent, model and thinking level f…Behavior changed: Resize conversation text and tune scrolling while r…Behavior changed / inferred: Use Ask keyboard shortcuts that overlap desktop bin…Action required: Use Ask keyboard shortcuts that overlap desktop bin…Added / inferred: Find and present windows on a Scottland desktop.
Seeded by @iluxav with Codex
Read the evidence
- clickety-clacks/omarchy-ask/blob/v0.8.0/README.md
- clickety-clacks/omarchy-ask/blob/v0.8.0/docs/agent-search.md
- clickety-clacks/omarchy-ask/blob/v0.8.0/bridge/image-paste.js
- clickety-clacks/omarchy-ask/blob/v0.8.0/MenuSearch.qml
- clickety-clacks/omarchy-ask/blob/v0.8.0/Ask.qml
- clickety-clacks/omarchy-ask/blob/v0.8.0/releases/0.8.0.md
- clickety-clacks/omarchy-ask/blob/v0.8.0/ShortcutRuntime.qml
- clickety-clacks/omarchy-ask/blob/v0.8.0/docs/shortcut-module.md
- clickety-clacks/omarchy-ask/blob/v0.8.0/bridge/compositor.js
- clickety-clacks/omarchy-ask/blob/v0.8.0/ShortcutPlatform.js
Find and launch installed applications again on Omarchy 4.0.4.
Details
Application search and launching now work when the scoped overlay API does not supply the shared app library. Application matches appear before menu, file, repository and window results.
Available in v0.7.1; update the Omarchy plugin and restart the shell. The README reports verification on Omarchy 4.0.4-1.
Now works: Launch applications and run Omarchy menu actions fr…Behavior changed: Launch applications and run Omarchy menu actions fr…
Seeded by @iluxav with Codex
Read the evidence
v0.7.0
with v0.6.1, v0.6.2
with v0.6.1, v0.6.2
Choose the agent, model and thinking level for new conversations without changing existing sessions.
Details
`Super+,` opens the saved agent/model selector; without an override Ask follows Omarchy's Default Agent. The release group also adds ACP steering and fixes reply-completion attention for unfocused pinned windows.
Also: Steer active Codex turns, recover failed sessions, customize launch commands and receive native pinned-window attention.
v0.7.0 requires a working system Codex or Claude executable and login. Update the plugin, run `npm ci` in its bridge directory and restart Omarchy Shell.
Added: Choose the coding agent, model and thinking level f…Action required / inferred: Ask Claude Code or Codex questions in a desktop ove…Behavior changed: Ask Claude Code or Codex questions in a desktop ove…Added: Send a correction while a Codex turn is still runni…Added: Start a new agent session after a connection failur…Added: Choose custom commands for launching the bridge and…Added: Receive desktop attention when an unfocused pinned…Behavior changed: Keep independent agent conversations open in resiza…Now works / inferred: Launch applications and run Omarchy menu actions fr…Behavior changed / inferred: Ask Claude Code or Codex questions in a desktop ove…
Seeded by @iluxav with Codex
Ask Claude Code or Codex questions from a desktop overlay while keeping separate conversations open in pinned windows.
Details
The first release group adds ephemeral ACP conversations and pinned windows, then menu search and universal search with `@`, `^` and `%` modes. `Ctrl+P` pins a conversation; from v0.3.0 pinned windows close through the window manager instead of `Escape`.
Also: Search apps, menu actions, files, repositories and windows; copy calculation results; adjust text size and scrolling.
Available through v0.6.0 as an Omarchy plugin; requires Quattro 4.0.0+, Quickshell-based Omarchy Shell, Node.js, npm and an authenticated Claude Code or Codex agent. Install bridge dependencies with `npm ci`.
Added: Ask Claude Code or Codex questions in a desktop ove…Added: Keep independent agent conversations open in resiza…Added: Approve or deny agent tool requests, or opt into au…Added: Launch applications and run Omarchy menu actions fr…Added: Resize conversation text and tune scrolling while r…Added: Find files and Git repositories, open or edit them,…Added: Find open windows and switch to them from the promp…Added: Calculate expressions and unit conversions and copy…Added / inferred: Use Ask keyboard shortcuts that overlap desktop bin…
Seeded by @iluxav with Codex