🌠 Stefanie's Dotfiles

Hey there! Welcome to my personal dotfiles repository! I'm Stefanie Jane, aka hyperb1iss—a creative technologist based in Seattle. These dotfiles create a powerful, beautiful development environment with a macOS-first focus that also works seamlessly across Linux and WSL2. Everything is tied together by the SilkCircuit color theme—a cyberpunk-inspired aesthetic with neon purples, electric cyans, and blazing pinks that flows through every tool.

🌟 Core Features

Feature	Description
🐚 Shell Environment	• Zsh with Zinit plugin management & Bash fallback • Atuin-powered shell history with cross-machine sync • 28 modular shell scripts with 100+ aliases • Smart platform detection & adaptation
🖥️ Terminal Setup	• Ghostty terminal with SilkCircuit theme • Tmux multiplexer with custom keybindings • Starship prompt with gradient theme • FZF-powered fuzzy finding everywhere
🤖 AI Integration	• Claude Code CLI for terminal AI pair programming • Avante.nvim for in-editor Claude assistance • Custom Claude Code status line & security hooks
🎨 SilkCircuit Theme	• silkcircuit-nvim Neovim colorscheme • Consistent theming across Neovim, Git, Starship, Tmux, Ghostty, Bat, Delta, Atuin, FZF, and more
🛠️ Development Tools	• AstroNvim v5 with full LSP for 11+ languages • Proto version manager (Node, Rust, pnpm) • Git workflow enhancements with Delta diffs • Docker & Kubernetes management
🌐 Cross-Platform	• macOS-first with Homebrew & DotBot automation • Linux (Ubuntu/Arch) full desktop & minimal server profiles • WSL2 with seamless path conversion • Windows PowerShell via HyperShell modules

🔧 Tool Suite

📊 Core Development

Tool	Description	Features
📝 AstroNvim v5	Neovim configuration	• IDE-like features • Avante.nvim AI assistant • SilkCircuit theme
👻 Ghostty	Terminal emulator	• GPU-accelerated • SilkCircuit theme • Native macOS/Linux
🚀 Starship	Cross-shell prompt	• SilkCircuit gradient theme • Git status integration • Context-aware
🖥️ Tmux	Terminal multiplexer	• Custom key bindings • SilkCircuit color scheme • Session management
🤖 Claude Code	AI pair programmer	• Custom status line • Security hooks • Project-aware assistance

🎯 Modern CLI Tools

Tool	Description	Features
🌳 FZF	Fuzzy finder	• File searching • History exploration • Command completion
📂 LSDeluxe	Modern ls	• Icon support • SilkCircuit colors • Tree view
🎨 Bat	Enhanced cat	• Syntax highlighting • SilkCircuit theme • Line numbering
🔍 Ripgrep	Fast searcher	• Code searching • Regular expressions • Ignore rules
🔀 Delta	Git diff viewer	• Syntax highlighting • Side-by-side diffs • SilkCircuit theme
⏪ Atuin	Shell history	• SQLite-backed • Cross-machine sync • Per-directory filtering
📌 Zoxide	Smart cd	• Learns your habits • Fuzzy matching • Instant directory jumps
🔧 Proto	Version manager	• Node, Rust, pnpm versions • Auto .prototools detection • Fast

🖼️ System & Customization

Tool	Description	Features
📊 Fastfetch	System info	• Fast system information • Performance metrics • Custom config
✨ shellint	Shell linter	• Shellcheck integration • Auto-fixing • Format with shfmt
🔧 DotBot	Config manager	• Automated setup • Cross-platform support • Profile management

📁 Repository Structure

dotfiles/
├── nvim/                 # AstroNvim v5 configuration (→ ~/.config/nvim)
│   └── lua/plugins/      #   Plugin configs (silkcircuit, avante, treesitter, …)
├── zsh/                  # Zsh configuration (zshrc + completion)
├── bash/                 # Bash configuration (profile + bashrc.local)
├── sh/                   # 28 modular shell scripts (git, docker, k8s, macos, …)
├── bin/                  # Utility scripts (shellint, diskclean, repo, …)
├── ghostty/              # Ghostty terminal config (macOS + Linux)
├── starship/             # Starship prompt with SilkCircuit gradient
├── tmux.conf             # Tmux multiplexer configuration
├── atuin/                # Atuin shell history + SilkCircuit theme
├── gitconfig             # Git config with SilkCircuit colors + Delta
├── proto/                # Proto version manager (.prototools)
├── claude/               # Claude Code settings, status line, security hooks
├── bat/                  # Bat syntax highlighting themes
├── lsd/                  # LSDeluxe file listing config
├── procs/                # Procs process viewer config
├── fastfetch/            # Fastfetch system info display
├── macos/                # macOS setup (Brewfile, system prefs, Karabiner)
├── hypershell/           # Windows PowerShell modules
├── docs/                 # VitePress documentation site
├── Makefile              # Install, lint, and format targets
└── *.yaml                # DotBot install manifests (macos, local, system, …)

🔤 Installing Nerd Fonts

Nerd Fonts are required for proper icon display in the terminal. These are not automatically installed by dotbot. Follow these steps to install them:

1. Visit the Nerd Fonts website
2. Download your preferred font (I recommend JetBrainsMono Nerd Font)
3. Extract the downloaded zip file
4. Install the fonts:
   • On Windows: Right-click on each .ttf file and select "Install"
   • On macOS: Double-click each .ttf file and click "Install Font"
   • On Linux: Copy the .ttf files to ~/.local/share/fonts/ and run fc-cache -fv
5. Configure your terminal to use the installed Nerd Font

For WSL2 users, make sure to set the Nerd Font in your Windows Terminal settings as well.

🛠️ Installation

Linux/WSL2

# Clone the repository
git clone https://github.com/hyperb1iss/dotfiles.git ~/dev/dotfiles

# Install everything
cd ~/dev/dotfiles
make

macOS

# Option 1: Using the installer script
bash -c "$(curl -fsSL https://raw.githubusercontent.com/hyperb1iss/dotfiles/main/install_macos.sh)"

# Option 2: Manual installation
# Clone the repository
git clone https://github.com/hyperb1iss/dotfiles.git ~/dev/dotfiles

# Install everything
cd ~/dev/dotfiles
make macos

Windows

# Clone the repository
git clone https://github.com/hyperb1iss/dotfiles.git $env:USERPROFILE\dev\dotfiles

# Install as administrator
cd $env:USERPROFILE\dev\dotfiles
.\install.ps1

🚀 Deep Dive

🐚 Shell Environment

The shell environment provides a unified experience across Bash and Zsh:

# Modern CLI Usage Examples
ls                # Beautiful file listings with icons
ll                # Detailed list view
lt                # Tree view of directories
bat script.sh     # Syntax-highlighted file viewing
z projects        # Smart directory jumping
fzf               # Fuzzy find files or history

Key Features:

• Unified configuration across Bash and Zsh with Zinit plugin management
• Enhanced history with timestamps and duplicate removal
• Intelligent tab completion with fuzzy finding
• Directory jumping with z command and bookmarking system
• Git worktree manager (gwt) with comprehensive subcommands
• Interactive FZF functions for files, processes, and Docker
• Cross-platform environment variables and platform detection

📱 Android Development

Comprehensive tooling for AOSP and device development:

# Environment Setup
envsetup                     # Initialize build environment
lunch aosp_pixel-userdebug   # Select build target

# Building
mka bacon                    # Optimized build command
installboot                  # Smart boot image installation

# Device Management
logcat                      # Smart device selection
apush system.img            # Intelligent file pushing
aospremote                  # Configure AOSP remote
cafremote                   # Configure CAF remote

# Navigation
gokernel                    # Jump to kernel directory
govendor                    # Jump to vendor directory
goapps                      # Jump to packages/apps

Key Features:

• Automated build environment setup
• Smart device detection and management
• Performance-optimized build commands
• Comprehensive udev rules
• Quick navigation aliases

🪟 WSL2 Integration

Seamless Windows and Linux integration:

# Path Conversion
wslpath "C:\Users\Stefanie"  # Convert Windows to WSL path
wslopen ~/projects           # Open WSL path in Windows Explorer

# Navigation
cdw                         # Jump to Windows user directory

# File Operations
apush file.txt              # Smart file pushing to Android
extract archive.tar.gz      # Smart archive extraction

Key Features:

• Seamless path conversion
• File system integration
• Shared Git configuration
• WSL backup utilities
• Cross-platform clipboard support

🤖 HyperShell (PowerShell)

A Linux-like experience for Windows PowerShell:

# Linux-style Commands
ls --tree         # Directory tree with icons
grep "pattern"    # Search with ripgrep
which code        # Find executable paths

# Docker Management
dex container     # Interactive container selection
dlog container    # View container logs
dstop container   # Stop containers

Key Features:

• Modular architecture with 13 specialized modules
• Linux command aliases using GNU tools
• Kubernetes support with kubectl aliases and k9s
• Zoxide for smart directory navigation
• Android development utilities
• HyperShell branding with SilkCircuit theme
• Advanced FZF integration and Docker management

🤖 AI Integration

The environment includes AI coding assistance at two levels:

Claude Code CLI — Terminal AI pair programming:

• Custom SilkCircuit status line showing git, language versions, and context
• Security hooks for safe command execution
• Project-aware assistance with custom AGENTS.md configuration
• Integrated directly into the terminal workflow

Avante.nvim — In-editor AI assistance:

• Configured with Claude Sonnet 4 for intelligent code suggestions
• Interactive sidebar with diff-based edits and conflict resolution
• Context-aware suggestions within your Neovim editing session

🎨 Theming System - SilkCircuit

The environment features the custom SilkCircuit color scheme, a cyberpunk-inspired theme with neon accents:

Color Preview	Name	Hex Code	Usage
	Background	#1a1a2e	Terminal background, deep space purple
	Neon Magenta	#ff00ff	Current branches, prompts, highlights
	Electric Cyan	#00ffff	Local branches, help text, dates
	Bright Magenta	#ff79c6	Changed files, authors, remote branches
	Yellow	#ffdc00	Branch decorations, code files
	Green	#50fa7b	Added files, executables
	Red	#ff5555	Deleted files, errors
	Purple	#c792ea	Keywords, tmux accents

The SilkCircuit theme is powered by silkcircuit-nvim—a standalone Neovim colorscheme plugin with 5 variants (neon, vibrant, soft, glow, dawn), 30+ plugin integrations, and WCAG AA accessibility compliance. It's loaded as a local plugin from ~/dev/silkcircuit-nvim and also provides extras for environment-wide theming.

The theme is consistently applied across the entire environment:

• Neovim - Full theme via silkcircuit-nvim with 30+ plugin support
• Ghostty - Terminal emulator with SilkCircuit colors
• Git - Custom log formatting with silkcircuit pretty format
• Starship Prompt - SilkCircuit gradient theme with powerline segments
• Tmux - Status bar with purple and pink accents
• Atuin - Shell history UI themed with SilkCircuit palette
• FZF / fzf-tab - Fuzzy finder with SilkCircuit color scheme
• LSDeluxe - File type colors matching the theme
• Bat - Custom SilkCircuit.tmTheme for syntax highlighting
• Delta - Git diff viewer with themed colors
• Claude Code - Custom status line with SilkCircuit RGB colors

🔄 Updating

To update the dotfiles repository:

cd ~/dev/dotfiles
git pull
make  # For Linux/WSL2
# Or
.\install.ps1  # For Windows (run as administrator)

🤝 Contributing

Got ideas for improvements? Found a bug? Feel free to:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

🚀 Other Projects

If you like these dotfiles, you might be interested in some of my other projects:

• silkcircuit-nvim: The cyberpunk Neovim colorscheme that powers this environment — 5 variants, 30+ integrations, extras for terminals, Git, VSCode, and more
• git-iris: AI-accelerated git workflow tool
• contexter: Chrome extension and CLI for quickly copying code into LLMs
• signalrgb-homeassistant: SignalRGB integration for Home Assistant
• signalrgb-python: Python API client for SignalRGB Pro
• hyper-light-card: Custom card for controlling SignalRGB through Home Assistant
• aeonsync: An rsync backup tool for developers

📜 License

This project is open source and available under the MIT License.

---

Created by Stefanie Jane 🌠

If you find these dotfiles helpful, buy me a Monster Ultra Violet! ⚡️