Files
dotfiles/docs/ai/index.mdx
T

62 lines
2.6 KiB
Plaintext

---
title: AI agents
description: Claude Code, omp, and the shared agent skill library that both read from.
sidebar:
label: Overview
---
The repo manages configuration for two coding agents and a skill library they share. Neither agent binary is installed by chezmoi: `.chezmoidata/packages.yaml` lists no agent CLIs, so install Claude Code and omp yourself. topgrade runs `omp update` as a custom command.
<CardGroup cols={3}>
<Card title="Claude Code" href="/ai/claude-code" icon="terminal">
Settings, hooks, plugins, slash commands, and skill links under `~/.claude`.
</Card>
<Card title="omp" href="/ai/omp" icon="cpu">
Config, keybindings, MCP servers, theme, commands, and scheduled research loops under `~/.omp`.
</Card>
<Card title="Skills" href="/ai/skills" icon="library">
Agent skills declared in `.chezmoidata/skills.yaml` and installed into `~/.agents/skills` and `~/.claude/skills` by an apply script.
</Card>
</CardGroup>
## Pages
| Page | Source in repo | Target in `$HOME` | Covers |
| --- | --- | --- | --- |
| [Claude Code](/ai/claude-code) | `dot_claude/` | `~/.claude/` | `settings.json`, hook scripts, `/commands`, empty `CLAUDE.md` |
| [omp](/ai/omp) | `dot_omp/` | `~/.omp/` | `agent/config.yml`, `keybindings.yml`, `mcp.json`, cyberdream theme, commands, loops |
| [Skills](/ai/skills) | `.chezmoidata/skills.yaml`, `.chezmoiscripts/run_onchange_after_25-skills.sh.tmpl` | `~/.agents/skills/`, `~/.claude/skills/` | Skill list and sources; installed by the Skills CLI, not vendored |
## Layout
<FileTree>
- dot_claude/
- settings.json
- empty_CLAUDE.md
- commands/
- hooks/
- executable_cmem-to-obsidian.py
- executable_herdr-agent-state.sh
- gitnexus/
- dot_omp/
- private_agent/
- private_config.yml
- keybindings.yml
- private_mcp.json
- themes/
- commands/
- loops/
- bin/
- goals/
</FileTree>
None of these files are role-gated: `.chezmoiignore.tmpl` applies them on every machine role (desktop, laptop, mac, server).
## 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](/shell/fish).
- <kbd>Ctrl</kbd> <kbd>A</kbd> opens the `agents` television cable from the fish prompt: every installed agent CLI (omp, claude, codex, opencode, …); <kbd>enter</kbd> starts it ([television](/tools/television#agents)). In zsh it still launches `omp`.
- `launch_omp_livediff_overlay` and `lc-elir` are omp helpers in `~/.local/bin`; see [omp](/ai/omp#shell-integration) and [scripts](/shell/scripts).