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
|
||||||
105
home.nix
105
home.nix
@@ -11,17 +11,18 @@
|
|||||||
# Let Home Manager install and manage itself
|
# Let Home Manager install and manage itself
|
||||||
programs.home-manager.enable = true;
|
programs.home-manager.enable = true;
|
||||||
|
|
||||||
|
# Nix configuration
|
||||||
|
nix = {
|
||||||
|
enable = true;
|
||||||
|
package = pkgs.nix;
|
||||||
|
settings = {
|
||||||
|
experimental-features = ["nix-command" "flakes"];
|
||||||
|
warn-dirty = false;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
# Packages to install
|
# Packages to install
|
||||||
home.packages = with pkgs; [
|
home.packages = with pkgs; [
|
||||||
# Basic utilities
|
|
||||||
coreutils
|
|
||||||
curl
|
|
||||||
wget
|
|
||||||
htop
|
|
||||||
ripgrep
|
|
||||||
fd
|
|
||||||
jq
|
|
||||||
tree
|
|
||||||
];
|
];
|
||||||
|
|
||||||
# Bash configuration
|
# Bash configuration
|
||||||
@@ -29,35 +30,17 @@
|
|||||||
enable = true;
|
enable = true;
|
||||||
enableCompletion = true;
|
enableCompletion = true;
|
||||||
|
|
||||||
# Shell aliases
|
|
||||||
shellAliases = {
|
|
||||||
ll = "ls -la";
|
|
||||||
".." = "cd ..";
|
|
||||||
"..." = "cd ../..";
|
|
||||||
"grep" = "grep --color=auto";
|
|
||||||
"rm" = "rm -i";
|
|
||||||
"cp" = "cp -i";
|
|
||||||
"mv" = "mv -i";
|
|
||||||
};
|
|
||||||
|
|
||||||
# Bash initialization
|
# Bash initialization
|
||||||
initExtra = ''
|
initExtra = ''
|
||||||
# Custom prompt
|
# Ensure Nix paths are properly set up
|
||||||
PS1='\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '
|
export PATH="$HOME/.nix-profile/bin:/nix/var/nix/profiles/default/bin:$PATH"
|
||||||
|
export NIX_PATH="$HOME/.nix-defexpr/channels:nixpkgs=$HOME/.nix-defexpr/channels/nixpkgs"
|
||||||
|
|
||||||
# Additional bash customizations
|
# Source nix environment if it exists and not already sourced
|
||||||
export EDITOR=vim
|
if [ -e "$HOME/.nix-profile/etc/profile.d/nix.sh" ] && [ -z "$NIX_SOURCED" ]; then
|
||||||
export PATH="$HOME/.local/bin:$PATH"
|
export NIX_SOURCED=1
|
||||||
|
. "$HOME/.nix-profile/etc/profile.d/nix.sh"
|
||||||
# History settings
|
fi
|
||||||
export HISTSIZE=10000
|
|
||||||
export HISTFILESIZE=10000
|
|
||||||
export HISTCONTROL=ignoreboth:erasedups
|
|
||||||
|
|
||||||
# Custom functions
|
|
||||||
function mkcd() {
|
|
||||||
mkdir -p "$1" && cd "$1"
|
|
||||||
}
|
|
||||||
'';
|
'';
|
||||||
|
|
||||||
# History configuration
|
# History configuration
|
||||||
@@ -66,8 +49,8 @@
|
|||||||
"ignoredups"
|
"ignoredups"
|
||||||
"ignorespace"
|
"ignorespace"
|
||||||
];
|
];
|
||||||
historyFileSize = 10000;
|
historyFileSize = 1000000;
|
||||||
historySize = 10000;
|
historySize = 1000000;
|
||||||
};
|
};
|
||||||
|
|
||||||
# Direnv configuration
|
# Direnv configuration
|
||||||
@@ -77,53 +60,5 @@
|
|||||||
|
|
||||||
# Add hook to .bashrc
|
# Add hook to .bashrc
|
||||||
enableBashIntegration = true;
|
enableBashIntegration = true;
|
||||||
|
|
||||||
# Configuration
|
|
||||||
config = {
|
|
||||||
whitelist = {
|
|
||||||
prefix = [
|
|
||||||
"$HOME/projects"
|
|
||||||
"$HOME/work"
|
|
||||||
];
|
|
||||||
};
|
|
||||||
};
|
|
||||||
};
|
|
||||||
|
|
||||||
# Git configuration (useful with direnv)
|
|
||||||
programs.git = {
|
|
||||||
enable = true;
|
|
||||||
userName = "tbingmann";
|
|
||||||
userEmail = "tbingmann@example.com"; # Replace with actual email
|
|
||||||
|
|
||||||
# Basic configuration
|
|
||||||
extraConfig = {
|
|
||||||
core.editor = "vim";
|
|
||||||
init.defaultBranch = "main";
|
|
||||||
pull.rebase = false;
|
|
||||||
};
|
|
||||||
};
|
|
||||||
|
|
||||||
# Create default .envrc template in home directory
|
|
||||||
home.file.".envrc-template" = {
|
|
||||||
text = ''
|
|
||||||
# This is a template .envrc file for use with direnv
|
|
||||||
# Copy this to your project directory and customize as needed
|
|
||||||
|
|
||||||
# Load environment variables from .env file if it exists
|
|
||||||
if [ -f .env ]; then
|
|
||||||
dotenv
|
|
||||||
fi
|
|
||||||
|
|
||||||
# Example: Set project-specific environment variables
|
|
||||||
# export PROJECT_ROOT=$(pwd)
|
|
||||||
# export PATH=$PROJECT_ROOT/bin:$PATH
|
|
||||||
|
|
||||||
# Example: Use Nix shell
|
|
||||||
# use nix
|
|
||||||
|
|
||||||
# Example: Use flake
|
|
||||||
# use flake
|
|
||||||
'';
|
|
||||||
executable = false;
|
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user