docs(limits): state when the 462 ceiling holds; skill docs follow CODEMAN_MAX_SESSIONS

The tab layout's 512 refs also count pinned sessions kept as stopped records, so
the ceiling holds at the default MAX_WEBVIEWS and with no pinned closed sessions.
SKILL.md, verbs.md (both copies) and the cron guide no longer give a fixed 50/25.

Co-Authored-By: Christian Haberl <116439789+christianhaberl@users.noreply.github.com>
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
committed 2026-10-21 10:18:23 +02:00
1 parent f17aa047d0
commit c3fa6d8923
7 files changed
+18 -12

No files matched your search

+3 -2
View File
@@ -666,8 +666,9 @@ You are yourself a session on this server, and the API has **no undo**.
user's repository state, so say that you did; **removing** one discards any
uncommitted work inside it, so ask first ([§5.1](reference/verbs.md#51-where-to-spawn)).
- Never `tmux kill-session`, `pkill tmux`, `pkill claude`. The API is the only interface.
- Sessions count against a **global cap of 50** (and, in multi-user mode, a per-user
cap of 25 that fires the same 409). Case creation is uncapped and writes real
- Sessions count against a **global cap, 50 by default** (`CODEMAN_MAX_SESSIONS`), and,
in multi-user mode, a per-user cap (half the global cap, 25 by default) that fires
the same 409. Case creation is uncapped and writes real
directories. Clean up every session you start, and never retry `quick-start` in a
loop.
@@ -101,8 +101,9 @@ Differences from `quick-start` worth knowing before you debug one:
- hitting the session cap here is `OPERATION_FAILED`, where `quick-start` returns
`SESSION_BUSY` for the identical condition.
`quick-start` failure codes are `SESSION_BUSY` (the global 50-session cap, or the
per-user cap of 25 in multi-user mode), `FORBIDDEN`, `CONFLICT`, `NOT_FOUND` (a
`quick-start` failure codes are `SESSION_BUSY` (the global session cap, 50 by default via
`CODEMAN_MAX_SESSIONS`, or the per-user cap in multi-user mode, half the global cap,
25 by default), `FORBIDDEN`, `CONFLICT`, `NOT_FOUND` (a
remote or docker host named by the case no longer exists), `OPERATION_FAILED` and
`INVALID_INPUT`. **None of them are retryable in a loop.** Always branch on
`.success` before reading `.data.sessionId`: on failure the field is absent, `jq -r`