dotfiles

Prerequisites

Before running the dotfiles installation script, you need to install the following tools and dependencies:

1. Core System Tools

Homebrew (macOS Package Manager)

# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# For Apple Silicon Macs (M1/M2/M3/M4), add to PATH
echo 'export PATH=/opt/homebrew/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

# Verify installation
brew --version

Git

# macOS (via Homebrew)
brew install git

# Ubuntu/Debian
sudo apt update && sudo apt install git

# Verify installation
git --version

Zsh & Oh-My-Zsh

# Install Zsh
# macOS
brew install zsh

# Ubuntu/Debian
sudo apt install zsh

# Make Zsh default shell
chsh -s $(which zsh)

# Install Oh-My-Zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# Install Powerlevel10k theme
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

# Install essential plugins
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

2. Development Languages & Runtimes

Node.js & npm

# Install nvm (Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.zshrc

# Install latest LTS Node.js
nvm install --lts
nvm use --lts

# Verify installation
node --version
npm --version

Rust & Cargo

# Install Rust via rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

# Verify installation
rustc --version
cargo --version

Python & Pyenv & Poetry & UV

# Install pyenv
curl https://pyenv.run | bash

# Install Poetry via pipx
sudo apt install pipx  # Ubuntu/Debian
pipx install poetry

# Configure Poetry
poetry config virtualenvs.in-project true
poetry config virtualenvs.prefer-active-python true

# Install UV (extremely fast Python package manager)
# Using standalone installer (recommended)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or using pipx
pipx install uv

# Or using Homebrew on macOS
brew install uv

# Verify installation
pyenv --version
poetry --version
uv --version

3. Development Tools

tmux

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

# Verify installation
tmux -V

Lazygit

# macOS
brew install lazygit

# Ubuntu/Debian
sudo add-apt-repository ppa:lazygit-team/daily
sudo apt update
sudo apt install lazygit

# Verify installation
lazygit --version

GitHub CLI

# macOS
brew install gh

# Ubuntu/Debian (Official APT Repository - Recommended)
(type -p wget >/dev/null || (sudo apt update && sudo apt install wget -y)) \
&& sudo mkdir -p -m 755 /etc/apt/keyrings \
&& out=$(mktemp) && wget -nv -O$out https://cli.github.com/packages/githubcli-archive-keyring.gpg \
&& cat $out | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
&& sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
&& sudo mkdir -p -m 755 /etc/apt/sources.list.d \
&& echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
&& sudo apt update \
&& sudo apt install gh -y

# Authenticate with GitHub
gh auth login

# Verify installation
gh --version

Neovim

# macOS
brew install neovim

# Ubuntu/Debian
sudo apt install neovim

# Verify installation
nvim --version

Direnv

# macOS
brew install direnv

# Ubuntu/Debian
sudo apt install direnv

# Add to shell configuration
echo 'eval "$(direnv hook zsh)"' >> ~/.zshrc
source ~/.zshrc

# Verify installation
direnv --version

Terraform

# macOS
brew install terraform

# Ubuntu/Debian
wget -O- https://apt.releases.hashicorp.com/gpg | gpg --dearmor | sudo tee /usr/share/keyrings/hashicorp-archive-keyring.gpg > /dev/null
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
sudo apt update && sudo apt install terraform

# Verify installation
terraform --version

4. AI Development Tools

Claude Code

# Install Claude Code globally
npm install -g @anthropic-ai/claude-code

# Verify installation
claude --version

LiteLLM Proxy (OpenRouter Integration)

# No installation needed - uses uvx for isolated execution
# Set up your OpenRouter API key at: https://openrouter.ai/keys

# Quick start - launches Claude Code with OpenRouter models
cclitellm                                    # Uses default qwen3-coder
cclitellm openrouter/anthropic/claude-3-5-sonnet   # Use specific model

# Development environment with tmux
cclitedev                                    # Default model in tmux
cclitedev openrouter/meta-llama/llama-3.2-90b-vision-instruct  # Specific model

# Manual proxy management
litellm-start    # Start LiteLLM proxy in background
litellm-stop     # Stop LiteLLM proxy

Features:

Wildcard Routing: Supports all OpenRouter models without specific configuration
Background Operation: Runs in tmux session litellm-server for non-blocking operation
Auto-Start: cclitellm/cclitedev commands automatically start proxy if needed
Model Flexibility: Choose from 100+ models (Anthropic, Meta, Google, Qwen, etc.)
See: ~/.dotfiles/litellm/README.md for detailed configuration and model examples

OpenCode CLI

# Install OpenCode CLI
curl -fsSL https://opencode.ai/install | bash

# Or using Homebrew on macOS
brew install sst/tap/opencode

# Verify installation
opencode --version

1Password CLI (Environment Variable Injection)

# Install 1Password CLI
# macOS
brew install 1password-cli

# Ubuntu/Debian
curl -sS https://downloads.1password.com/linux/keys/1password.asc | sudo gpg --dearmor --output /usr/share/keyrings/1password-archive-keyring.gpg
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/1password-archive-keyring.gpg] https://downloads.1password.com/linux/debian/amd64 stable main' | sudo tee /etc/apt/sources.list.d/1password.list
sudo apt update && sudo apt install 1password-cli

# Verify installation
op --version

# Sign in to your 1Password account
op signin

# Store your API keys in 1Password with these paths:
# - GROQ_API_KEY at op://Personal/Dev-API-KEY/groq-api-key
# - OPENROUTER_API_KEY at op://Personal/Dev-API-KEY/openrouter-api-key

# Test API key retrieval
op read op://Personal/Dev-API-KEY/groq-api-key
op read op://Personal/Dev-API-KEY/openrouter-api-key

# The dotfiles automatically inject these keys into Claude Code Router configuration

5. Optional Tools

Emacs (for Spacemacs)

# macOS
brew install emacs

# Ubuntu/Debian
sudo apt install emacs

# Verify installation
emacs --version

Bun (JavaScript Runtime)

# Install Bun
curl -fsSL https://bun.sh/install | bash

# Verify installation
bun --version

Installation Guide

After installing all prerequisites, run the dotfiles installation script:

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

Setup Github

# copy ssh key to clipboard for adding to github.com
pbcopy < ~/.ssh/id_rsa.pub

# test connection
ssh -T git@github.com

Install Spacemacs

git clone https://github.com/syl20bnr/spacemacs ~/.emacs.d
apt-get install emacs

Configure tmux

Modern tmux configuration with ergonomic key bindings and visual improvements:

# Configuration is managed in dotfiles
ln -sf ~/.dotfiles/.tmux.conf ~/.tmux.conf

# Reload configuration in existing tmux session
tmux source-file ~/.tmux.conf

# Codex CLI configuration
mkdir -p ~/.codex
ln -sf ~/.dotfiles/openai-codex/config.toml ~/.codex/config.toml

Key Features:

Prefix key: Ctrl+a (instead of Ctrl+b)
Split panes: Ctrl+a | (horizontal) and Ctrl+a - (vertical)
Navigate panes: Alt+arrows or Ctrl+a hjkl
Reload config: Ctrl+a r
Mouse support enabled
Tokyo Night color scheme

AI-Powered Development Environments

Claude Code Development Environment

The ccdev function creates a tmux development environment optimized for Claude Code:

Claude Code + LiteLLM Development Environment

The cclitellm and cclitedev functions provide Claude Code integration with OpenRouter models via LiteLLM proxy:

# Direct launch with auto-proxy start
cclitellm                                    # Default qwen3-coder model
cclitellm openrouter/anthropic/claude-3-5-sonnet   # Specific model

# Development environment in tmux
cclitedev                                    # Default model
cclitedev openrouter/google/gemini-2.0-flash-thinking-exp my-session

# Features:
# - Auto-starts LiteLLM proxy if not running
# - Background tmux operation (litellm-server session)
# - Health checks and automatic recovery
# - Access to 100+ OpenRouter models
# - View logs: tmux attach -t litellm-server

Popular Model Examples:

openrouter/qwen/qwen3-coder (default, good for coding)
openrouter/anthropic/claude-3-5-sonnet (high quality)
openrouter/meta-llama/llama-3.2-90b-vision-instruct (vision capable)
openrouter/google/gemini-2.0-flash-thinking-exp (fast reasoning)
openrouter/deepseek/deepseek-coder (specialized coding)

Claude Code Router Development Environment

The ccrcode function creates a tmux development environment with Claude Code Router, featuring dynamic config generation with 1Password API key injection.

Prerequisites: Requires 1Password CLI for API key management (see installation instructions above).

# Install Claude Code first
npm install -g @anthropic-ai/claude-code

# Launch Claude development environment
ccdev [session-name]

# If no session name provided, uses current directory name
ccdev my-project

# Install Claude Code Router first
npm install -g @musistudio/claude-code-router

# Launch Claude Code Router development environment
ccrcode [session-name]

# Automatically generates config with API keys from 1Password
# Uses: op read op://Personal/Dev-API-KEY/openrouter-api-key
#       op read op://Personal/Dev-API-KEY/groq-api-key
# If no session name provided, uses current directory name
ccrcode my-project

OpenCode CLI Development Environment

The opendev function creates a tmux development environment with OpenCode CLI:

# Install OpenCode CLI first
curl -fsSL https://opencode.ai/install | bash

# or Using Homebrew on macOS

brew install sst/tap/opencode

# Launch OpenCode development environment
opendev [session-name]

OpenAI Codex CLI Development Environment

The codexdev function creates a tmux development environment with the OpenAI Codex CLI:

# Install OpenAI Codex CLI first (requires bun)
bun install -g @openai/codex

# Launch Codex development environment
codexdev [session-name]

All environments create a multi-pane workspace with:

Top-Left pane (55% width): Lazygit for version control
Bottom-left pane (55% width): Development server
Right pane (45% width): AI assistant (Claude, OpenCode, or Codex)

Name		Name	Last commit message	Last commit date
Latest commit History 107 Commits
.github/workflows		.github/workflows
claude		claude
git		git
lazygit		lazygit
litellm		litellm
nvim		nvim
openai-codex		openai-codex
opencode		opencode
scripts		scripts
soundtrack		soundtrack
.gitignore		.gitignore
.gitmodules		.gitmodules
.spacemacs		.spacemacs
.tmux.conf		.tmux.conf
.zshrc		.zshrc
LICENSE		LICENSE
README.md		README.md
install.sh		install.sh

License

memorysaver/dotfiles

Folders and files

Latest commit

History

Repository files navigation