NixOS Config Quick Guide

This repo is organized for quick edits with minimal indirection.

Where to change things

• Host identity and feature toggles (Hydenix desktop): hydenix/configuration.nix
• Host identity and feature toggles (Nixarchy desktop): nixarchy/configuration.nix
• Host identity (WSL): wsl/configuration.nix
• Shared defaults for identity fields: common/modules/profile.nix
• Shared system packages: common/pkgs/
• Shared system modules/services: common/modules/
• Shared Home Manager modules: common/hm/
• Desktop system modules, shared by both desktops: hydenix/modules/system/
• Hydenix-only Home Manager modules: hydenix/modules/hm/
• Nixarchy Home Manager modules: nixarchy/modules/hm/

Feature toggles (desktop)

Set these under local.features in hydenix/configuration.nix or nixarchy/configuration.nix:

• browsers.enable -> hydenix/modules/system/browsers/
• gaming.enable -> hydenix/modules/system/gaming/
• gaming.vr.enable -> hydenix/modules/system/gaming/vr.nix
• work.enable -> hydenix/modules/system/work/
• work.syncthing.enable -> hydenix/modules/system/work/syncthing.nix

Module-owned config files

• Hyprland HM config files: hydenix/modules/hm/hyprland/ (Hydenix only)
• Kitty HM config file: nixarchy/modules/hm/kitty/ (Nixarchy only)
• Remmina HM config files: hydenix/modules/hm/remmina/
• Wolf HM config files: hydenix/modules/hm/wolf/
• L2TP NetworkManager profile: hydenix/modules/system/work/vpn/work.conf

Common commands

nix flake check --no-build
sudo nixos-rebuild switch --flake /etc/nixos#hydenix
sudo nixos-rebuild switch --flake /etc/nixos#nixarchy
sudo nixos-rebuild switch --flake /etc/nixos#wsl

Agent skills (per-project)

Skills are not installed globally. To activate in a project:

skills              # list available groups and sources
skills wiki         # install wiki skills to .opencode/skills/
skills obsidian-wiki  # install just obsidian-wiki skills

Skills are installed to ./.opencode/skills/ (add to .gitignore).

To add more skill sources or groups, edit config/skills.nix.

MCP servers (per-project)

MCP servers are not in the global opencode config. To activate in a project:

mcp                 # list available groups and servers
mcp svelte          # write svelte MCP config to opencode.json
mcp ui              # write daisyui + lucide-icons MCP config
mcp all             # write all MCP servers

Multiple mcp calls merge into opencode.json (deep merge via jq).

To add more MCP servers or groups, edit config/mcp.nix.