Modular, idempotent, cross-platform dotfiles with just orchestration.
bash -c "$(curl -fsSL https://raw.githubusercontent.com/memorysaver/dotfiles/main/bootstrap.sh)"Or manually:
git clone https://github.com/memorysaver/dotfiles.git ~/.dotfiles cd ~/.dotfiles just setup
| Recipe | Tools |
|---|---|
just core |
zsh, oh-my-zsh, tmux, starship, nvim, lazygit, direnv |
just runtimes |
pyenv, uv, nvm, Node.js, Bun, Rust |
just agents |
Claude Code, Codex CLI, OpenCode, Pi |
just tools |
gh, glab, jq, yq, just, agent-browser, portless |
just infra |
Terraform, Pulumi, SST (opt-in, not in default setup) |
~/.dotfiles/
├── bootstrap.sh # One-command entry point
├── justfile # Task runner (just setup, just link, etc.)
├── lib/helpers.sh # Shared idempotent utilities
├── install/ # Categorized install scripts
│ ├── core.sh
│ ├── runtimes.sh
│ ├── agents.sh
│ ├── tools.sh
│ └── infra.sh
├── config/ # App configs (symlinked to ~)
│ ├── zsh/
│ ├── tmux/
│ ├── git/
│ ├── starship/
│ ├── nvim/
│ └── lazygit/
├── agents/ # AI tool configs (symlinked to ~)
│ ├── claude/
│ ├── codex/
│ ├── opencode/
│ └── pi/
└── env/ # Environment config
├── .env.example
└── .envrc.template
just setup # Full setup: core + runtimes + agents + tools + link just link # Create all config symlinks (idempotent) just unlink # Remove all symlinks just infra # Install infrastructure tools (opt-in) just --list # Show all available recipes
direnv uses per-project .envrc files. A template is provided:
# Copy the template into any project cp ~/.dotfiles/env/.envrc.template ~/my-project/.envrc # Customize it, then allow: cd ~/my-project && direnv allow
For API keys, copy the example env file into your project and use dotenv_if_exists in your .envrc:
cp ~/.dotfiles/env/.env.example ~/my-project/.env
Test the full setup in an isolated Linux container without touching your host machine.
# Build the image (runs all install scripts + verifies symlinks/commands) bash docker/docker-test.sh # Build and drop into a zsh shell bash docker/docker-test.sh --run # Force a clean rebuild (no cache) bash docker/docker-test.sh --no-cache # Launch a shell into an existing image docker run --rm -it memorysaver-dev # Run in background and attach multiple shells docker run -d --name dev memorysaver-dev sleep infinity docker exec -it dev zsh docker stop dev && docker rm dev
The build itself runs verify.sh which checks all 15 symlinks and 20 commands — if anything is broken, the build fails.
- Shell: zsh + oh-my-zsh + starship prompt
- Editor: Neovim (LazyVim)
- Git: lazygit TUI + gh/glab CLIs
- Terminal: tmux with Tokyo Night theme
- AI Agents: Claude Code, Codex, OpenCode, Pi
- Shared Skills: authored once under
agents/skills/and installed for Claude Code, Codex, and Pi - Dev Envs:
ccdev,opendev,codexdev— tmux sessions with lazygit + AI agent
Shared skills live under agents/skills/<skill-name>/ and are the single source of truth for:
- Claude Code via
~/.claude/skills/<skill-name> - Codex via
~/.codex/skills/<skill-name> - Pi via
~/.pi/agent/skills/<skill-name>
Pi also receives a thin settings file at ~/.pi/agent/settings.json so skill discovery is explicit and stable.
Use just validate-skills to verify that every shared skill:
- has required frontmatter
- uses a directory name that matches the skill name
- only references files that actually exist
- avoids harness-specific paths in the shared core
MIT