docs: weekly update for PRs merged 2026-08-12 to 2026-08-19

Merged
KI
3mo ago
+59-9

Summary

Weekly docs update per the Weekly Docs Update SOP, covering user-facing changes from PRs merged 2026-08-12 to 2026-08-19, plus a staleness pass reworking text those PRs invalidated. Every UI label, status string, and command was verified against renderer/host source, not PR descriptions. All edited files pass the new Vale prose rules (PR #6579) at zero errors and warnings.

New / updated, by driving PR

  • usage.mdx (new page, in Core Features nav): the Usage tab was fully ungated and undocumented. Covers per-account Claude Code/Codex quota meters with refresh cadence (#6530), the Token usage / Machine resources pill sections and the live resources view (#6567), multi-account profiles: Add account, Make default, Switch sign-in, Remove (#6585), the copyable sign-in command on expired accounts (#6628), cost analytics (API-rate estimates, model table, workspace drilldowns), and the Check Resources hotkey.
  • agent-integration.mdx: interrupted agent sessions now resume automatically (#6572). Replaced the documented Resume banner/button with the "Resuming…" pill, the exactly-once guarantee, the deliberate-kill exclusion, and the failure Retry/dismiss UI. Dropped the stale banner screenshot.
  • automations.mdx: the detail page's single schedule picker is now a Triggers list (#6534, #6542): multiple schedules per automation, Add Trigger, at-least-one-trigger rule, explicit Save triggers / Discard. Corrected the preset label to Custom (was "Custom RRule…") and documented the new rejections for exhausted and COUNT/UNTIL rules (#6618). Per-row "would run" preview wording updated.
  • workspaces.mdx: Board is the default layout; documented the Filter / Display menus, the Pinned filter (#6561), per-lane visibility toggles with their URL/persistence caveats (#6568), empty Merged/Deleted lane auto-hide, and sidebar auto-placement of CLI/automation-created sessions (#6558).
  • first-workspace.mdx: staleness fix found during verification: the "Auto-run command" toggle no longer exists in the new-workspace flow (it lives on the tasks surfaces only).

Deliberately skipped

  • Event trigger providers (GitHub, Slack, Linear, Notion, Sentry, Teams, Google, Circleback, webhook: #6539, #6586-#6597, #6619-#6631): gated to internal accounts by the automation-event-triggers flag; regular users see Scheduled only and the server rejects unlaunched kinds.
  • New-workspace screen work (#6537, #6540, #6556, #6575): flag-gated to new accounts; the prompt-cards experiment never launched. Only the cosmetic "Default model"/"Default effort" pill relabel is ungated.
  • Self-documented PRs: #6519 and #6646 already updated browser.mdx, skills.mdx, and the CLI reference.
  • #6636 loopback bind: docs already said "Binds to 127.0.0.1 only"; the code was fixed to match.
  • Mobile PRs (#6596, #6651, #6656, and friends): docs have no mobile section yet; the FAQ's "mobile app is in progress" line may need an owner decision on release status.
  • Bugfixes restoring documented behavior, perf work, marketing pages, and internal db/api/refactor changes.

Testing

  • bun run --cwd apps/docs typecheck (compiles all MDX): clean
  • bun run lint:fix then bun run lint: exit 0
  • bunx vale --config=vale.ini --minAlertLevel=warning over all five touched files: 0 errors, 0 warnings

Known Limitations

  • usage.mdx ships without a screenshot: no beautified Usage tab shot exists in apps/marketing/public/changelog/ yet. Can add one once the next changelog run captures it.

Summary by cubic

Adds a Usage docs page and updates automations, agent sessions, and workspaces docs to match the shipped UI. Behavior changes: interrupted agent sessions auto‑resume (was banner + Resume), automations use multi‑schedule triggers with explicit Save (was single Schedule), and Board is the default workspace layout.

  • Usage: new page in nav with a screenshot; Claude Code/Codex quota meters (5‑minute refresh), multi‑account profiles (Add, Make default, Switch sign‑in, Remove), expired sign‑in copy command, token‑cost analytics (vs subscription $0), and a live Machine resources view with a hotkey.
  • Agent sessions: replace the “interrupted” banner + Resume button with automatic resume and a “Resuming…” pill; only unexpected deaths qualify; on failure, show Retry and dismiss. Removed the old banner screenshot.
  • Automations: single Schedule replaced by a Triggers list on the detail page. Supports multiple schedules, requires at least one trigger, and adds explicit Save triggers/Discard. “Custom RRule…” is now “Custom”. Rejects invalid/no‑upcoming‑run and COUNT/UNTIL rules. Paused “would run” preview clarified. Times use your timezone at creation.
  • Workspaces: Board is now the default. Adds Filter/Display menus, a Pinned filter, per‑lane visibility toggles (board‑only, not in URL, reset on restart), auto‑hide for empty Merged/Deleted lanes (when Archived is Hidden), and one‑time auto‑placement of CLI/automation‑created sessions in the sidebar.
  • First workspace: removes the stale Auto‑run toggle from the new‑workspace flow; that toggle lives on tasks surfaces.
  • Skipped: event trigger providers remain undocumented; gated behind the automation-event-triggers flag.

Summary by CodeRabbit

  • Documentation
    • Clarified automatic agent resumption and failure controls after interrupted sessions.
    • Expanded automation guidance for time zones, multiple triggers, editing, validation, pausing, and limits.
    • Clarified agent selection and immediate startup when creating a workspace.
    • Added Usage documentation covering local data, quotas, token-cost estimates, and machine-resource monitoring.
    • Added Usage to the documentation navigation.
    • Updated workspace layout guidance, including automatic session placement, Board views, filters, sorting, archiving, and lane visibility.