working
This commit is contained in:
77
CLAUDE.md
Normal file
77
CLAUDE.md
Normal file
@@ -0,0 +1,77 @@
|
||||
# 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:
|
||||
|
||||
```bash
|
||||
# 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
|
||||
|
||||
```bash
|
||||
# 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:
|
||||
|
||||
```bash
|
||||
home-manager build --flake .#tbingmann
|
||||
```
|
||||
|
||||
### Debugging Issues
|
||||
|
||||
For more detailed information when troubleshooting:
|
||||
|
||||
```bash
|
||||
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
|
||||
Reference in New Issue
Block a user