Personal workstation · documented publicly

A workstation I can rebuild.¶

This repository rebuilds my Apple Silicon macOS workstation and continuously tests the shared setup in Ubuntu 24.04 ARM64. Ansible, the automation engine, configures the system; chezmoi, the dotfile manager, puts the files in place.

Read the setup guide → Browse the repository ↗

Targets: macOS + Ubuntu
Automation: Ansible
Dotfiles: chezmoi

What it builds¶

The result is an opinionated terminal-first environment built around fish, tmux, Alacritty, Neovim, mise, Git tools, and a curated set of command-line utilities. On macOS, it also installs desktop applications and applies personal system defaults.

How the pieces fit together¶

01
Bootstrap
scripts/setup.sh detects the platform and prepares the supported installation path.
02
Install prerequisites
On Ubuntu, the script installs the required apt packages; on both targets, it prepares Homebrew and Ansible.
03
Configure the workstation
Ansible runs focused roles for packages, fonts, fish, mise, Neovim, Rancher Desktop, tmux, and system defaults.
04
Apply the dotfiles
chezmoi renders the files in config/ for the current operating system and architecture.

Choose what you need¶

01 · Start here Set up or customize a machine

Review the changes, choose an installation path, and learn how to reapply the configuration.

02 · Reference Find a keyboard shortcut

Look up bindings for macOS, Alacritty, fish, tmux, and Neovim.

03 · AI tooling Configure OpenCode + OmO

Set up local secrets, corporate overlays, model routing, and contextual notifications.

Design principles¶

Repeatable over clever: Repeated runs should converge on the same state.
Visible over magical: Package lists, roles, and managed files stay in the repository.
Portable where practical: Shared behavior works on macOS and the Ubuntu integration environment; platform-specific changes stay explicit.
Personal by design: This is a working environment, not a universal starter kit.