Skip to content

feat: install plannotator on NixOS and darwin development hosts - #11

Merged
tnmt merged 3 commits into
mainfrom
feat/plannotator
Nov 16, 2026
Merged

tnmt merged 3 commits into
mainfrom
feat/plannotator

Conversation

@tnmt

@tnmt tnmt commented Nov 16, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • Install plannotator on the development hosts (sunflower, dahlia, hydrangea) via home-manager/devel/ai/packages.nix. Both the NixOS and nix-darwin development profiles import home-manager/devel.
  • The package comes from nur-tnmt (Add plannotator package nur-packages#155), exposed through the overlay inherit list. It is not in nixpkgs.
  • Set three variables in home-manager/devel/ai/integrations.nix so plannotator does not rewrite agent config behind home-manager's back:
    • PLANNOTATOR_INBOX_CONNECT=0: plannotator inbox registers its MCP server in each agent's config (~/.claude.json, Codex config.toml, ...) with process.execPath, i.e. a /nix/store/... path that breaks after an upgrade or GC.
    • PLANNOTATOR_INBOX_NOTES=0: stops it writing notes such as ~/.claude/rules/plannotator-inbox.md without asking.
    • PLANNOTATOR_UPDATE_CHECK=0: the in-app update runs upstream's install script into ~/.local/bin, leaving a second copy beside the Nix one.
  • Document the above in AGENTS.md.

Merge order

tnmt/nur-packages#155 is merged and flake.lock pins nur-tnmt to its merge commit on main (a00cb5f). This PR can be merged on its own.

After switch (manual)

  • Register the Inbox MCP by command name so it survives upgrades:
    claude mcp add --scope user plannotator-inbox -- plannotator inbox mcp
  • The Claude Code plugin (plannotator@plannotator, plan-review hooks) calls plannotator from PATH. Installing it is left as a manual claude plugin step.
  • Not decided here: the daily anonymous ping is on by default; NO_ANON_PING=1 turns it off.

Test

All with --override-input nur-tnmt git+file://…/nur-packages-worktrees/DANDORI-98?ref=add-plannotator:

  • home.packages contains plannotator-0.28.65 on sunflower, dahlia and hydrangea.
  • nixosConfigurations.{sunflower,dahlia}.config.system.build.toplevel and darwinConfigurations.hydrangea.system evaluate.
  • The sunflower home-manager generation builds; bin/plannotator and the three variables in hm-session-vars.sh are present.
  • nix flake check --no-build: all checks passed (x86_64-linux).
  • No switch or deploy was run.

🤖 Generated with Claude Code

Add plannotator from nur-tnmt to home-manager/devel/ai, which both the
NixOS and nix-darwin development profiles import.

`plannotator inbox` otherwise registers its MCP server in each agent's
config with the absolute path of the running binary, which under Nix is
a store path that breaks on upgrade or GC, and writes notes into agent
instructions without asking. Disable both, plus the update check whose
in-app update installs a second copy into ~/.local/bin.

Requires tnmt/nur-packages#155; flake.lock still needs
`nix flake update nur-tnmt` after it is merged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tnmt
tnmt marked this pull request as ready for review November 16, 2026 06:32
tnmt and others added 2 commits November 16, 2026 15:33
Temporary pin so CI can evaluate plannotator before #155 is merged.
Re-lock with `nix flake update nur-tnmt` once it lands on main.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
tnmt/nur-packages#155 is merged; move the lock from the branch commit
to the merge commit on main (same narHash).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tnmt
tnmt merged commit d492924 into main Nov 16, 2026
7 checks passed
@tnmt
tnmt deleted the feat/plannotator branch November 16, 2026 06:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant