Your shell, but faster.

A complete shell environment that installs in one command.
Stop wasting time configuring zsh from scratch.

Quick Install
source <(curl -sL dotfiles.download/install)
macOS & Linux · v1.2.0
What is this

Dotfiles are configuration files that control your shell, git, editor, and dozens of other tools.

This project is a tested, optimized collection — not random configs from the internet, but a coherent setup where everything works together.

Performance

5x faster shell startup

Most zsh setups load everything at startup. We use lazy loading — tools initialize only when you use them.

Oh-My-Zsh
~800ms
Prezto
~500ms
~(iam) dotfiles
~150ms
What's included

Everything you need

Chezmoi — Sync dotfiles across machines. Starship — Smart, minimal prompt. fzf — Fuzzy finder for everything. zoxide — Smart cd that learns your habits

Plus Sheldon, ASDF, eza, bat, ripgrep, fd.

Why this

Built different

Fast

~150ms cold start. Lazy loading means instant prompts.

Cross-platform

Same config on macOS and Linux. Templates handle the rest.

One command updates

Packages, plugins, configs — all synced with one command.

Hackable

Clean structure. Easy to understand and extend.

See it in action

Interactive TUI

Everything managed through a beautiful terminal interface powered by gum.

Serotonin TUI Demo
Modular

Plugin Packs

Enable only what you need. Each pack adds tools, aliases, and completions for a specific workflow.

kubernetes Kubernetes

K8s cluster management

kubectl, kubectx, k9s, helm, stern
docker Docker

Container development essentials

docker-compose, lazydocker, dive, ctop
terraform Terraform

Infrastructure as code

terraform, tflint, terragrunt
aws AWS

Amazon Web Services

aws-cli, aws-vault, chamber
golang Go

Go development

go, golangci-lint, delve
nodejs Node.js

JavaScript development

npm, pnpm, yarn, bun
python Python

Python development

venv, pip, uv, ruff
rust Rust

Rust development

cargo, clippy, bacon
git Git Extras

Enhanced git workflow

lazygit, gh, delta
folder Dev Workspace

Organized ~/Dev structure

directory scaffold
ai Claude Code

Claude CLI aliases and helpers

claude, fix command
vscode VS Code

VS Code integration

code, extensions
nvim Neovim

Neovim with modern plugins

neovim, tree-sitter, LSP
terminal iTerm2

Tab colors and SSH helpers

tab labels, SSH connect
terminal tmux

Session management

tmux, sessions

Run serotonin list to see all available packs.

Customizable

Starship Themes

Choose from beautiful preset themes or create your own. Switch themes instantly.

~/projects/myapp main [+1] >
Minimal Essential info only, fast and clean
~/projects/myapp main +1 2.5s
Powerline Classic powerline-style segments
~/projects/myapp main v18.0.0 3.5s
Nerd Fonts Rich icons (requires Nerd Font)
~/projects/myapp main 2s
Pastel Soft, pastel color palette
~/projects/myapp main v18.0.0 1s
Gruvbox Warm retro groove colors
~/projects/myapp (main) +1m2 >
Plain Maximum terminal compatibility

Run serotonin themes to preview all themes.

Reference

Commands

Core Commands

dotfiles Open interactive TUI menu
dotfiles update Update all components
dotfiles doctor Diagnose environment health

Serotonin

serotonin init 60-second terminal setup
serotonin add <pack> Copy pack into your config
serotonin remove <pack> Remove a pack
serotonin list Available & installed packs

Themes

dotfiles themes Browse and apply Starship themes
dotfiles themes set <theme> Apply a theme

Backup & Restore

dotfiles backup create Create a backup
dotfiles backup restore Restore from backup

Tools

dotfiles benchmark Measure shell startup time
dotfiles secrets Manage encrypted secrets
Latest Changes

What's new in v1.2.0

and 4 more changes...

View full changelog →
View on GitHub