dotfiles

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #claude-code #cli #windows #codex #developer-tools #dsh

★ 15 Open GitHub ↗

Cross-platform workstation config: signed Bluefin bootc image, declarative NixOS, automated macOS, and shared chezmoi dotfiles.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# dotfiles 🌸

Personal Spectrum/Bluefin, NixOS, and macOS workstation configuration, built
with Homebrew, Nix, Ansible, and chezmoi.

> [!IMPORTANT]
> This is my personal setup. It is public for reference, not a universal installer.

## What's here

- **Spectrum / Bluefin:** custom bootc image and desktop setup
- **NixOS:** declarative system and user configuration
- **macOS:** Homebrew and Ansible bootstrap
- **Everywhere:** shared dotfiles managed by chezmoi

## Shell composition

```text
.bashenv ─┐
.zshenv ──┴─> environment.sh

.bashrc ────> bashrc.d/*.bash ─┐
                               ├─> interactive.common.sh
.zshrc  ───>  zshrc.d/*.zsh   ─┘      └─> interactive.d/*.sh
```

## Setup

Clone the repository first:

```bash
git clone https://github.com/4evy/dotfiles.git ~/dotfiles
cd ~/dotfiles
```

### Spectrum / Bluefin

From a fresh Bluefin install:

```bash
sudo bootc switch ghcr.io/4evy/spectrum:latest
systemctl reboot
```

After rebooting:

```bash
cd ~/dotfiles
just setup
```

### NixOS

From an installed NixOS system:

```bash
sudo nixos-rebuild \
  --option extra-substituters https://install.determinate.systems \
  --option extra-trusted-public-keys cache.flakehub.com-3:hJuILl5sVK4iKm86JzgdXW12Y2Hwd5G07qKtHTOcDCM= \
  --flake .#nixos \
  switch
just setup
```

The extra cache options are only needed for the first rebuild. Later rebuilds
can use:

```bash
sudo nixos-rebuild switch --flake .#nixos
```

### macOS

```bash
./ansible/bootstrap.sh --tags userland
just setup
```

## Everyday commands

Run `just` or `just --list` for the complete recipe list.

```bash
just setup          # Bootstrap and apply everything
just update         # Update userland, dotfiles, and host setup
just apply          # Apply chezmoi dotfiles only
just status         # Show Spectrum image status

just spectrum-validate # Validate the BlueBuild recipe and base digest
just spectrum-build    # Build Spectrum locally
just spectrum-inspect  # Inspect and test the local image

just fmt            # Format the repository
just lint           # Run static checks
just check          # Run the full validation suite
```

For direct Nix work:

```bash
nix develop
nix flake check
nix run .#ghidra-mcp
```

## License

[LICENSE](LICENSE)

dotfiles

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README