✦ Lucy Edgerunner+ Dotfiles

Cyberpunk Edgerunners-themed development environment
Neovim · Zsh · Tmux · Starship

---

Preview

_{Lucy greeting · lucy identity card · Starship λ prompt with git status · syntax-highlighted command line}

---

Quick Install

git clone --recurse-submodules https://github.com/kyuna0312/dotfiles ~/dotfiles
cd ~/dotfiles && bash install.sh

Or directly, without cloning:

# curl
sh -c "$(curl -fsSL https://raw.githubusercontent.com/kyuna0312/dotfiles/main/install.sh)"

# wget
sh -c "$(wget -qO- https://raw.githubusercontent.com/kyuna0312/dotfiles/main/install.sh)"

Re-link only (skip package installs): bash install.sh --skip-packages
With pentest tools: bash install.sh --security

---

What's Included

Component	Config path	Description
Zsh	home/.zshenv → config/zsh/.zshrc + lib/	Modular OS-split shell; Lucy greeting, fzf, zoxide, lazy NVM
Starship	config/starship/starship.toml	λ prompt, Lucy Edgerunner+ palette, OS badge, git status
Neovim	config/nvim/ → NyanVim	Personal Neovim config (git submodule)
Tmux	config/tmux/tmux.conf	TPM, vim pane nav, sakura/cyan status bar, session restore
Git	config/git/delta.gitconfig	Delta pager with Lucy syntax colors
Nushell	config/nushell/	λ and ❮ prompt indicators, custom env
Atuin	config/atuin/config.toml	Encrypted shell history sync
Security	config/zsh/lib/security.zsh	Pentest alias layer (sectools for reference)

---

OS Support

OS	Package manager	Notes
Arch / Manjaro	pacman + paru (AUR)	Full support
Debian / Ubuntu	apt	bat→batcat, fd→fdfind aliased automatically
macOS	Homebrew	Aerospace, Sketchybar, Hammerspoon, Karabiner

---

Color Palette — Lucy Edgerunner+

Name	Hex	Role
Void	#0a0a14	background
Surface	#11111e	panels, tmux bg
Sakura	#ff6bba	primary accent, active borders
Neon Cyan	#00e5ff	secondary accent, clock, links
Lavender	#c8a5ff	git, builtins, audio
Mint	#9dffcc	paths, CPU, success
Gold	#ffd97d	time, memory, warnings
Rose	#ff4d8d	errors, critical, temp high
Text	#f0e6ff	foreground

---

Shell Features

Zsh uses ZDOTDIR=~/.config/zsh (set by home/.zshenv), so all zsh config lives under config/zsh/. Plugins are managed by Sheldon (config/sheldon/plugins.toml).

Lucy Zsh Layer (config/zsh/lib/lucy.zsh)

Sourced last, after syntax highlighting. Provides:

Command	Description
lucy	Identity card with system info
jack-in <host>	Styled SSH wrapper
flatline <name>	Kill process by name (pkill -f)
breach [dir]	cd into directory then open $EDITOR
ghost	Browse history with fzf and re-run
ports	Open listening ports (ss -tulnp)

dp-tools (alias netrunner-tools) prints the CLI stack reference card — defined in config/zsh/lib/common.zsh.

Security Layer (config/zsh/lib/security.zsh)

Auto-loaded when nmap or burpsuite is detected. Run sectools for a quick reference.

Category	Tools
Network	nmap, nse, nnmap, sniff, sniffport
Web	bsuite, sqlm, nik
Passwords	jtr, hcat
Reverse Eng	ghidra-launch, r2
CTF	b64d, b64e, hexdump-clean, rot13

---

Configuration

Git identity

Put user-specific git config in ~/.gitconfig.local (not tracked):

[user]
    name = Your Name
    email = you@example.com
    signingkey = GPGKEYID

[commit]
    gpgsign = true

NVM lazy loading

nvm, node, npm, npx are stub functions — NVM loads on first call to keep shell startup fast. Run nvm once to initialize.

Kubectl completion

Set CYBERPUNK_KUBECTL_COMPLETION=0 to disable kubectl completion (removes startup latency when kubectl is installed but not actively used).

Tmux plugins

On first launch, install TPM plugins:

Start tmux → Ctrl+I

Neovim

On first launch, sync all plugins:

nvim → :Lazy sync

---

Directory Structure

dotfiles/
├── install.sh              # thin linker (packages + symlinks)
├── lib/link.sh             # symlink + logging helpers
├── home/                   # files linked to $HOME
│   ├── .zshenv             # sets ZDOTDIR=~/.config/zsh
│   └── .bashrc             # minimal bash fallback
├── config/                 # mirrors ~/.config, linked dir-by-dir
│   ├── zsh/
│   │   ├── .zshrc          # zsh entrypoint
│   │   └── lib/
│   │       ├── common.zsh  # shared: aliases, fzf, nvm, zoxide
│   │       ├── linux.zsh   # Linux: tmux auto-attach, EDITOR, security
│   │       ├── macos.zsh   # macOS specifics
│   │       ├── lucy.zsh    # Lucy layer: greeting, themed helpers
│   │       └── security.zsh # pentest alias layer
│   ├── sheldon/plugins.toml # zsh plugin manifest (Sheldon)
│   ├── starship/starship.toml
│   ├── nvim/               # NyanVim (git submodule)
│   ├── tmux/tmux.conf
│   ├── git/delta.gitconfig
│   ├── bat/config
│   ├── nushell/
│   └── atuin/
├── installers/             # per-distro package installers
│   ├── arch.sh
│   ├── debian.sh
│   └── macos.sh
├── packages/               # package lists (edit to add tools)
│   ├── arch-base.txt
│   ├── arch-security.txt
│   └── ...
├── macos/                  # special link target (~/)
├── scripts/
│   └── apply-theme.sh      # hot-reload all running apps
└── assets/                 # README images (preview.png, logo.png)

---

Prerequisites

• git, zsh, curl
• Recommended: neovim, tmux, starship, fzf, eza

---

Lucy Kushinada — Netrunner Online
_{built with ✦ and neon pink}