🌠 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:

Visit the Nerd Fonts website
Download your preferred font (I recommend JetBrainsMono Nerd Font)
Extract the downloaded zip file
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
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:

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:

Fork the repository
Create a feature branch
Make your changes
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! ⚡️

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

🌠 Stefanie's Dotfiles

🌟 Core Features

🔧 Tool Suite

📊 Core Development

🎯 Modern CLI Tools

🖼️ System & Customization

📁 Repository Structure

🔤 Installing Nerd Fonts

🛠️ Installation

Linux/WSL2

macOS

Windows

🚀 Deep Dive

🐚 Shell Environment

📱 Android Development

🪟 WSL2 Integration

🤖 HyperShell (PowerShell)

🤖 AI Integration

🎨 Theming System - SilkCircuit

🔄 Updating

🤝 Contributing

🚀 Other Projects

📜 License

Uh oh!

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

🌠 Stefanie's Dotfiles

🌟 Core Features

🔧 Tool Suite

📊 Core Development

🎯 Modern CLI Tools

🖼️ System & Customization

📁 Repository Structure

🔤 Installing Nerd Fonts

🛠️ Installation

Linux/WSL2

macOS

Windows

🚀 Deep Dive

🐚 Shell Environment

📱 Android Development

🪟 WSL2 Integration

🤖 HyperShell (PowerShell)

🤖 AI Integration

🎨 Theming System - SilkCircuit

🔄 Updating

🤝 Contributing

🚀 Other Projects

📜 License