# Caudra 0.2 Preview 4

[v0.2.0-preview.4 on GitHub](https://github.com/caudra/caudra/releases/tag/v0.2.0-preview.4)

- Hover tooltips.
- The workbench explorer shows Caudra's own files and folders you choose.
- Narrower permission scopes for commands that take paths.
- xAI sign-in works again.

> **Important**
>
> **After you update, restart every running Caudra session**, including sessions in other projects. Preview 3 cannot read saved permissions once one of the new folder scopes is remembered. The session database is not upgraded.

## Interface

- **Hover tooltips.** Rest the mouse on a footer chip, a composer or queue control, the to-do list header, an icon, or text that is cut short, and a tooltip explains it or shows the whole text. A paste token previews its first lines. Set `tooltips = false` under `[ui]` to turn tooltips off.
- **More in the workbench explorer.** A `CAUDRA` section lists your configuration, plans, memory notes, and in a local session your scratch files. A `FOLDERS` section holds any folder on this machine that you add with `Ctrl+X d` or with Add Folder on a section header. Each section folds, resizes, and scrolls on its own. Search, `Ctrl+P`, and source control still cover only the project.

## Permissions

- **Scopes that stop at a folder.** When you remember an answer for a command with a path in it, the scope choices now include its folders. For `gh api repos/acme/tool/issues`, you can allow `gh api repos/acme/tool/*` up to `gh api repos/*`. Patterns you write yourself can end the same way. Shells, interpreters, and other commands that run code get no such scopes.

## Agent

- **A reminder to act after repeated compactions.** When one request has been compacted twice and no work has started, Caudra reminds the agent to make its first change, write its plan, or report. Change the threshold with `work_nudge_compactions` under `[agent]`, or set it to `0` to turn the reminder off.

## Worktrees and Herdr

- **Labeled Herdr tabs.** When `/worktree` creates a worktree inside Herdr, the new tab and pane carry the branch name. If the session's old tab was the last one in its pane, Caudra now exits there and leaves the pane at its shell.
- **Fewer blocked moves.** A pending revert in an unrelated old conversation no longer stops a move to another directory or worktree, and `/worktree` names the session in the way before it creates the checkout. Moves also no longer fail with "storage writer operation timed out" while other Caudra processes are busy.

## Fixes

- **xAI sign-in works again.** Requests over an xAI login no longer fail with HTTP 426. If xAI raises its minimum client version again before the next release, set `CAUDRA_XAI_CLIENT_VERSION` to the version the error names.
- **`caudra -p` reports failures in its exit status.** A print run whose result is an error now exits with status 1 in every output format.
- **Plan mode with small models.** Models that never search for the `plan` tool can now save their plan.
