docs / Usage
Workspace trust
What Shuvarie may read out of your workspace, and how it remembers.
On the first run in a workspace, Shuvarie scans it for things it could load and asks what to trust:
| Category | What it covers |
|---|---|
| Contexts | AGENTS.override.md, AGENTS.md, CLAUDE.md (in that precedence), plus .shuvarie/context/* |
| Skills | Skills in .agents/skills |
| Configs | shuvarie.kdl, .shuvarie/config.kdl, scene.d/*.kdl, themes.d/*.kdl |
The prompt shows checkboxes (all pre-checked). Keys: ↑/↓ or j/k select, Space toggles, a trusts all, n trusts none,
Decisions persist in ~/.config/shuvarie/trusts.kdl. A trusted workspace
loads silently on later runs, re-prompting only when new files show up in
a category you hadn’t granted. shuvarie --config <file> sidesteps the
Configs category entirely.
Opening a tab never prompts: a key press must not yank the terminal into a dialog. The new workspace’s recorded decision is used when it has one, and otherwise the tab inherits the grants the startup workspace was given.