[KINNCJ] NIX.DEV

README.md

🌌 Universal Dev Environment (Nix + Home Manager)

A reproducible, single-file development environment for macOS, native Linux (Ubuntu/Fedora/Arch/CachyOS), and WSL.

It supports your shell mix:

• macOS: Zsh (+ Oh My Zsh)
• Ubuntu: Bash (+ Oh My Bash)
• CachyOS: Fish (+ Oh My Fish)

---

👤 Maintainer

Kinn <kinncj@protonmail.com>
This is Kinn’s personal cross-platform Home Manager setup.

---

🛠️ What's Included

• Editors: Neovim (isolated LazyVim profile), VS Code (disabled on WSL).
• Terminal & Shell: Zsh/Bash/Fish profiles via Home Manager, Ghostty with platform-aware packaging.
• AI Tooling: GitHub Copilot CLI, Claude Code (where available), RTK, Code Review Graph, Pi (pi-agent), OpenCode (opencode).
• Core Agents & Runtime: MAPLE (by Kinn), Herdr, Heimdall (by Kinn).
• Toolchain: Node.js 22, Python 3, Pipx, Cargo (Rust), Go, GitHub CLI, GCC, Make, Git, gnutar.

---

🚀 Setup Instructions (Fresh Machine)

1) Install Nix

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh

Restart your terminal after install.

2) Bootstrap Home Manager

nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
nix-channel --update
nix-shell '<home-manager>' -A install

3) Place home.nix

mkdir -p ~/.config/home-manager
nano ~/.config/home-manager/home.nix

4) Deploy

home-manager switch

Reload your active shell:

• zsh: exec zsh
• bash: exec bash
• fish: exec fish

---

🔄 Updating Later

home-manager switch

If channels are stale:

nix-channel --update
home-manager switch

---

🧭 Platform Notes

Ghostty mapping in Nixpkgs

• macOS: pkgs.ghostty-bin
• native Linux: pkgs.ghostty
• WSL: GUI package skipped

macOS app links

GUI apps are linked into:

• /Applications/Home Manager Apps

Launch examples:

open "/Applications/Home Manager Apps/Ghostty.app"
open "/Applications/Home Manager Apps/Visual Studio Code.app"

---

🐚 Shell Frameworks

• Zsh: Oh My Zsh
• Bash: Oh My Bash
• Fish: Oh My Fish

---

⌨️ Quick Commands

• lvim — Open Neovim with NVIM_APPNAME=lazyvim-nix
• gh copilot — GitHub Copilot CLI
• claude — Claude Code (if available on platform/channel)
• rtk init -g — Initialize Rust Token Killer
• crg install — Install Code Review Graph mapping
• pi-agent — Start Pi agent
• opencode — Start OpenCode

Runtime installers (user space)

• install-maple — installs MAPLE to ~/.tools/maple/bin
• install-herdr — installs Herdr to ~/.local/bin/herdr
• install-heimdall — installs Heimdall dashboard + daemon tooling

---

✅ Ensure Herdr Works

After home-manager switch, run:

install-herdr
command -v herdr
herdr --help

Expected:

• command -v herdr returns ~/.local/bin/herdr (or equivalent)
• herdr --help prints usage text

If not found, confirm PATH contains ~/.local/bin:

echo $PATH

Then restart your shell (exec zsh / exec bash / exec fish).

---

🧰 Tools & Profile

Declarative PATH / Env

PATH includes:

• ~/.tools/maple/bin
• ~/.tools/heimdall/bin
• ~/.local/bin
• ~/.cargo/bin
• ~/.go/bin
• /usr/local/bin

Editors

• Neovim + LazyVim bootstrap (~/.config/lazyvim-nix)
• VS Code profile settings managed by Home Manager

AI / Context

• Claude Code
• GitHub Copilot CLI
• RTK
• Code Review Graph
• Pi Coding Agent
• OpenCode
• MAPLE (by Kinn)
• Heimdall (by Kinn)
• Herdr

---

🧼 Clean Reset

rm -rf ~/.tools/maple ~/.tools/heimdall ~/.local/bin/herdr ~/.local/bin/code-review-graph ~/.cargo/bin/rtk ~/.cargo/git/checkouts/rtk-*
home-manager switch
exec zsh   # or bash/fish
install-maple
install-herdr
install-heimdall

---

🔗 Tool Links (Official)

Editors & IDE

• Neovim — https://neovim.io/
• LazyVim — https://www.lazyvim.org/
• VS Code — https://code.visualstudio.com/
• VS Code Insiders — https://code.visualstudio.com/insiders/

Shells & Frameworks

• Zsh — https://www.zsh.org/
• Oh My Zsh — https://ohmyz.sh/
• Bash — https://www.gnu.org/software/bash/
• Oh My Bash — https://github.com/ohmybash/oh-my-bash
• Fish — https://fishshell.com/
• Oh My Fish — https://github.com/oh-my-fish/oh-my-fish

Terminal

• Ghostty — https://ghostty.org/

Source Control / CLI

• Git — https://git-scm.com/
• GitHub CLI — https://cli.github.com/
• GitHub Copilot CLI docs — https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/customizing-the-development-environment-for-copilot-coding-agent

AI / Agent Tooling

• Claude Code — https://docs.anthropic.com/en/docs/claude-code/overview
• RTK — https://github.com/rtk-ai/rtk
• Code Review Graph — https://github.com/tirth8205/code-review-graph
• Pi Coding Agent — https://www.npmjs.com/package/@mariozechner/pi-coding-agent
• OpenCode AI — https://www.npmjs.com/package/opencode-ai

Kinn’s Tools

• MAPLE — https://github.com/kinncj/MAPLE
• Heimdall — https://github.com/kinncj/Heimdall

Other Core Runtime Tool

• Herdr — https://herdr.dev/

Runtimes / Build

• Node.js — https://nodejs.org/
• Python — https://www.python.org/
• Pipx — https://github.com/pypa/pipx
• Rust — https://www.rust-lang.org/
• Cargo — https://doc.rust-lang.org/cargo/
• Go — https://go.dev/
• GCC — https://gcc.gnu.org/
• GNU Make — https://www.gnu.org/software/make/
• GNU tar — https://www.gnu.org/software/tar/

---

📚 References

• NixOS — https://nixos.org/
• nix.dev — https://nix.dev/
• Nix package search — https://search.nixos.org/packages
• Home Manager manual — https://nix-community.github.io/home-manager/
• Home Manager option search — https://home-manager-options.extranix.com/

home.nix

# ~/.config/home-manager/home.nix
{ config, pkgs, lib, ... }:

let
  isDarwin = pkgs.stdenv.isDarwin;
  isLinux = pkgs.stdenv.isLinux;

  isWSL =
    isLinux
    && builtins.pathExists "/proc/sys/kernel/osrelease"
    && (builtins.match ".*([Mm]icrosoft|WSL).*"
      (builtins.readFile "/proc/sys/kernel/osrelease") != null);

  includeLinuxGUI = isLinux && (!isWSL);

  envHome = builtins.getEnv "HOME";
  envUser = builtins.getEnv "USER";
  envShell = builtins.getEnv "SHELL";

  usingZsh = lib.hasSuffix "/zsh" envShell;
  usingBash = lib.hasSuffix "/bash" envShell;
  usingFish = lib.hasSuffix "/fish" envShell;

  homeDirectory =
    if envHome != "" then envHome
    else if isDarwin then "/Users/${envUser}"
    else "/home/${envUser}";

  usernameFromHome =
    let m = builtins.match ".*/([^/]+)$" homeDirectory;
    in if m == null then envUser else builtins.elemAt m 0;

  has = name: builtins.hasAttr name pkgs;

  commonAliases = {
    lvim = "nvim";
    crg = "code-review-graph";
    pi-agent = "npx @mariozechner/pi-coding-agent";
    opencode = "npx opencode-ai";
    code-insiders = "code-insiders";
    install-maple = "curl -fsSL https://raw.githubusercontent.com/kinncj/MAPLE/main/scripts/install.sh | bash";
    # Replace with official Herdr installer command from https://herdr.dev/ when ready
    install-herdr = "echo 'Please install Herdr from https://herdr.dev/'";
    install-heimdall = "curl -fsSL https://raw.githubusercontent.com/kinncj/Heimdall/main/scripts/install.sh | sh -s -- dashboard && curl -fsSL https://raw.githubusercontent.com/kinncj/Heimdall/main/scripts/install.sh | sh -s -- daemon";
  };
in
{

  home.username = usernameFromHome;
  home.homeDirectory = homeDirectory;
  home.stateVersion = "24.11";

  nixpkgs.config.allowUnfree = true;

  home.packages =
    [
      pkgs.neovim
      pkgs.gh
      pkgs.git
      pkgs.nodejs # Keeps the default Node.js (and drops duplicate nodejs_22)
      pkgs.gnumake
      pkgs.gcc
      pkgs.curl
      pkgs.gnutar
      pkgs.go
      pkgs.cargo
      pkgs.pipx
      pkgs.python312
      pkgs.fish
      pkgs.bashInteractive
    ]
    ++ lib.optionals (has "github-copilot-cli" && isLinux) [ pkgs.github-copilot-cli ]
    ++ lib.optionals (has "claude-code" && isLinux) [ pkgs.claude-code ]
    ++ lib.optionals (isDarwin && has "ghostty-bin") [ pkgs.ghostty-bin ]
    ++ lib.optionals (includeLinuxGUI && has "ghostty") [ pkgs.ghostty ]
    ++ lib.optionals isDarwin [ pkgs.libiconv ];

  home.sessionPath = [
    "$HOME/.npm-global/bin"
    "$HOME/.tools/maple/bin"
    "$HOME/.tools/heimdall/bin"
    "$HOME/.local/bin"
    "$HOME/.cargo/bin"
    "$HOME/.go/bin"
    "/usr/local/bin"
  ];

  home.sessionVariables = {
    NVIM_APPNAME = "lazyvim-nix";
    GOPATH = "${homeDirectory}/.go";
    NPM_CONFIG_PREFIX = "$HOME/.npm-global";
  };

  programs.zsh = {
    enable = true;
    shellAliases = commonAliases;
    oh-my-zsh = {
      enable = true;
      theme = "robbyrussell";
      plugins = [ "git" "sudo" "history" ];
    };
    initExtra = ''
      # Nix fallback bootstrap (handles macOS updates wiping Nix hooks)
      if [ -e '/nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh' ]; then
        . '/nix/var/nix/profiles/default/etc/profile.d/nix-daemon.sh'
      fi
    '';
  };

  programs.bash = {
    enable = true;
    shellAliases = commonAliases;
    initExtra = ''
      if [ -f "$HOME/.oh-my-bash" ]; then
        export OSH="$HOME/.oh-my-bash"
        export OSH_THEME="font"
        plugins=(git)
        source "$HOME/.oh-my-bash/oh-my-bash.sh"
      fi
    '';
  };

  programs.fish = {
    enable = true;
    shellAliases = commonAliases;
    interactiveShellInit = ''
      set -g fish_greeting
    '';
  };

  programs.vscode =
    if isWSL then
      { enable = false; }
    else
      {
        enable = true;
        package = if isDarwin then pkgs.vscode else pkgs.vscode.fhs;
        profiles.default.userSettings = {
          "editor.fontSize" = 13;
          "window.titleBarStyle" = if isDarwin then "custom" else "native";
          "telemetry.telemetryLevel" = "off";
        };
      };

  home.activation = {
    setupLazyVim = config.lib.dag.entryAfter [ "writeBoundary" ] ''
      if [ ! -d "$HOME/.config/lazyvim-nix" ]; then
        echo "📦 Initializing LazyVim..."
        ${pkgs.git}/bin/git clone https://github.com/LazyVim/starter "$HOME/.config/lazyvim-nix"
      fi
    '';

    setupAgentExtensions = config.lib.dag.entryAfter [ "writeBoundary" ] ''
      export PATH="$HOME/.go/bin:$HOME/.cargo/bin:$HOME/.local/bin:${pkgs.gcc}/bin:$PATH"
      ${lib.optionalString isDarwin ''export LIBRARY_PATH="${pkgs.libiconv}/lib:${"$"}{LIBRARY_PATH:-}"''}

      if ! command -v code-review-graph >/dev/null 2>&1; then
        echo "🤖 Installing Code Review Graph via pipx..."
        ${pkgs.pipx}/bin/pipx install --python ${pkgs.python312}/bin/python3 code-review-graph
      fi

      if ! command -v rtk >/dev/null 2>&1; then
        echo "🦀 Installing RTK..."
        ${pkgs.cargo}/bin/cargo install --git https://github.com/rtk-ai/rtk
      fi
    '';

    setupOhMyBash = lib.hm.dag.entryAfter [ "writeBoundary" ] ''
      ${lib.optionalString usingBash ''
      if [ ! -d "$HOME/.oh-my-bash" ]; then
        echo "🐚 Installing Oh My Bash..."
        ${pkgs.git}/bin/git clone https://github.com/ohmybash/oh-my-bash.git "$HOME/.oh-my-bash"
      fi
      ''}
    '';

    setupOhMyFish = lib.hm.dag.entryAfter [ "writeBoundary" ] ''
      ${lib.optionalString usingFish ''
      if [ ! -d "$HOME/.local/share/omf" ]; then
        echo "🐟 Installing Oh My Fish..."
        ${pkgs.fish}/bin/fish -c '${pkgs.curl}/bin/curl -L https://get.oh-my.fish | fish'
      fi
      ''}
    '';

    linkDarwinApps = lib.hm.dag.entryAfter [ "linkGeneration" ] (lib.mkIf isDarwin ''
      set -euo pipefail
      appDir="/Applications/Home Manager Apps"
      mkdir -p "$appDir"

      if [ -d "$HOME/.nix-profile/Applications" ]; then
        find "$HOME/.nix-profile/Applications" -maxdepth 1 -name "*.app" -print0 \
          | while IFS= read -r -d "" app; do
              ln -sfn "$app" "$appDir/$(basename "$app")"
            done
      fi

      ${lib.optionalString (has "ghostty-bin") ''
      if [ -d "${pkgs.ghostty-bin}/Applications" ]; then
        find "${pkgs.ghostty-bin}/Applications" -maxdepth 1 -name "*.app" -print0 \
          | while IFS= read -r -d "" app; do
              ln -sfn "$app" "$appDir/$(basename "$app")"
            done
      fi
      ''}

      if [ -d "${pkgs.vscode}/Applications" ]; then
        find "${pkgs.vscode}/Applications" -maxdepth 1 -name "*.app" -print0 \
          | while IFS= read -r -d "" app; do
              ln -sfn "$app" "$appDir/$(basename "$app")"
            done
      fi
    '');
  };

  programs.home-manager.enable = true;
}