docs: daily update 2026-08-03 — release v4.167.0

[deco-cms]

Release evaluated

v4.166.2...v4.167.0 (2 substantive commits, after excluding release-bump and homebrew-cask-bump noise).

Commits covered (warranted a doc change)

• #5620 feat(native): reclaim a branch's worktree when its last chat is archived — commit 3dfabb576. Archiving the last open chat/thread on a branch in the Studio Native desktop app now offers to stop everything running on that branch and delete its local git worktree. This is a new, directly user-visible confirmation dialog and workflow, gated to the desktop app.

Commits skipped (reviewed, no doc change)

• #5616 fix(runtime): propagate StudioKV write/delete failures instead of swallowing them — commit 20f623162. Internal reliability fix: a failed trigger-config persist now surfaces as an error instead of silently reporting success. No documented behavior changes — automations.mdx never claimed persistence always succeeds, so there's nothing to correct, and this doesn't introduce a new option or workflow worth documenting.

(All other commits in the raw log between the two tags were [release]: bump changed workspace versions and [chore]: bump homebrew cask to ... — excluded per the bot's own filtering rules.)

Files changed

• apps/docs/client/src/content/deco-studio/en/studio/agents.mdx — added a paragraph under Studio Native: coding-agent terminals explaining that opening a branch clones a local working tree, and that archiving the last open thread on a branch now offers to reclaim (stop + delete) it.
• apps/docs/client/src/content/deco-studio/pt-br/studio/agents.mdx — same addition, translated (pt-br auto-translated; code, product terms or UI labels kept in English per the standing translation rules).

Consistency notes

• Checked overview.mdx, concepts.mdx, quickstart.mdx, and architecture.mdx for references to branch worktrees, the desktop app's local sandbox lifecycle, or archiving — no matches, no changes needed there.
• agents.mdx's "Where an agent runs" section was already rewritten in the still-open predecessor PR (see below) to describe the sandbox as fully managed with no local/deco link runtime; the new paragraph was placed instead under the newer Studio Native section (branches/worktrees/threads), which is the section that already matches this feature's actual surface area. No other stale cross-references found.

Dependency note

This PR is stacked on top of the still-open #5594 (docs/auto-update-2026-08-03-release-4.163.0), since that was the most recently created open docs/auto-update-* PR at run time. Please merge #5594 first, then this one, to avoid conflicts in agents.mdx.

---

🤖 Automated daily docs check, triggered by the studio.released webhook for v4.167.0 (previous release: v4.166.2).

---

Summary by cubic

Docs update for v4.167.0. Adds Studio Native behavior that offers to stop processes and delete a branch’s local worktree when you archive the last open thread on that branch.

• New Features

  • Studio Native: documented that opening a branch creates a local worktree, and archiving the last thread now offers to reclaim it (stop everything on that branch and delete the local files). Desktop app only; does not touch the branch or remote.

• Dependencies

  • Stacked on the previous docs auto-update for v4.163.0; merge that first to avoid conflicts in agents.mdx.

^{Written for commit 4dfdfb5. Summary will update on new commits.}