Skip to content

opensite-ai/opensite-skills / linux-dev-workstation

linux-dev-workstation

Flagged

Configure a senior-grade Linux development environment on the machine: GPU drivers and compute stacks (NVIDIA CUDA, AMD ROCm, Intel XPU, Apple Silicon/Asahi), shell and terminal (zsh/fish, starship, modern CLI tools, tmux/zellij), advanced editor setup (Neovim/Vim, VS Code, Zed), language toolchains for Rust, Python, Ruby, and JavaScript/TypeScript via mise/uv/pixi, Docker/Podman containers, reproducible declarative setup (chezmoi, Ansible, Nix/home-manager), and security hardening (SSH keys, commit signing, secrets, firewall, backups). Use when setting up or upgrading a Linux dev box, installing GPU drivers, managing language versions and updates, configuring editors or dotfiles, or making a workstation reproducible. It runs commands on the machine.

templates/chezmoi-layout.md

View on GitHub
# chezmoi Dotfiles Repo Layout

A recommended layout for a `dotfiles` repo managed by
[chezmoi](https://chezmoi.io) (source of truth in git; `chezmoi apply` renders
into `$HOME`). Replace `youruser` with your own values — never commit real
secrets in plaintext.

## Bootstrap a fresh machine

```bash
sh -c "$(curl -fsLS https://get.chezmoi.io)" -- init --apply youruser
# later, on any machine:
chezmoi update        # git pull + re-apply
chezmoi doctor        # sanity check
```

## Repo structure

```
dotfiles/                          # your git repo (the chezmoi source dir)
├── .chezmoi.toml.tmpl             # prompts for machine-specific data on init
├── .chezmoiignore                 # paths to skip per-OS/host
├── dot_zshrc                      # -> ~/.zshrc
├── dot_gitconfig.tmpl             # -> ~/.gitconfig (templated per machine)
├── dot_tmux.conf                  # -> ~/.tmux.conf
├── dot_config/
│   ├── starship.toml              # -> ~/.config/starship.toml
│   ├── nvim/                      # -> ~/.config/nvim/ (or track upstream separately)
│   ├── ghostty/config             # -> ~/.config/ghostty/config
│   └── mise/config.toml           # -> ~/.config/mise/config.toml (global tools)
├── private_dot_ssh/
│   └── config.tmpl                # -> ~/.ssh/config (0600; never commit keys)
├── run_once_before_10-install-packages.sh.tmpl   # runs once, before apply
├── run_onchange_after_20-mise-install.sh.tmpl     # re-runs when its hash changes
└── encrypted_private_secrets.env.age              # age-encrypted, safe to commit
```

## Naming conventions (chezmoi attributes)

| Prefix | Meaning |
|--------|---------|
| `dot_` | becomes a leading `.` (`dot_zshrc` → `~/.zshrc`) |
| `private_` | file mode `0600` (owner-only) |
| `.tmpl` | rendered as a Go template (per-OS/host values) |
| `run_once_` | script runs once per machine (bootstrap installs) |
| `run_onchange_` | script re-runs when its contents change |
| `encrypted_` | decrypted on apply (age/gpg) — safe to commit ciphertext |

## Templating example (per-OS values)

```gotmpl
# dot_gitconfig.tmpl
[user]
    name = Your Name
    email = {{ .email }}
{{- if eq .chezmoi.os "linux" }}
[credential]
    helper = cache --timeout=3600
{{- end }}
```

## Secrets

Use `encrypted_` files with **age** (see references/security-hardening.md) or
reference a password manager (`{{ onepasswordRead "op://..." }}`). Never commit
plaintext tokens or private keys. Pair chezmoi (user dotfiles) with an Ansible
playbook (system packages) — see templates/ansible-workstation.yml.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall