> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt
> Use this file to discover all available pages before exploring further.

# v0.5.10

> 2026-05-09

## Bug Fixes

* **`git add -f .trellis/` runaway prevented.** `add_session.py` and `task.py archive` now stage only specific Trellis-owned paths (journal, `index.md`, active task dir, archive subtree) and auto-retry with `git add -f -- <specific-paths>` only when stderr matches `ignored by`. The fallback warning explicitly states `Do NOT use \`git add -f .trellis/\``, listing`.trellis/.backup-\*`,`.trellis/worktrees/`,`.trellis/.template-hashes.json`,`.trellis/.runtime/`,`.trellis/.cache/`as the paths to keep ignored. Helper centralized in`templates/trellis/scripts/common/safe\_commit.py\`.
* **Pi platform `<workflow-state>` / `<session-overview>` / subagent dispatch protocol injection.** Pi extension now injects the `[workflow-state:STATUS]` breadcrumb on every `input` and `before_agent_start` event, plus a `<session-overview>` block from `.trellis/scripts/get_context.py`. The `subagent` tool registration carries a `promptSnippet` with the `Active task: <path>` dispatch protocol. Closes [#249](https://github.com/mindfold-ai/Trellis/issues/249).
* **Pi `npm:pi-subagents` project-level isolation.** `.pi/settings.json` now contains a project-level `packages` entry overriding `npm:pi-subagents` with empty resource lists, so a globally-installed `npm:pi-subagents` cannot inject `extensions / skills / prompts / themes` into the current Trellis project. `scrubPiSettings` reverses the override on `trellis uninstall`. Closes [#246](https://github.com/mindfold-ai/Trellis/pull/246) (thanks @RenaLio).

## Upgrade

```bash theme={null}
npm install -g @mindfoldhq/trellis@latest
trellis update
```