1# AGENTS.md
 2
 3This is a monorepo of Pi extensions. If `which pi` reports Pi is managed by
 4`mise`, its extension docs are in `$(mise where
 5npm:@earendil-works/pi-coding-agent)/lib/node_modules/@earendil-works/pi-coding-agent/docs/extensions.md`.
 6
 7## Commands
 8
 9```sh
10npm install # install deps (only after cloning)
11mise run fmt
12mise run lint
13npm run typecheck --workspace packages/<package> # single package typecheck
14mise run typecheck # check all packages
15mise run check # runs fmt, lint, typecheck; fmt writes changes
16mise run release:[bump|pack|publish] <package...> <flags, args ...>
17```
18
19## Release gotchas
20
21- Release package selectors are resolved by `scripts/resolve-release-packages.bash`; update it when adding a package.
22- Exact-version bumps and `release:publish --otp` only work for one package at a time.
23- `release:publish` refuses prereleases with the default `latest` tag; pass a prerelease tag such as `--tag beta`.
24
25## VCS
26
27This is a jj repo. Use kernel-style commit messages (imperative, 50-char
28subject, body explains what/why). Use the format script at
29`~/.config/agents/skills/formatting-commits/scripts/format` to validate
30subjects and reflow bodies.