The ~/.tyrn folder
The Tyrn backend keeps its files in ~/.tyrn. Settings, key bindings and themes are elsewhere, in ~/.config/tyrn.
Layout
| Path | What it holds |
|---|---|
run/ |
The backend socket, process id and lock file. |
logs/ |
daemon.log and router.log. |
harnesses/<id>/ |
Installed harness versions. |
runtimes/ |
Node and Python that Tyrn installed for harnesses. |
plugins/ |
Installed plugins. |
plugin-details/ |
Details Tyrn reads from plugins. |
connectors/ |
Connector setup. Secrets are in the macOS Keychain, not here. |
subagents/ |
Your subagents. |
roles/ |
Your roles. |
defaults/<harness>.json |
Per-harness defaults for new sessions. |
sessions/<id>/ |
Settings Tyrn generated for each session. |
router/credentials/ |
Provider keys and tokens. Files are readable only by your user account. |
sources/ |
Cloned plugin repositories. |
catalog/ |
Cached harness and marketplace listings. |
project-worktrees.json |
Worktrees Tyrn knows about for your projects. |
Logs
Logs are in ~/.tyrn/logs. In the sidebar, open the daemon menu and choose Show daemon log to open daemon.log. See Troubleshooting for what to send with a bug report.
What is safe to delete
Quit Tyrn and choose Stop daemon first, so nothing is using the files.
| Delete | What happens |
|---|---|
logs/ |
Nothing lost. New logs are written. |
catalog/ |
Tyrn downloads the listings again. |
sources/ |
Plugin repositories are cloned again when needed. |
runtimes/ |
Tyrn installs Node or Python again the next time a harness needs it. |
harnesses/<id>/ |
That harness is uninstalled. Install it again from Settings > Agents > Harnesses. |
sessions/<id>/ |
Generated settings for that session. Don’t delete these for a session you still want to resume. |
router/credentials/ |
You lose the provider keys and tokens you added. Add them again in Settings > Inference. |
roles/, subagents/, plugins/, defaults/ |
You lose your own roles, subagents, installed plugins and harness defaults. |
To remove everything, see Uninstall.