dotfiles/docs/ai/index.mdx

---
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> runs [`omp-session`](/shell/scripts#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](/tools/television#agents)).
- `launch_omp_livediff_overlay` and `lc-elir` are omp helpers in `~/.local/bin`; see [omp](/ai/omp#shell-integration) and [scripts](/shell/scripts).