nix-ebay-home/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Purpose

This repository contains a Nix home-manager flake configuration for setting up a user environment on a Linux system. It's designed for user tbingmann and includes configurations for Nix itself, Bash, direnv, Git, and other utilities. The configuration ensures Nix is properly installed and configured with experimental features enabled.

Code Architecture

• flake.nix: The main Nix flake configuration file that defines inputs (dependencies) and outputs. It sets up the home-manager configuration for user tbingmann.
• home.nix: Contains the actual home-manager configuration including:
  • User information
  • Nix installation and configuration with flakes support
  • Package installations
  • Bash configuration and customizations with Nix PATH setup
  • Direnv setup
  • Git configuration

Common Commands

Applying Configuration Changes

After making changes to the configuration:

# If home-manager is not installed
nix run github:nix-community/home-manager/release-25.05 -- switch --flake .#tbingmann

# If home-manager is installed
home-manager switch --flake .#tbingmann

Direct Installation from Git Repository

# If home-manager is not installed
nix --no-write-lock-file run github:nix-community/home-manager/release-25.05 -- switch --flake 'git+https://g.t1.xyz/tb/nix-ebay-home.git#tbingmann'

# If home-manager is installed
home-manager --no-write-lock-file switch --flake 'git+https://g.t1.xyz/tb/nix-ebay-home.git#tbingmann'

Checking Configuration Validity

To validate configuration changes without applying them:

home-manager build --flake .#tbingmann

Debugging Issues

For more detailed information when troubleshooting:

home-manager switch --flake .#tbingmann --debug

Configuration Guidelines

When modifying this repository:

1. Update packages in the home.packages section of home.nix
2. Customize Bash settings in the programs.bash section
3. Add or modify program configurations under the programs attribute
4. Adjust Nix configuration in the nix section if needed
5. Ensure the username (tbingmann) is consistent throughout the configuration

Nix Configuration Details

The configuration includes:

1. Installation of Nix packages: The nix package itself, nixpkgs-fmt, and nix-direnv
2. Nix experimental features: Enables both nix-command and flakes by default
3. PATH configuration: Sets up proper Nix paths in the Bash environment
4. direnv integration: Configured to work with Nix for project-specific environments