nixfiles/home/claude.nix

# Claude Code, configured declaratively via home-manager. Wanted on every host
# whose CPU can run it -- see the gate below.
#
# The STATIC config is managed here: the global CLAUDE.md (persona/context), the
# custom output style, and the auto-memory directory. settings.json is
# deliberately left UNMANAGED -- Claude Code rewrites it at runtime (interactive
# permission grants, /config), and a read-only /nix/store symlink would break
# those writes.
#
# Memory is the source of truth in this repo (./claude/memory). It is symlinked
# read-only into ~/.claude/memory, so the runtime "save a memory" path no longer
# writes there -- recall still works, but new/changed memories must be added to
# this repo and rebuilt. CLAUDE.md instructs Claude to do exactly that.
{
  lib,
  # Set by the NixOS/Darwin home-manager module; absent for the standalone
  # homeConfigurations, hence the default.
  osConfig ? { },
  ...
}:
let
  # Capability gate, declared once for the whole fleet in modules/features.nix
  # (default: on; off on CPUs below x86-64-v2, which cannot run the Node
  # runtime Claude Code ships on). Hosts without that option -- the Darwin host
  # and the portable standalone profile -- fall back to enabled.
  enable = osConfig.features.claudeCode.enable or true;
in
{
  programs.claude-code = {
    inherit enable;
    # package defaults to pkgs.claude-code (tracked to unstable via the flake
    # overlay).

    # ~/.claude/CLAUDE.md -- global instructions / persona / memory workflow.
    context = ./claude/CLAUDE.md;
  };

  # Nothing to place when the CLI is not installed: a ~/.claude/memory symlink
  # with no Claude Code to read it is just dead state.
  home.file = lib.mkIf enable {
    # Custom output style. The module has no option for output-styles/, so place
    # it directly; selection (settings.json `outputStyle`) stays mutable.
    ".claude/output-styles/soviet-engineer.md".source = ./claude/output-styles/soviet-engineer.md;

    # Auto-memory directory, Nix-managed (read-only). Edit ./claude/memory in
    # this repo and rebuild to change what Claude remembers.
    ".claude/memory".source = ./claude/memory;
  };
}