# nix-overlay — commands

All run from repo root (`nix-overlay/`).

## Build / run
- `nix build .#<package>` — build one package (must be `git add`-ed first if new; blueprint reads git index).
- `nix run .#<package>` — run a package CLI (needs `meta.mainProgram`).
- `nix build .#default` — build the meta-package (package listing).
- `nix flake show` — inspect flake outputs (also index-limited).
- `nix flake check` — full check incl. formatting.
- `nix develop` — dev shell from blueprint.

## Format
- `nix fmt` (treefmt → nixfmt on *.nix). Same as `nix flake check`'s format gate.

## Package updates
- `nix-update <package>` — bump version + hashes (cargoHash etc.).
- `nix-update <package> --version <v>` — specific version.
- `nix-update skillsmcp --version=branch=main` — for commit-pinned pkgs; or `--commit <sha>`.

## Beads (mandatory task tracking)
- `bd prime` — session context, run before any work.
- `bd ready` / `bd show <id>` / `bd update <id> --claim` / `bd close <id>`.
- `bd remember` — persistent knowledge instead of MEMORY.md.
- `bd dolt push` — prints "No remote is configured — skipping." (expected; exit 0).

## Session completion push
```
git pull --rebase && bd dolt push && git push
git status  # must show "up to date with origin"
```

## Serena
- `serena memories check` — verify memory references after edits/deletes.