Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/checks.yml
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ jobs:
run: |
pacman -Syu --noconfirm --needed git base-devel e2fsprogs zstd lz4 openssl \
python python-dbus python-gobject dbus nodejs dtc cpio file jq busybox \
xz gzip qt6-declarative qt6-svg shellcheck rsync android-tools
xz gzip qt6-declarative qt6-svg quickshell shellcheck rsync android-tools
# Arch's nodejs can lag a simdjson soname bump: on 2026-10-29
# simdjson 5.0.8 dropped the libsimdjson.so.34 that nodejs still
# linked, and node no longer started. Only while node can't start,
Expand Down
24 changes: 24 additions & 0 deletions docs/review-evidence/apps-search/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
<!-- SPDX-License-Identifier: MIT -->
# Native app Search previews

These are actual rendered production Search component captures using genuine
Omarchy Commons/UI modules and neutral fictional applications. The top search
row and compact borderless results follow the phone implementation. Icons are
original MIT-licensed SVG test fixtures; no private application catalog,
wallpaper, account, widget or conversation is included.

The 420 x 580 captures show a reduced available viewport, as when a keyboard
reserves part of the screen. They are not full-device screenshots and do not
render or simulate a keyboard. Actual viewport geometry and light/dark themes
are exercised. Neutral geometric scenery sits behind the translucent component.
It demonstrates the tint; offscreen rendering does not execute compositor blur.

The animation contains 67 actual captures spanning 2327 ms,
encoded losslessly as animated WebP with original capture intervals (plus the
median interval for the final frame). Identical frames may be merged by the
encoder. There are no interpolated frames; this is not a phone FPS benchmark.
Input, filtering, Return activation and closing run against the actual component.

Native layer focus, touch typing, physical Back/Home gestures, lock/unlock,
compositor blur and frame pacing still need exact-package device acceptance.
The public source retains Omarchy attribution and existing licenses.
Binary file added docs/review-evidence/apps-search/search-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/review-evidence/apps-search/search-flow.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/review-evidence/apps-search/search-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
29 changes: 29 additions & 0 deletions docs/review-evidence/search-agent/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
<!-- SPDX-License-Identifier: MIT -->
# Native Search: Ask Agent previews

Actual rendered production QML components using genuine Omarchy Commons/UI
modules, neutral theme scenery and fictional app/conversation fixtures.
No private phone capture, account, prompt history, wallpaper or widget is used.
The selected Codex name in this fixture demonstrates one configured agent;
the UI label follows the actual default agent in normal use.

The Ask card opens a conversation with an editable draft. The recording then
clicks the actual Send control, supplies neutral reply events to the actual
controller and returns to Search using Back. This preview transport is inert;
no model, network, credentials or agent CLI is invoked by the visual harness.
The separate integration fixture connects the real QML/Python transport to an
inert CLI to exercise the functional protocol.

Portrait previews use a 420 x 580 available viewport; landscape is 740 x 320.
No keyboard is drawn or simulated. The tint is rendered over neutral scenery;
o compositor blur or physical phone interaction is qualified here.

The lossless animated WebP is encoded from106actual captures spanning3977ms,
with the original intervals and a median interval for the final frame
(total4014ms). The encoder merges identical frames into28encoded frames.
No interpolated frames, physical FPS or measured compositor smoothness is
claimed. Existing source attribution and licenses remain intact.

The compact 320 x 320 preview includes the responsive control-width correction.
Buttons can shrink and elide long labels instead of expanding the composer
beyond its viewport. The full accessible button name remains available.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/review-evidence/search-agent/ask-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/review-evidence/search-agent/reply-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/review-evidence/search-agent/reply-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
20 changes: 20 additions & 0 deletions packages/omamobile-shell/LICENSE.omarchy
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
Copyright (c) David Heinemeier Hansson

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
2 changes: 1 addition & 1 deletion packages/omamobile-shell/PKGBUILD
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ depends=(omarchy omamobile-apps 'omamobile-omarchy>=0.1.11' 'omamobile-owl-widge
dnsmasq # the Hotspot tile: NetworkManager's shared mode hands out addresses with it
foot xdg-terminal-exec # guard for hand-built/partial installations
xdg-desktop-portal-gnome) # the file chooser (portal/hyprland-portals.conf)
checkdepends=(nodejs) # test/weather.py runs HomeModel.js under node
checkdepends=(nodejs quickshell) # test/weather.py runs HomeModel.js under node
optdepends=('fprintd: fingerprint setup and unlock (with omamobile-fingerprint)'
'omamobile-voice: the speech model for voice input, so Voxtype works with no download (the root image has it)'
'voxtype-bin: voice input (the root image has it; or Install > AI > Dictation)')
Expand Down
104 changes: 103 additions & 1 deletion packages/omamobile-shell/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Omarchy Mobile's phone profile for Omarchy's own shell. It isn't a fork: these a
| --- | --- |
| `plugins/omamobile.bar` | Phone status bar (a full `bar` plugin) |
| `plugins/omamobile.quicksettings` | Pull-down quick settings |
| `plugins/omamobile.launcher` | Home bar: app search, app grid and a prompt to the user's Omarchy default agent; over an app, the home pill in a 44 px strip that reserves its height, so apps end above it (as on Android it is just the pill: double-tap for the keyboard, hold for the voice bar) |
| `plugins/omamobile.launcher` | Home bar: a separate native app-search view on tap; App Library and the existing optional agent flow on swipe; over an app, the home pill in a 44 px strip that reserves its height, so apps end above it (as on Android it is just the pill: double-tap for the keyboard, hold for the voice bar) |
| `plugins/omamobile.switcher` | Recent apps: swipe up on the dock, or swipe up and hold on the home pill over an app; hold a card to show the app with another one, or give it its own screen again |
| `plugins/omamobile.home` | Home screens: pages of apps and widgets on the wallpaper, with an edit mode. The built-ins include every widget in Simon Schubert's [omarchy-widgets](https://github.com/SimonSchubert/omarchy-widgets) `widgets/simonschubert/` (MIT): the OWL originals, from the `omamobile-owl-widgets` package, run by our own OWL runtime (`owl/`, see `owl/SPEC-NOTES.md`). `widgets/OWL.md` is his OWL language guide (MIT, `widgets/LICENSE-owl-guide`) |
| `plugins/omamobile.keyboard` | The on-screen keyboard's show and hide calls, for the home pill (double-tap it), the keyboard's Hide key and scripts; a keyboard shown by hand goes away when the home screen comes up; the language sheet for the keyboard's globe key |
Expand Down Expand Up @@ -102,3 +102,105 @@ Open, save and choose-a-folder requests through the portal (Qt, GTK, Electron an
The package contract follows omarchy-mac's: `./install DESTDIR` stages files and enables nothing, `test/all` runs the package's own tests, and `version` holds the version.

Develop on a desktop with `phone/dev/run-desktop` from the repo root.

## Native app Search

A tap on the home search field opens app search directly. Swiping up still
opens the App Library and its existing optional agent flow. Set the launcher's
`nativeSearch` setting to `false` to retain the previous dock-tap behavior.
Search uses Omarchy's application library and normal app-launch command. It
does not index files, select an agent or access accounts.

The view follows Commons palette, font, spacing, controls and corner settings;
its animation follows `Style.duration` when available. A full-screen background
takes no input, the content respects the status/keyboard reservations, and the
existing Home strip remains visible even after manually hiding the keyboard.
Back closes Search in process before the usual Escape fallback. Home and app
activation release its text input before changing screens.

Native focus is briefly primed with Exclusive, then released to OnDemand, using
the focus lifecycle from Omarchy's MIT-licensed `shell/Ui/KeyboardPanel.qml`.
That component is present in both supported Omarchy package families. Its
David Heinemeier Hansson copyright and license are retained in
`LICENSE.omarchy`. Offscreen component tests verify cancellation and focus
intent; a phone acceptance must separately verify first-tap OSK activation,
keyboard touches, Back/Home, immediate reopen and lock interaction.

Native Search cancels pending focus and closes when the launcher's existing session-lock observation reports locked. Unlocking never reopens it without a new explicit tap. This observation is asynchronous and is not a security boundary or a replacement for the compositor lock protocol. Existing fullscreen exclusion of Home/Back gesture strips remains in force; a Search opened over fullscreen can still close using its visible close button or Escape. The Search panels currently use Quickshell's default output; multi-output active-screen routing is not qualified by the offscreen tests.

### Search presentation

Search retains the phone layout: the query row stays at the top, followed by
three suggested apps, or matching results while typing. App rows have icons,
names and descriptions without an enclosing border. Colors, font family and
size, spacing, control borders, corner rounding and motion follow Commons.
The theme background is painted once as a translucent tint over the underlying
screen. No wallpaper is copied or sampled by the client.

Themes can set `[controls]` keys `mobile-search-backdrop-alpha` (default 0.92)
and `mobile-search-card-alpha` (default 0.94) in `shell.toml`. Values are clamped
by Omarchy's alpha-token API; setting both to 1 gives opaque surfaces. Existing
`[style]` overrides are also read by Omarchy. Older hosts without the alpha API
use the defaults. Rounding follows the configured Hyprland/theme value; Search
does not impose capsules or a minimum corner radius.

Optional compositor blur can be scoped to the Search background only, when
blur is already enabled in the user's compositor configuration:

```lua
hl.layer_rule({
name = "omamobile-app-search-glass",
match = { namespace = "^omamobile-app-search-background$" },
blur = true,
ignore_alpha = 0.05,
xray = false,
})
```

This example does not change global blur settings. Search remains usable
without blur. Component previews show translucency over neutral test scenery;
they do not execute or qualify compositor blur, a real keyboard or phone frame
pacing.

## Ask Agent in native Search

The Ask card opens an in-place conversation with the configured default agent.
Search text becomes an editable draft; only Send or Ctrl+Enter submits it.
Back returns to app search. Home and close dismiss Search; both dismissal and
locking cancel an active request. An idle local bridge retains the conversation
in memory, without polling or running the agent while hidden. New chat resets
it. Changing provider or the selected account home starts a fresh conversation.

The first native adapter supports an already installed Codex CLI. Its existing
login, account selection, model/configuration and approval policy are retained;
commands use the workspace-write sandbox. Other configured agents have an
explicit terminal handoff, using the existing Omarchy route. No provider is
selected or installed automatically. This contribution adds no account/login
store, microphone facade, dictation runtime or custom user configuration.

The backend's JSONL protocol carries literal messages over stdin, never shell
command text. Request identities, reset acknowledgements and cancellation are
bound to the owning process. A cancelled follow-up retains the last completed
conversation; stale output cannot populate a later request. A stopped local
bridge can be restarted through explicit conversation entry or New chat before
another Send. Helper stderr and tool events are never copied into the UI or a
new log. Assistant content is displayed as plain text.

Task artifacts remain in private per-session workspaces under
`${XDG_STATE_HOME:-~/.local/state}/omamobile/agent-chat/`; shutdown removes only
empty workspace directories. Normal CLI session storage remains the CLI's own.
The bridge does not create another transcript or copy credentials. Inputs,
output framing and request time are bounded; failures remain visible without
weakening sandbox or approval settings. The current request deadline is 180
seconds and the composer accepts at most 8,192 UTF-16 code units.

Protocol reference: [Codex non-interactive execution](https://learn.chatgpt.com/docs/non-interactive-mode).
Native adapters for additional agents require their own verified protocol and
sandbox/approval handling. Do not infer support from an installed executable.

`test/agent-chat.py` runs real subprocess fixtures against inert temporary CLIs.
`test/agent-chat-ui.py` connects the actual QML controller to the real Python
bridge with an inert CLI, including resume, account changes, reset and transport
recovery. CI installs Quickshell so that integration runs there; environments
without it report an explicit skip. These checks make no cloud requests and
are not phone keyboard, touch, compositor or frame-pacing qualification.
8 changes: 8 additions & 0 deletions packages/omamobile-shell/bin/omamobile-agent-chat
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
#!/usr/bin/python3
# SPDX-License-Identifier: MIT
import sys
from pathlib import Path
source = Path(__file__).resolve().parent.parent/'lib'
sys.path.insert(0, str(source if (source/'agent_chat.py').is_file() else Path('/usr/lib/omamobile-shell')))
from agent_chat import main
raise SystemExit(main())
2 changes: 2 additions & 0 deletions packages/omamobile-shell/install
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ destination=${1:?Usage: ./install DESTDIR}
for program in bin/*; do
install -Dm755 "$program" "$destination/usr/bin/${program#bin/}"
done
install -Dm644 lib/agent_chat.py "$destination/usr/lib/omamobile-shell/agent_chat.py"
while IFS= read -r -d '' file; do
install -Dm644 "$file" "$destination/usr/share/omamobile/shell/$file"
done < <(find plugins profile hypr branding -type f -print0)
Expand Down Expand Up @@ -70,6 +71,7 @@ install -Dm644 applications/omamobile-agent.desktop "$destination/usr/share/appl
install -Dm644 applications/omamobile-open-intent.desktop "$destination/usr/share/applications/omamobile-open-intent.desktop"
install -Dm644 applications/omamobile-update.desktop "$destination/usr/share/applications/omamobile-update.desktop"
install -Dm644 LICENSE "$destination/usr/share/licenses/omamobile-shell/LICENSE"
install -Dm644 LICENSE.omarchy "$destination/usr/share/licenses/omamobile-shell/LICENSE.omarchy"
# OWL.md is Simon Schubert's OWL guide (MIT). The built-in widgets themselves
# come from omamobile-owl-widgets, which ships the store's licence.
install -Dm644 widgets/LICENSE-owl-guide "$destination/usr/share/licenses/omamobile-shell/LICENSE-owl-guide"
Expand Down
Loading