[Improvement] Default-agent abstraction: omacase agent + launch keybind + shell alias

[splaice]

Quattro feature

Omarchy 4 makes "your coding agent" a first-class default: omarchy default agent <name>, a dedicated launch keybind (Super+Shift+Ctrl+A opens the default agent in its own window), an a terminal alias for inline use, and omarchy agent prompt "<task>" to fire a task directly.

Omacase fit

Omacase ships four agent CLIs (claude, codex, opencode, grok) but no notion of the agent. All the machinery exists: the Ghostty overlay helpers in lib/wm.sh (_ghostty_popup_toggle), the managed zshrc for the alias, OmniWM for a keybind, and completions/menu patterns.

Proposed shape

• omacase agent — show default + status; omacase agent default <name> persists to ~/.config/omacase/agent (seed-once user config, joins _backup_targets)
• omacase agent launch — default agent in a centered Ghostty overlay (same pattern as omacase files); wire an OmniWM keybind through the user-owned settings
• a alias in the managed dot_zshrc → the default agent inline
• omacase agent prompt "<task>" — pass-through to the agent's one-shot mode where the CLI supports it (claude -p, codex exec, …) — capability table per agent
• Completion, menu entry, doctor line (default resolves to an installed CLI)

Notes

This is the prerequisite for crash-capture-to-agent (separate issue). Usage tracking already exists (omacase usage).

🤖 Generated with Claude Code

[splaice]

Implementation plan

Self-contained; needs only this comment and the repo.

Background

Omacase ships four agent CLIs — claude, codex, opencode, grok (Brewfile / self-installers; see lib/install.sh _grok_install, mise config) — with no notion of a default. The building blocks exist: _ghostty_popup_toggle in lib/wm.sh (centered overlay with a pkill argv-marker; used by omacase files), the managed home/dot_zshrc, seed-once config precedent (config/omacase/login-items + _launcher_seed_login_items in lib/launcher.sh), and the extras/menu/completion sync patterns.

Change 1 — lib/agent.sh (new)

Config: ~/.config/omacase/agent — one line, the agent name; seeded from config/omacase/agent (content: claude). Capability table (single source for everything below):

# name|binary|inline-args|oneshot-args
# inline: interactive in current terminal. oneshot: run one prompt and exit.
_AGENTS='claude|claude||-p
codex|codex||exec
opencode|opencode||run
grok|grok||-p'

(Implementer: verify each CLI's one-shot flag against its installed --help before pinning — the table above is the expected shape, not gospel; grok's may differ.)

Subcommands (omacase_agent):

• omacase agent / status: default name, binary found (✓/!), one-shot support.
• omacase agent default <name>: validate against the table + have <binary>, write the config.
• omacase agent launch: default agent in a centered Ghostty overlay via _ghostty_popup_toggle "omacase-agent" "exec <binary>" "<binary>" — reuse the files-popup mechanics including the argv marker rules (source wm.sh).
• omacase agent inline [args…]: exec the default agent in the current terminal (this is what the alias calls).
• omacase agent prompt "<task>": one-shot via the table's oneshot-args; abort with a clear message if the default agent has none.

Change 2 — wiring

• bin/omacase: usage line + agent) dispatch.
• home/dot_zshrc: a() { omacase agent inline "$@"; } (function not alias, so args pass through).
• Keybind: document in KEYBINDS.md how to bind e.g. Super+A to omacase agent launch via OmniWM's user-owned settings (Omacase does not write OmniWM keybinds — respect the existing ownership boundary stated in the repo).
• completions/_omacase: agent subcommand; second arg default|launch|inline|prompt|status; third arg for default = names parsed from _AGENTS in lib/agent.sh at completion time (webapps precedent in _omacase).
• lib/menu.sh: "Launch agent" entry → omacase agent launch.
• lib/doctor.sh: one line — default agent configured and its binary present.
• Backup: add ~/.config/omacase/agent to _backup_targets (it is user config).

Change 3 — tests

1. Table/handler sync: every _AGENTS name validates (omacase agent default <name> accepts each when binary shimmed present; rejects nosuch).
2. Seed: temp HOME → config seeded once, not overwritten.
3. prompt arg construction: shim the agent binary recording argv; omacase agent prompt "fix the bug" → recorded argv matches the table's oneshot form.
4. Wiring greps: usage/completion/menu contain agent (same style as extras wiring tests).

Verification / done criteria

Suite green; shellcheck + zsh -n clean. Live: omacase agent default claude, a in a new shell opens claude inline, omacase agent launch toggles a centered overlay (open AND close — the marker), omacase agent prompt "say hi" returns a response.

Branch + PR; body says Closes #22. Land before #24/#25 (both consume the default).