alex
722d608491
CI / check (push) Has been cancelled
Agents were told to run bd commands that beads_rust does not have (bd prime, bd remember, bd dolt push, bd tag, bd note, bd children), and bd's git hooks were still active, so bd could re-export its stale dolt state over br's JSONL on commit. - Rewrite AGENTS.md, docs/agents/issue-tracker.md, docs/agents/triage-labels.md and the .serena memories around br's real CLI surface - Replace bd's generated AGENTS.md block with br's (br agents --add) - Point the .claude session hooks at `br robot-docs guide` - Remove bd git hooks and unset core.hooksPath; br installs no hooks - Ignore br runtime files (local SQLite DB, recovery and merge artifacts) - Rewrite .beads/README.md, config.yaml and metadata.json for br Issue: nix-overlay-6pp
35 lines
1.4 KiB
Markdown
35 lines
1.4 KiB
Markdown
# 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)
|
|
- `br robot-docs guide` — session context, run before any work.
|
|
- `br ready` / `br show <id>` / `br update <id> --claim` / `br close <id>`.
|
|
- `br update <id> --append-notes "..."` — persistent knowledge instead of MEMORY.md.
|
|
- `br sync --flush-only` — export issue state to `.beads/issues.jsonl`; runs no git commands.
|
|
|
|
## Session completion push
|
|
```
|
|
git pull --rebase && br sync --flush-only && git add .beads/ && git commit -m "sync beads" && git push
|
|
git status # must show "up to date with origin"
|
|
```
|
|
|
|
## Serena
|
|
- `serena memories check` — verify memory references after edits/deletes.
|