agents.md
This commit is contained in:
31
AGENTS.md
Normal file
31
AGENTS.md
Normal file
@@ -0,0 +1,31 @@
|
||||
# AGENTS.md
|
||||
|
||||
## ⚠️ VERSION CONTROL: JUJUTSU (jj) ONLY
|
||||
**NEVER run git commands.** This repo uses Jujutsu (`jj`). Use `jj status`, `jj diff`, `jj commit`, etc.
|
||||
|
||||
## Build Commands
|
||||
```bash
|
||||
nix run .#build # Build current host config
|
||||
nix run .#build -- <hostname> # Build specific host (chidi, jason, michael, mindy, tahani)
|
||||
nix run .#apply # Build and apply locally (darwin-rebuild/nixos-rebuild switch)
|
||||
nix flake check # Validate flake
|
||||
|
||||
# Remote NixOS deployment (colmena)
|
||||
colmena build # Build all NixOS hosts
|
||||
colmena apply --on <host> # Deploy to specific NixOS host (michael, mindy, tahani)
|
||||
colmena apply # Deploy to all NixOS hosts
|
||||
```
|
||||
|
||||
## Code Style
|
||||
- **Formatter**: Alejandra with tabs (run `alejandra .` to format)
|
||||
- **Function args**: Destructure on separate lines `{inputs, pkgs, ...}:`
|
||||
- **Imports**: Use relative paths from file location (`../../profiles/foo.nix`)
|
||||
- **Attribute sets**: One attribute per line, trailing semicolons
|
||||
- **Lists**: `with pkgs; [...]` for packages, one item per line for long lists
|
||||
|
||||
## Structure
|
||||
- `hosts/<name>/` - Per-machine configs (darwin: chidi, jason | nixos: michael, mindy, tahani)
|
||||
- `profiles/` - Reusable program/service configs (imported by hosts)
|
||||
- `modules/` - Custom NixOS/darwin modules
|
||||
- `lib/` - Shared constants and utilities
|
||||
- `secrets/` - SOPS-encrypted secrets (`.sops.yaml` for config)
|
||||
Reference in New Issue
Block a user