Skip to content

Commit b1b7085

Browse files
committed
install queue as a skill instead of documenting it in CLAUDE.md
The skill definition ships inside the mics-skills package, so agents discover usage from ~/.claude/skills/queue on demand. CLAUDE.md keeps only the policy line that long-running commands must go through queue.
1 parent af9991e commit b1b7085

2 files changed

Lines changed: 4 additions & 29 deletions

File tree

home-manager/modules/ai.nix

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,7 @@ in
8585
"kagi-search"
8686
"n8n-cli"
8787
"pexpect-cli"
88+
"queue"
8889
"screenshot-cli"
8990
];
9091
};
@@ -125,8 +126,6 @@ in
125126
aiTools.git-surgeon
126127
aiTools.jscpd
127128
pkgs.pueue
128-
# agent-friendly frontend for pueue
129-
micsSkillsPkgs.queue
130129
]
131130
++ lib.optionals pkgs.stdenv.isDarwin [
132131
selfPkgs.macprof

home/.claude/CLAUDE.md

Lines changed: 3 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -62,33 +62,9 @@
6262

6363
## Running programs
6464

65-
- CRITICAL: ALWAYS use `queue` for ANY command that might take longer than 10
66-
seconds to avoid timeouts. This includes but is not limited to:
67-
- `nix build` commands
68-
- `merge-when-green`
69-
- Any test runs that might be slow
70-
- Any build operations (make, ninja, cargo)
71-
72-
The command is read from stdin (heredoc), so quoting inside it never needs
73-
escaping. Output is streamed and the exit code is the command's exit code.
74-
```bash
75-
queue run <<'EOF'
76-
command arg1 "arg with spaces"
77-
EOF
78-
```
79-
Exit code 75 means still running; resume with `queue wait <id>` (id was
80-
printed as `task=<id>`). Useful subcommands:
81-
```bash
82-
queue status # one line per task; --json for scripts
83-
queue log <id> # full output so far + status, works while running
84-
queue ps <id> # pid, RSS, CPU of the task's process tree
85-
queue restart <id> # rerun a failed task without retyping the command
86-
queue kill <id>
87-
queue run --after <id> ... # start only after <id> succeeded
88-
queue run --tail-ok 20 ... # on success only show last 20 lines
89-
queue wait # barrier: wait for all my tasks
90-
```
91-
Never pipe queued commands through head/tail; use `queue log` instead.
65+
- CRITICAL: ALWAYS use the `queue` skill for ANY command that might take
66+
longer than 10 seconds (nix build, merge-when-green, test runs, make,
67+
ninja, cargo) to avoid tool timeouts.
9268

9369
## Search
9470

0 commit comments

Comments
 (0)