omarchy/docs/ai/README.md

AI agents

The shared agent skill library, a local free-tier LLM router, and the shell entry points for coding agents.

The repo manages the agent skill library only. Claude Code (~/.claude) and omp (~/.omp) configs are not in this repo. omp, opencode, and crush are global mise tools (packages.shared.mise, installed by 15-tools) and are updated by topgrade's mise upgrade; no other agent CLI is installed by chezmoi.

• Skills: Every agent skill in prdlk/skills, installed into ~/.agents/skills and ~/.claude/skills by an apply script.
• free-router: The freellmapi router on localhost:9876 as a systemd user service, with FREE_ROUTER_API_KEY exported to every shell.

Pages

Page	Source in repo	Target in $HOME	Covers
Skills	.chezmoidata/skills.yaml, .chezmoiscripts/run_onchange_after_25-skills.sh.tmpl	~/.agents/skills/, ~/.claude/skills/	The prdlk/skills source and skill list; installed by the Skills CLI, not vendored
free-router	dot_config/free-router/env, dot_local/bin/executable_free-router, dot_config/systemd/user/free-router.service, .chezmoiexternals/freellmapi.toml	~/.config/free-router/env, ~/.local/bin/free-router, ~/.local/share/freellmapi	freellmapi under Bun on localhost:9876, the pinned API key, the service, updates

Shell entry points

• ai (fish function) opens a gum choose picker over claude, opencode, codex, hermes, and fractal. Picking claude runs claude --dangerously-skip-permissions; the others run the binary of the same name. See fish.
• Ctrl A runs omp-session from the fish and zsh prompt: on the default branch it resumes a session written in the last 3 hours, else opens the omp-sessions television cable; on any other branch it resumes that branch's newest session or starts a new one. tv agents still lists every installed agent CLI (television).
• Ctrl N starts a new omp session from the fish and zsh prompt, skipping every resume rule. Inside the omp-sessions cable, ctrl-n does the same instead of resuming the selected session.
• launch_omp_livediff_overlay and lc-elir are omp helpers in ~/.local/bin; see scripts.