diff --git a/README.md b/README.md
index 5785e3f..0b592ac 100644
--- a/README.md
+++ b/README.md
@@ -2,34 +2,9 @@
 
 NixOS configuration for my Framework 12 laptop aka chi. Everything here is subject to change, and is for my own personal use.
 
-## pulling this config to a new system
-
-1. Install NixOS and make sure flakes are enabled:
-   ```bash
-   nix-shell -p git
-   ```
-
-2. Clone the repo:
-   ```bash
-   git clone https://tangled.org/did:plc:n3llrvji3acb32lmu424ujqy nixos-config
-   cd nixos-config
-   ```
-
-3. If the target hardware differs from `chi`, regenerate the hardware config:
-   ```bash
-   sudo nixos-generate-config --root /mnt --show-hardware-config > hardware-configuration.nix
-   ```
-   On an already-running NixOS system, you can also copy the generated file from `/etc/nixos/hardware-configuration.nix`.
-
-4. Optional: link it into `/etc/nixos`:
-   ```bash
-   sudo ln -s $(pwd) /etc/nixos
-   ```
-
-5. Apply the configuration:
-   ```bash
-   sudo nixos-rebuild switch --flake .#chi
-   ```
+## notes
+
+See [`notes.md`](notes.md) for setup details, the opencode + Kimi integration, and other misc notes about this machine.
 
 ## opencode + kimi for coding
 
diff --git a/notes.md b/notes.md
index 3c9a3a9..91cc5ea 100644
--- a/notes.md
+++ b/notes.md
@@ -1,5 +1,34 @@
 # notes
 
+## pulling this config to a new system
+
+1. Install NixOS and make sure flakes are enabled:
+   ```bash
+   nix-shell -p git
+   ```
+
+2. Clone the repo:
+   ```bash
+   git clone https://tangled.org/did:plc:n3llrvji3acb32lmu424ujqy nixos-config
+   cd nixos-config
+   ```
+
+3. If the target hardware differs from `chi`, regenerate the hardware config:
+   ```bash
+   sudo nixos-generate-config --root /mnt --show-hardware-config > hardware-configuration.nix
+   ```
+   On an already-running NixOS system, you can also copy the generated file from `/etc/nixos/hardware-configuration.nix`.
+
+4. Optional: link it into `/etc/nixos`:
+   ```bash
+   sudo ln -s $(pwd) /etc/nixos
+   ```
+
+5. Apply the configuration:
+   ```bash
+   sudo nixos-rebuild switch --flake .#chi
+   ```
+
 ## opencode-kimi-full
 
 URL: https://github.com/lemon07r/opencode-kimi-full