Contents

This section provides comprehensive reference documentation for the infra repository’s CLI tooling, automation, and structure.

Repository structure

• Repository Structure - Directory layout for deferred module composition + clan architecture

CLI tooling

Reference documentation for command-line tools and automation:

• Flake Apps - Reference for nix flake apps (darwin, os, home) that wrap configuration activation
• Justfile Recipes - Complete reference for all ~121 justfile recipes organized by functional group, with CI-tested indicators
• CI Jobs - GitHub Actions CI job reference with local equivalents and troubleshooting

Quick start

Common operations using the CLI tooling:

# Activate current machine (auto-detects platform)
just activate

# Preview changes before applying
just activate --dry

# Run all tests
just check

# Fast checks (skip VM tests)
just check-fast

# Build documentation
just docs-build

# View available recipes
just --list

Related documentation

For conceptual understanding and guides:

• Getting Started - Initial setup and onboarding
• Architecture overview - How the nix configuration is structured
• Clan Integration - Understanding clan integration
• CI Philosophy - Design principles behind the CI system