CROSS-PLATFORM · 2026

dotfiles

A modern, opinionated developer environment for Mac, Linux, and WSL — fully automated, reproducible, and built for speed.

By — Updated

Quick Install View on GitHub
One-liner Install
bash -c "$(curl -fsSL https://raw.githubusercontent.com/hironow/dotfiles/main/install.sh)"
Tool Stack

Modern CLI Arsenal

Hand-picked tools that work in harmony across every shell session.

Zsh
Powerful interactive shell with rich plugin ecosystem
Mise
Polyglot runtime manager — Node, Python, Go and more
Just
Modern command runner with clean, readable justfiles
uv
Blazing-fast Python package manager written in Rust
Sheldon
Fast, lock-file-based Zsh plugin manager
Starship
Minimal, fast cross-shell prompt with rich context
fzf
General-purpose fuzzy finder for the terminal
Ghostty
GPU-accelerated terminal emulator, native speed
Features

Everything Included

From shell configuration to AI agent integration — batteries included.

Cross-Platform Support
Works natively on macOS, Linux distributions, and Windows Subsystem for Linux without modification.
macOS Linux WSL
Task Runner
Unified task automation via just — consistent commands for install, deploy, test, and sync.
just help just install just deploy
Package Management
Mise handles runtime versions; uv manages Python packages. Reproducible environments guaranteed.
mise uv lock files
Shell Configuration
Opinionated Zsh setup with Sheldon for plugins and Starship for a beautiful, informative prompt.
zsh sheldon starship
MCP Servers
Model Context Protocol server integration for AI-powered workflows directly from your terminal environment.
MCP AI agents automation
Skills & Plugins
Extensible plugin marketplace system for adding capabilities and integrations to your development workflow.
plugins skills extensible
Quick Usage

Common Commands

All operations go through just — one interface to rule them all.

just help · Display all available commands and their descriptions
just install · Bootstrap the full environment on a new machine
just deploy · Apply dotfile changes to the current system
just test · Run the full test suite to validate configuration
just sync-agents · Synchronize AI agent configurations and MCP servers
Status & Info
CI: passing Shell: Zsh Platform: cross-platform License: MIT Powered by: mise · uv · just MCP: enabled