GettingStarted

Getting Started

Learn about Griffin and how it can streamline your development setup

What Griffin Is

Griffin is one developer's Linux and macOS workstation, expressed as an Ansible playbook. A fresh install becomes a working environment in a single command, and the same command keeps an existing machine up to date.

It is shared because it is useful to read and fork — not as a general-purpose provisioner. The tool choices and dotfiles are opinionated and personal.

What You Get

A configured shell: Zsh with Powerlevel10k, Antidote plugins, and a curated set of modern CLI tools.
Working development tooling: Git, editors, containers, and language toolchains behind feature flags.
Desktop configuration: KDE and Cinnamon tweaks, fonts, and themes on Linux; Homebrew Casks on macOS.
Repeatability: Every task is idempotent, so re-running updates rather than breaks.

If You're Forking

Start with tool_sets in post-installation/defaults/main.yaml — it is the single source of truth for installed software. Swap the dotfiles under post-installation/defaults/, then iterate.

Powered by Ansible

Griffin leverages the power of Ansible, a leading automation tool known for its simplicity and flexibility. Ansible's declarative approach and vast module library make it the perfect engine for automating your Linux configuration.