---
purpose: Document the local Herdr checkout-layout plugin.
applies_to: Changes to OMP/Hunk tab bootstrap or Hunk actions.
entrypoint: Edit dev_layout.py and herdr-plugin.toml.
verification: Run python3 -m unittest dev_layout_test.py.
update_when: Plugin actions, events, layout, or requirements change.
---

# Dotfiles Dev Layout

Creates OMP for every workspace and Hunk for Git checkout workspaces, with OMP focused.

## Install

```bash
herdr plugin install edmundmiller/dotfiles/packages/herdr-plugins/dotfiles-dev-layout
```

## Entrypoints

- Action: `dotfiles.dev-layout.bootstrap`
- Action: `dotfiles.dev-layout.hunk-split`
- Action: `dotfiles.dev-layout.hunk-tab`
- Events: `workspace.created` and `worktree.created` (serialized per workspace)
- Prelaunch: optional repo-local QMD index seeding before Codex starts

`worktree.create` emits both creation events. The bootstrap is locked and
idempotent because `workspace.created` is also required for ordinary workspaces,
including Herdr workspaces created around jj checkouts.

## Requirements

- Herdr `0.7.0` or newer
- `python3`
- Required: `omp`, plus `hunk` or `bunx hunkdiff`
