homelab-docs/SHELL-ALIASES.md

Shell Aliases & Shortcuts

Overview

ZSH aliases for quickly launching Claude Code in project directories with --dangerously-skip-permissions enabled. Aliases sync across devices via Syncthing.

Setup

File Locations

~/.config/shell/shared.zsh          # Main shared config (sourced by .zshrc)
~/.config/shell/claude-aliases.zsh  # Claude Code aliases
~/Projects/homelab/configs/         # Symlinks for reference

Installation

Add to ~/.zshrc:

source ~/.config/shell/shared.zsh

Claude Code Aliases

Quick Start (--continue)

Continue the most recent session in each project:

Alias	Directory	Command
chomelab	~/Projects/homelab	claude --dangerously-skip-permissions --continue
ctrading	~/Projects/ai-trading-platform	claude --dangerously-skip-permissions --continue
cnotes	~/Notes	claude --dangerously-skip-permissions --continue --ide
chome	~	claude --dangerously-skip-permissions --continue
cfindshyt	~/Desktop/findshyt-working-folder	claude --dangerously-skip-permissions --continue
ciconik	~/Projects/iconik-uploader	claude --dangerously-skip-permissions --continue
cghostty	~/.config/ghostty	claude --dangerously-skip-permissions --continue
cprojects	~/Projects	claude --dangerously-skip-permissions --continue
cclaudeui	~/Projects/claude-ui	claude --dangerously-skip-permissions --continue
clucid	~/Projects/lucidlink-upgrade	claude --dangerously-skip-permissions --continue
cbeeper	~/Projects/beeper	claude --dangerously-skip-permissions --continue

Resume (--resume)

Show list of sessions to pick from:

Alias	Directory
chomelab-r	~/Projects/homelab
ctrading-r	~/Projects/ai-trading-platform
cnotes-r	~/Notes
chome-r	~
ciconik-r	~/Projects/iconik-uploader
cbeeper-r	~/Projects/beeper

Fresh Start (no flags)

Start a new session without resuming:

Alias	Directory
chomelab-new	~/Projects/homelab
ctrading-new	~/Projects/ai-trading-platform
cnotes-new	~/Notes
chome-new	~

Usage Examples

# Continue homelab session
chomelab

# Pick from recent homelab sessions
chomelab-r

# Start fresh homelab session
chomelab-new

# Quick AI trading work
ctrading

Adding New Aliases

Edit ~/.config/shell/claude-aliases.zsh:

# Template for new project
alias cproject='cd ~/Projects/new-project && claude --dangerously-skip-permissions --continue'
alias cproject-r='cd ~/Projects/new-project && claude --dangerously-skip-permissions --resume'
alias cproject-new='cd ~/Projects/new-project && claude --dangerously-skip-permissions'

Changes sync automatically to all devices via Syncthing (~/.config folder).

Enterprise/Work Aliases (claude-gateway)

Use ec prefix for work Claude account via claude-gateway:

Quick Start (--continue)

Alias	Directory
echomelab	~/Projects/homelab
ectrading	~/Projects/ai-trading-platform
ecnotes	~/Notes
echome	~
ecfindshyt	~/Desktop/findshyt-working-folder
eciconik	~/Projects/iconik-uploader
ecghostty	~/.config/ghostty
ecprojects	~/Projects
ecclaudeui	~/Projects/claude-ui
eclucid	~/Projects/lucidlink-upgrade
ecbeeper	~/Projects/beeper

Resume & Fresh

• Resume: echomelab-r, ectrading-r, ecnotes-r, echome-r, eciconik-r, ecbeeper-r
• Fresh: echomelab-new, ectrading-new, ecnotes-new, echome-new

Full Alias File

Located at: ~/.config/shell/claude-aliases.zsh

# Claude Code Project Aliases

# Main projects
alias chome='cd ~ && claude --dangerously-skip-permissions --continue'
alias ctrading='cd ~/Projects/ai-trading-platform && claude --dangerously-skip-permissions --continue'
alias ciconik='cd ~/Projects/iconik-uploader && claude --dangerously-skip-permissions --continue'
alias cnotes='cd ~/Notes && claude --dangerously-skip-permissions --continue --ide'
alias chomelab='cd ~/Projects/homelab && claude --dangerously-skip-permissions --continue'
alias cfindshyt='cd ~/Desktop/findshyt-working-folder && claude --dangerously-skip-permissions --continue'
alias cghostty='cd ~/.config/ghostty && claude --dangerously-skip-permissions --continue'
alias cprojects='cd ~/Projects && claude --dangerously-skip-permissions --continue'
alias cclaudeui='cd ~/projects/claude-ui && claude --dangerously-skip-permissions --continue'
alias clucid='cd ~/Projects/lucidlink-upgrade && claude --dangerously-skip-permissions --continue'
alias cbeeper='cd ~/Projects/beeper && claude --dangerously-skip-permissions --continue'

# Resume variants
alias chome-r='cd ~ && claude --dangerously-skip-permissions --resume'
alias ctrading-r='cd ~/Projects/ai-trading-platform && claude --dangerously-skip-permissions --resume'
alias ciconik-r='cd ~/Projects/iconik-uploader && claude --dangerously-skip-permissions --resume'
alias cnotes-r='cd ~/Notes && claude --dangerously-skip-permissions --resume --ide'
alias chomelab-r='cd ~/Projects/homelab && claude --dangerously-skip-permissions --resume'
alias cbeeper-r='cd ~/Projects/beeper && claude --dangerously-skip-permissions --resume'

# Fresh start
alias chome-new='cd ~ && claude --dangerously-skip-permissions'
alias ctrading-new='cd ~/Projects/ai-trading-platform && claude --dangerously-skip-permissions'
alias cnotes-new='cd ~/Notes && claude --dangerously-skip-permissions --ide'
alias chomelab-new='cd ~/Projects/homelab && claude --dangerously-skip-permissions'