Where Things Live on Disk
Reference table:
| Path (macOS) | Path (Linux) | Purpose |
|---|---|---|
/Library/Locai/versions/<v>/ | ~/.local/share/locai/versions/<v>/ | Frozen runtime bundle for version <v>. |
/Library/Locai/current | ~/.local/share/locai/current | Symlink / pointer to the active version. |
/Library/Locai/configs/session_*.json | ~/.local/share/locai/configs/session_*.json | Device identity + api_key (0600 perms). |
/Library/Locai/models/ | ~/.local/share/locai/models/ | Downloaded model files. |
/Library/Locai/state/ | ~/.local/share/locai/state/ | Runtime state (pipeline configs, in-flight tracking). |
/Library/Locai/logs/ | ~/.local/share/locai/logs/ | Log files (link.*.log; service.log for the background service). |
~/Library/LaunchAgents/uk.co.locai.link.companion.plist | ~/.config/systemd/user/locai-link-companion.service | The single background service (as of 1.3.0, one service supervises everything). |
/Applications/Locai Link.app | ~/.local/share/applications/locai-link.desktop | The Locai Link app (tray, Preferences, and first-run setup in one). |
As of 1.3.0 there is one app and one service — the separate Setup Assistant and its second service no longer exist; upgrades remove any leftovers automatically.
On headless installs, everything lives under the per-user install root: service logs are in logs/service.log on macOS and Windows, and on Linux the headless service (locai-link-headless.service) logs to the systemd journal (journalctl --user -u locai-link-headless.service).
You should never need to edit any of these files by hand. Everything is controlled through the app, the locai command, or Locai Control.