Configuration
Orrery's configuration lives in a plain TOML file at ~/.config/orrery/config.toml, editable from Settings or by hand. The cache and AI data live separately under ~/.local/share/orrery/.
Settings sections
The Settings screen switches sections from the sidebar:
Workspace roots — directories scanned for git repos, scan depth, and ignore globs.
Launchers — IDE and terminal-agent presets (see Launchers).
GitHub — connect for higher rate limits and private-repo enrichment.
AI & search — inference backend (Ollama or the bundled llama.cpp engine), models, and the cache control (see Local AI).
Notifications — which background events raise a desktop notification (see Notifications & tray).
Appearance — Theme picks System, Dark or Light. System (the default) follows your desktop's light/dark preference from the XDG portal and switches live when you change it; with no desktop preference it stays dark. The choice applies and saves the moment you click it (no Save needed), as
theme = "dark"ortheme = "light"(absent means System). Either theme borrows your desktop's accent colour; in light mode a pale accent is deepened until it's readable on the light background. The window frame and the tray icon belong to your desktop, so they follow its colour scheme rather than Orrery's theme.Reduce motion turns off the drawer's sliding tab underline and the toasts' slide-in and fade-out. Until you set it, it follows your desktop: the XDG portal's reduced-motion preference, or KDE's animation speed set to Instant. Once you've flipped it, Follow desktop hands the choice back. It's saved as
reduceMotion(absent means follow the desktop) and applies when you press Save. The small check and switch transitions inside gpui-component's checkbox and switch can't be turned off yet.
Workspace roots
Point Orrery at one or more directories. It walks each up to scan depth levels deep looking for git repos, skipping anything matching the ignore list.
| Setting | Default | Notes |
|---|---|---|
| Roots | ~/dev | One or more directories to scan. |
| Scan depth | 3 | How many levels deep to descend (1–8). |
| Ignore | node_modules, .cache, vendor, target, dist, .git, .claude | Comma-separated directory names to skip. Also hides tool-managed linked worktrees (see Fleet hygiene). |
.claude joined the default list so worktrees under .claude/worktrees/ stay out of the fleet. An existing config keeps its own list, so add .claude by hand if you want the same behaviour.
Hosts
Public repos enrich without signing in (and an authenticated gh CLI is used automatically if present). Connect an account for higher rate limits and private-repo data.
For self-hosted GitLab, only explicitly trusted domains are ever sent a token — a repo's remote domain can't trick Orrery into leaking credentials to an arbitrary host.
| Host | Token source | Trusted domains |
|---|---|---|
| GitHub | Sign-in, ORRERY_GITHUB_TOKEN, or gh auth token | github.com |
| GitLab | ORRERY_GITLAB_TOKEN, or glab auth token | gitlab.com plus gitlabHosts |
| Gitea / Forgejo / Codeberg | ORRERY_GITEA_TOKEN | codeberg.org plus giteaHosts |
A self-hosted GitLab whose name starts with gitlab. is recognised automatically (it's still only sent a token when it's on gitlabHosts). A self-hosted Gitea or Forgejo is only recognised when it's on giteaHosts:
gitlabHosts = ["code.acme.io"]
giteaHosts = ["git.acme.io"]With a token, the Inbox and notifications cover gitlab.com and every gitlabHosts entry (one GitLab token for all of them), and codeberg.org and every giteaHosts entry likewise.
Stale thresholds
| Key | Default | Meaning |
|---|---|---|
stalePrDays | 7 | Days a PR you opened may stay open before it counts as stale. |
staleReviewDays | 2 | Days a review request may wait on you before it counts as stale. |
Set either to 0 to turn it off. The ages are tracked now; the Inbox badges that show them come in a later release.
Where things live
| Path | Contents |
|---|---|
~/.config/orrery/config.toml | Your settings. |
~/.local/share/orrery/cache.sqlite | Repo snapshot, host enrichment, favorites, notes, AI summaries & embeddings. |
~/.local/share/orrery/models/ | GGUF models downloaded for the llama.cpp backend. |
~/.local/share/orrery/bin/ | The llama.cpp engine (bundled with release builds, unpacked here on first use). |
The repo snapshot and host enrichment are rehydrated on launch, so Mission Control paints instantly and visibility/stars survive restarts without a re-fetch.
Don't commit these
Everything under ~/.config/orrery and ~/.local/share/orrery is machine-local — never check it into a repo. It can hold host tokens and your personal data.