From 3d704dfaf5d5fbba82a6987a384841cf713627b9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Torjus=20H=C3=A5kestad?= <torjus@usit.uio.no>
Date: Tue, 3 Feb 2026 23:37:31 +0100
Subject: [PATCH] docs: add indexing performance notes to CLAUDE.md

Document expected indexing times so appropriate timeouts are used:
- nixos-options: ~5-6 minutes for nixos-unstable
- hm-options: ~1-2 minutes for master

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 CLAUDE.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 1120268..b254e93 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -223,3 +223,10 @@ nix run .#hm-options -- serve
 nix run .#nixos-options -- index nixos-unstable
 nix run .#hm-options -- index hm-unstable
 ```
+
+### Indexing Performance
+Indexing operations are slow due to Nix evaluation and file downloads. When running index commands, use appropriate timeouts:
+- **nixos-options**: ~5-6 minutes for `nixos-unstable` (with files)
+- **hm-options**: ~1-2 minutes for `master` (with files)
+
+Use `--no-files` flag for faster indexing (~1-2 minutes) if file content lookup isn't needed.