Claude Code generated CLAUDE.md

CLAUDE.md

@@ -0,0 +1,341 @@
+# Linux Workspace - Project Documentation
+
+## Overview
+
+**Linux Workspace** is a comprehensive shell configuration and utility toolkit designed to quickly configure new Linux machines with development tools, environment initialization, and useful utility scripts. It provides a modular, source-able bootstrap system for both bash and fish shells.
+
+This is a **dotfiles & configuration management system** combined with a rich collection of utility scripts for system administration, development workflows, and daily convenience tasks.
+
+## Quick Start
+
+### Installation
+
+```bash
+# Clone the repository
+git clone <repository-url> ~/linux-workspace
+
+# Run the installer
+cd ~/linux-workspace
+./install.sh
+```
+
+The installer automatically:
+
+- Detects the workspace directory location
+- Adds sourcing configuration to `~/.bashrc`
+- Creates Fish shell configuration at `~/.config/fish/conf.d/lws.fish`
+
+### Manual Installation
+
+Add to your `~/.bashrc`:
+
+```bash
+source /path/to/linux-workspace/bashrc
+```
+
+## Project Structure
+
+### Root Files
+
+- [bashrc](bashrc) - Main bootstrap file that initializes the entire workspace
+- [fishrc](fishrc) - Fish shell configuration entry point
+- [functions.sh](functions.sh) - Core utility functions used throughout the system
+- [install.sh](install.sh) - Installation script for automated setup
+- [.editorconfig](.editorconfig) - EditorConfig formatting standards
+
+### Key Directories
+
+#### [bin/](bin/) - Utility Scripts & Tools (45+ scripts)
+
+Collection of executable shell and Python scripts for various tasks:
+
+**Docker & Containers:**
+
+- [dcm](bin/dcm) - Advanced Docker Compose manager with dependency and health check features
+- [docker-bridge](bin/docker-bridge), [docker-noroot](bin/docker-noroot) - Docker helpers
+
+**Development Tools:**
+
+- [gws](bin/gws) - Gradle wrapper shortcuts for Kotlin development
+- [git-dif1](bin/git-dif1), [git-swl](bin/git-swl), [git-reset-master](bin/git-reset-master) - Git workflow utilities
+
+**System Utilities:**
+
+- [network-bandwidth](bin/network-bandwidth), [myip](bin/myip), [weather](bin/weather) - System info
+- [lock-screen](bin/lock-screen), [suspend.sh](bin/suspend.sh), [battery](bin/battery) - System control
+- [cs.sh](bin/cs.sh), [cheatsheet](bin/cheatsheet) - Cheatsheet lookup tools
+
+**Cloud & Infrastructure:**
+
+- [aws-login](bin/aws-login) - AWS authentication helper
+- [vpn-home.sh](bin/vpn-home.sh) - VPN configuration
+
+**Remote Tools:**
+
+- [xmosh](bin/xmosh), [xcat](bin/xcat), [xvim](bin/xvim) - Remote execution helpers
+
+#### [rc/](rc/) - Shell Configuration Modules (23 files)
+
+Modular initialization scripts loaded during shell startup:
+
+**Core Setup:**
+
+- [01-init.fish](rc/01-init.fish) - Fish shell initialization
+- [01-path.sh](rc/01-path.sh) - PATH initialization
+- [02-aliases.sh](rc/02-aliases.sh) - Common command aliases
+- [env.sh](rc/env.sh) - Environment variables (PAGER, EDITOR, MANPAGER)
+- [bash-prompt.sh](rc/bash-prompt.sh) - Colored bash prompt
+
+**Language/Framework Initialization:**
+
+- [nvm.sh](rc/nvm.sh) - Node Version Manager
+- [pyenv.sh](rc/pyenv.sh) - Python environment manager
+- [cargo.sh](rc/cargo.sh) - Rust Cargo
+- [dotnet.sh](rc/dotnet.sh) - .NET runtime
+- [sdkman.sh](rc/sdkman.sh) - SDKMAN Java/Kotlin tooling
+- [linuxbrew.sh](rc/linuxbrew.sh) - Homebrew for Linux
+
+**Development Tools:**
+
+- [ssh-agent.sh](rc/ssh-agent.sh) - SSH agent with WSL support
+- [git-prompt.sh](rc/git-prompt.sh) - Git prompt decoration
+- [direnv.sh](rc/direnv.sh) - Directory environment switching
+- [docker.sh](rc/docker.sh) - Docker initialization
+- [kubernetes.sh](rc/kubernetes.sh) - kubectl/k8s setup
+- [claude-code.sh](rc/claude-code.sh) - Claude Code integration
+
+**Other Tools:**
+
+- [gocryptfs.sh](rc/gocryptfs.sh) - Encrypted filesystem
+- [thefuck.sh](rc/thefuck.sh) - Command correction
+- [enhancd.sh](rc/enhancd.sh) - Directory navigation enhancement
+
+#### [install/](install/) - Installation Scripts (24 files)
+
+Automated setup scripts for various tools:
+
+**Development:**
+
+- [git-prompt.sh](install/git-prompt.sh), [awscli.sh](install/awscli.sh)
+- [docker-ce.sh](install/docker-ce.sh), [docker-compose-2.sh](install/docker-compose-2.sh)
+- [go-tools.sh](install/go-tools.sh), [rust.sh](install/rust.sh)
+- [npm.sh](install/npm.sh), [uv.sh](install/uv.sh)
+
+**Services:**
+
+- [k3s.sh](install/k3s.sh) - Lightweight Kubernetes
+- [lazygit.sh](install/lazygit.sh) - Git UI
+- [syncthing.sh](install/syncthing.sh) - File synchronization
+
+**Applications:**
+
+- [packages.sh](install/packages.sh) - Debian packages
+- [sublime.sh](install/sublime.sh), [vivaldi.sh](install/vivaldi.sh)
+- [pwsh.sh](install/pwsh.sh) - PowerShell
+
+#### [scripts/](scripts/) - Helper Scripts (16 files)
+
+Administrative and one-off scripts:
+
+- [git-config.sh](scripts/git-config.sh) - Git user/email configuration
+- [bash-template.sh](scripts/bash-template.sh) - Script template
+- [gnome-configuration.sh](scripts/gnome-configuration.sh) - GNOME settings automation
+- [gradle-init-kotlin.sh](scripts/gradle-init-kotlin.sh) - Gradle Kotlin project setup
+- [update-desktop-apps.sh](scripts/update-desktop-apps.sh) - Application updates
+
+#### [doc/](doc/) - Documentation (21 files)
+
+Reference guides and cheatsheets:
+
+- [bash.md](doc/bash.md) - Bash scripting guide
+- [git.md](doc/git.md) - Git workflows
+- [vim.md](doc/vim.md) - Vim editor tips
+- [cheatsheet.md](doc/cheatsheet.md) - General commands
+- [fzf.md](doc/fzf.md) - Fuzzy finder
+- [kotlin-coding-guideline.md](doc/kotlin-coding-guideline.md) - Kotlin style guide
+- [gnome.md](doc/gnome.md) - GNOME customization
+
+#### [conf/](conf/) - Configuration Files
+
+- [gnome-shortcuts.conf](conf/gnome-shortcuts.conf) - Keyboard shortcuts
+- [gradle.properties](conf/gradle.properties) - Gradle build config
+- [wsl.conf](conf/wsl.conf) - WSL settings
+- [wg-home.conf](conf/wg-home.conf) - WireGuard VPN
+- [packages.txt](conf/packages.txt) - Recommended Debian packages
+- [applications/](conf/applications/) - Application configs
+- [dircolors/](conf/dircolors/) - Directory coloring schemes
+- [vim/](conf/vim/) - Vim configurations
+
+#### [src/](src/) - Source Projects
+
+- [battery/](src/battery/) - Python project for reading notebook battery information
+
+## Key Features
+
+### Bootstrap System
+
+- **Single-entry point**: [bashrc](bashrc) sources [functions.sh](functions.sh) and loads all `.sh` files from `rc/`
+- **Modular design**: Each tool has its own configuration file
+- **Performance optimization**: `LWS_FAST=1` environment variable for fast initialization
+- **Debug mode**: `LWS_DEBUG=1` for troubleshooting
+- **Reloadable**: `reload-workspace` alias to refresh configuration
+
+### Core Functions
+
+The [functions.sh](functions.sh) file provides essential utilities:
+
+- `append_path()`, `prepend_path()` - PATH manipulation with duplicate prevention
+- `source_directory()`, `source_directory_sh()` - Smart recursive sourcing
+- `is_fast_init()`, `is_slow_init()` - Performance-based initialization
+- `can_run()`, `is_alias()` - Command availability checks
+- `is_wsl()` - Windows Subsystem for Linux detection
+- `xlog()` - Conditional debug logging
+
+### Common Aliases
+
+Defined in [rc/02-aliases.sh](rc/02-aliases.sh):
+
+- Directory: `ll`, `la` (enhanced listing)
+- Docker: `dc` (docker-compose), `dcl` (logs)
+- Navigation: `..`, `...`, `....`, `cdd` (Downloads)
+- Time: `now`, `nowsql`, `sqldate`
+- Kubernetes: `kl`, `kld`, `klg`
+- System: `ssha` (ssh-agent)
+
+### SSH Agent Integration
+
+The [rc/ssh-agent.sh](rc/ssh-agent.sh) module provides:
+
+- **WSL-aware**: Special handling for Windows Subsystem for Linux
+- **Multi-key support**: Checks for both id_ecdsa and id_rsa
+- **Auto-start**: Automatically starts ssh-agent if not running
+- **Keychain fallback**: Uses keychain for non-WSL systems
+
+### Docker Integration
+
+The [bin/dcm](bin/dcm) script offers advanced Docker Compose management:
+
+- Service dependency tracking
+- Health check polling (HTTP, TCP, Redis, etc.)
+- Parallel builds
+- Logging filtering
+- Service startup orchestration
+
+### Gradle Integration
+
+The [bin/gws](bin/gws) tool provides shortcuts for common Gradle tasks:
+
+- Build shortcuts: `c` (clean), `b` (build), `t` (test)
+- Combined: `cb` (clean+build), `cbt` (clean+build+test)
+- Skip options: `-nd` (no detekt), `-nt` (no tests)
+- Java-specific: `jar` (shadowJar), `br` (bootRun)
+
+## Environment Variables
+
+### Core Variables
+
+- `$LWS` - Root directory of Linux Workspace
+- `$WORKSPACE` - Alias for LWS
+
+### Configuration Flags
+
+- `LWS_DEBUG=1` - Enable debug logging
+- `LWS_FAST=1` - Fast initialization (skip slow tools)
+
+### Tool Customization
+
+- `DC`, `DCF` - Docker Compose customization
+- `EDITOR` - Default text editor
+- `PAGER` - Default pager (less)
+
+## Important Commands
+
+- `reload-workspace` - Reload all configurations
+- `clws` - Change directory to workspace
+- `dcm` - Docker Compose manager
+- `gws` - Gradle wrapper shortcuts
+
+## Configuration Strategy
+
+The project uses an **environment-first** approach:
+
+1. **Staged initialization**: Tools load based on `LWS_FAST` flag
+2. **Conditional loading**: Tools only initialize if directories exist
+3. **WSL detection**: Special paths and behaviors for Windows Subsystem for Linux
+4. **Path deduplication**: Removes duplicate PATH entries
+5. **EditorConfig standardization**: Consistent coding standards
+
+## Use Cases
+
+1. **Rapid environment setup** for new Linux machines
+2. **Consistent shell configuration** across multiple systems
+3. **Development tool management** (Node, Python, Rust, Go, Java)
+4. **Docker/Kubernetes workflows** with helper utilities
+5. **Git workflow automation**
+6. **System administration** utilities and scripts
+7. **Personal workspace customization** with modular components
+
+## Customization
+
+### Adding New Modules
+
+1. Create a new `.sh` file in [rc/](rc/)
+2. Add your configuration or aliases
+3. Reload with `reload-workspace`
+
+### Adding New Scripts
+
+1. Create executable script in [bin/](bin/)
+2. Make it executable: `chmod +x bin/yourscript`
+3. Script is automatically available in PATH
+
+### Disabling Modules
+
+Move unwanted modules from [rc/](rc/) to [rc.available/](rc.available/)
+
+## Dependencies
+
+The workspace intelligently detects and initializes available tools:
+
+- **Required**: bash, git
+- **Optional**: docker, kubectl, nvm, pyenv, cargo, direnv, etc.
+- **Detection**: Each module checks for tool availability before initialization
+
+## WSL Support
+
+Special handling for Windows Subsystem for Linux:
+
+- SSH agent integration with Windows
+- Path adjustments for Windows interoperability
+- WSL-specific configurations in [conf/wsl.conf](conf/wsl.conf)
+
+## Performance
+
+- **Fast mode**: Set `LWS_FAST=1` to skip heavy initializations
+- **Lazy loading**: Tools only load when directories exist
+- **Optimized PATH**: Deduplication prevents PATH bloat
+
+## Contributing
+
+This is a personal workspace configuration, but improvements are welcome:
+
+1. Follow existing naming conventions
+2. Keep scripts modular and self-contained
+3. Test on fresh installations
+4. Document new features in appropriate [doc/](doc/) files
+
+## License
+
+Personal project - use and modify as needed for your own workspace.
+
+## Recent Changes
+
+- Installation script improvements
+- Enhanced `ll` and `la` aliases
+- SSH agent fixes for WSL
+- Fish shell integration
+- Addition of new tools (Claude Code, Gemini CLI)
+
+## Support
+
+For issues or questions, refer to the documentation in [doc/](doc/) or examine the relevant configuration files in [rc/](rc/).

bin/upper

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+tr '[:lower:]' '[:upper:]' "$@"
+

bin/xvim

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+vim "$@" --cmd 'au VimLeave * :!clear'
+clear
+

conf/wsl.conf

@@ -0,0 +1,21 @@
+# https://learn.microsoft.com/en-us/windows/wsl/wsl-config
+
+[boot]
+systemd=false
+
+[user]
+default=lachtan
+
+[automount]
+enabled = true
+
+[network]
+generateHosts = true
+generateResolvConf = false
+
+[interop]
+enabled = false
+appendWindowsPath = false
+
+[gpu]
+enabled = true

fishrc

@@ -0,0 +1,11 @@
+# ~/.config/fish/config.fish
+# echo "source $LWS/fishrc" > $__fish_config_dir/conf.d/lws.fish
+
+# $__fish_config_dir/conf.d (by default, ~/.config/fish/conf.d/)
+# $__fish_sysconf_dir/conf.d (by default, /etc/fish/conf.d/)
+
+set -gx PAGER less
+set -g fish_prompt_pwd_dir_length 0
+
+# set -g fish_autosuggestion_enabled 0
+# fish_config theme choose "fish default"

functions.sh

@@ -134,3 +134,7 @@ function true_false() {
   # [[ "${1,,}" =~ ^(1|true|yes)$ ]]
   [[ "${1@L}" =~ ^(1|true|yes)$ ]]
 }
+
+function is_wsl() {
+  grep -q -i wsl /proc/version
+}

install.sh

@@ -2,11 +2,29 @@
 
 set -E -o errexit -o nounset -o pipefail
 
-if grep -q -e 'source\s+.*/linux-workspace/bashrc\s*$' $HOME/.bashrc; then
+function install_lws() {
-  echo "Linux Workspace configuration already exists in .bashrc !"
+  local LWS_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" &>/dev/null && pwd -P)
-  exit 1
+
-else
+  if grep -q -e "source.*$LWS_DIR/bashrc" $HOME/.bashrc; then
-  readonly SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" &>/dev/null && pwd -P)
+    echo "SKIP: Linux Workspace configuration already exists in $HOME/.bashrc !"
-  echo "Adding to $HOME/.bashrc"
+  else
-  echo "source '$SCRIPT_DIR/bashrc'" >> "$HOME/.bashrc"
+    echo "Adding to $HOME/.bashrc"
-fi
+    echo "source '$LWS_DIR/bashrc'" >> "$HOME/.bashrc"
+  fi
+
+  local FISH_CONF_DIR="$HOME/.config/fish"
+  local FISH_CONF_LWS="$FISH_CONF_DIR/conf.d/lws.fish"
+
+  if [[ -d "$FISH_CONF_DIR" ]]; then
+    if [[ -f "$FISH_CONF_LWS" ]]; then
+      echo "SKIP: Linux Workspace configuration already exists in $FISH_CONF_LWS !"
+    else
+      echo "Adding to $FISH_CONF_LWS"
+      echo "source $LWS_DIR/fishrc" > "$FISH_CONF_LWS"
+    fi
+  else
+    echo "Fish configuration directory not found, skipping fish setup."
+  fi
+}
+
+install_lws

install/gemini-cli.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+# https://github.com/google-gemini/gemini-cli
+
+set -E -o errexit -o nounset -o pipefail
+set -x
+
+npm install -g @google/gemini-cli

install/npm.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+
+# https://github.com/nvm-sh/nvm
+
+set -E -o errexit -o nounset -o pipefail
+set -x
+
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
+nvm install node
+nvm use node

rc/01-path.sh

@@ -1 +1,2 @@
 prepend_path_try "$HOME/.local/bin"
+prepend_path_try "$HOME/bin"

rc/02-aliases.sh

@@ -1,5 +1,11 @@
 alias nop=':'
 
+# Long format, human-readable, with indicators
+alias ll='ls -lhF'
+# Same as ll but including hidden files
+alias la='ls -lhAF'
+
+
 alias exit-when-error='set -o errexit'
 alias exit-when-unset-variable='set -o nounset'
 alias exit-when-pipe-fail='set -o pipefail'

rc/cargo.sh

@@ -1,3 +1 @@
-if [[ -f "$HOME/.cargo/env" ]]; then
+source_try "$HOME/.cargo/env"
-  source "$HOME/.cargo/env"
-fi

rc/claude-code.sh

@@ -0,0 +1 @@
+append_path_try $HOME/.local/bin

rc/nvm.sh

@@ -0,0 +1,8 @@
+NVM_DIR="$HOME/.nvm"
+if [ -d "$NVM_DIR" ]; then
+  export NVM_DIR
+  [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+  [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
+else
+  unset NVM_DIR
+fi

rc/ssh-agent.sh

@@ -1,9 +1,51 @@
 # Start ssh agent for private key
 
+function _log() {
+  xlog "[ssh-agent] $*"
+}
+
+_SSH_AGENT_NO_KEYS=1
+_SSH_AGENT_NOT_RUNNING=2
+
 for key in id_ecdsa id_rsa; do
   key_filename="$HOME/.ssh/$key"
-  if [ -f $key_filename ]; then
+
-    eval $(keychain --eval --quiet --agents ssh $key)
+  if [ -f "$key_filename" ]; then
+    _log "SSH key: $key_filename"
+
+    if is_wsl; then
+      _log "WSL ON"
+
+      if [ -z "$SSH_AUTH_SOCK" ]; then
+        export SSH_AUTH_SOCK=$HOME/.ssh/ssh-agent.sock
+      fi
+
+      _log "SSH_AUTH_SOCK: $SSH_AUTH_SOCK"
+
+      ssh-add -L &> /dev/null
+      ssh_add_status=$?
+
+      if [[ -S "$SSH_AUTH_SOCK" && $ssh_add_status -eq $_SSH_AGENT_NOT_RUNNING ]]; then
+        _log "SSH agent does not running, delete $SSH_AUTH_SOCK"
+        rm -f "$SSH_AUTH_SOCK"
+      fi
+
+      if [[ ! -S "$SSH_AUTH_SOCK" || $ssh_add_status -eq $_SSH_AGENT_NOT_RUNNING ]]; then
+        _log "Starting ssh-agent"
+        eval "$(ssh-agent -s -a "$SSH_AUTH_SOCK")"
+      fi
+
+      ssh-add -L &> /dev/null
+      ssh_add_status=$?
+
+      if [[ $ssh_add_status -eq $_SSH_AGENT_NO_KEYS ]]; then
+        _log "Adding SSH key to agent"
+        ssh-add "$key_filename"
+      fi
+    else
+      eval "$(keychain --eval --quiet --agents ssh $key)"
+    fi
+
     break
   fi
 done

rc/wsl.sh

@@ -1,10 +0,0 @@
-function is_wsl()
-{
-  grep -q -i wsl /proc/version
-}
-
-if is_wsl; then
-  prepend_path_try "$HOME/.local/bin"
-  append_path_try "$HOME/.arkade/bin"
-  append_path_try "$HOME/.cargo/bin"
-fi