dotfiles/docs/index.mdx

---
title: dots
description: prdlk's dotfiles, managed with chezmoi. One command installs chezmoi and applies the whole setup.
sidebar:
  label: Overview
  icon: house
---

```sh
curl -fsSL https://dots.prd.lk/install | sh
```

That command installs chezmoi to `~/.local/bin`, clones [prdlk/dotfiles](https://github.com/prdlk/dotfiles), asks three questions (name, email, machine role), installs packages, and applies every config. See [Installation](/installation) for the options, prerequisites, and the private-repo auth step.

## What's managed

<CardGroup cols={2}>
  <Card title="How it works" href="/chezmoi" icon="settings">
    chezmoi layout, machine roles, symlink mode, age encryption, package manifests, apply scripts, and externals.
  </Card>
  <Card title="Shell" href="/shell" icon="terminal">
    fish, bash, and zsh with shared aliases, starship, atuin, and the `~/.local/bin` scripts.
  </Card>
  <Card title="Terminal" href="/terminal" icon="square-terminal">
    kitty, ghostty, tmux, and herdr.
  </Card>
  <Card title="Tools" href="/tools" icon="wrench">
    git, gh and gh-dash, neovim, yazi, lazygit, lazydocker, bat, topgrade, hunk, and more.
  </Card>
  <Card title="Desktop" href="/desktop" icon="monitor">
    niri with noctalia, Hyprland with the omarchy helpers, waybar, fonts, and default apps.
  </Card>
  <Card title="AI agents" href="/ai" icon="bot">
    Claude Code, omp, and the shared agent skill library.
  </Card>
</CardGroup>

## Machine roles

The first apply asks for a role. It controls which parts of the repo land on the machine.

| Role | Platform | Gets |
| --- | --- | --- |
| `desktop` | Arch Linux | Everything: universal toolset plus the Linux desktop layer |
| `laptop` | Arch Linux | Same as `desktop` |
| `mac` | macOS | Universal toolset via Homebrew; no Linux desktop layer |
| `server` | Any | Universal toolset only |

The default is `mac` on macOS and `desktop` everywhere else. See [Configuration](/chezmoi/config) and [Ignore rules](/chezmoi/externals-and-ignore).

## Theme

The shared palette is **cyberdream**, fixed rather than tied to the Omarchy theme so it is identical on every machine. Ghostty, tmux, nvim, bat, atuin, and yazi select it, and television selects `cyberdream-transparent`, a variant without a background. fish and omp ship a cyberdream theme but do not select it. kitty takes its colors from the active Omarchy theme. The koda and ii-auto variants are also shipped for ghostty, kitty, and yazi. The font is **Victor Mono Nerd Font**.