About, settings and updates
Settings
Settings (⌘, on macOS, Ctrl+, on Windows and Linux, or the account menu in the sidebar footer) opens a sheet over the window with two panels:
| Panel | Opens from | What it holds |
|---|---|---|
| AI tools | ⌘, , Connect AI Tools… in the account menu or ⌘K | Connect Claude, Cursor, Codex, VS Code and other AI tools to the app on this computer, the tools you allowed, and Open onboarding chat |
| About Orkestia Cockpit | About Orkestia Cockpit… in the account menu or ⌘K | Version, update, resource usage, cache, account and sign out |
The app has no other settings sheet. Appearance, the sidebar and pane sizes are set where they apply:
| Setting | Where | Scope |
|---|---|---|
| Appearance: System, Light or Dark | Account menu › Appearance, View › Appearance on macOS, or ⌘K | This computer |
| Sidebar arrangement and style | Customize Sidebar… | Per organization, this computer |
| Pane widths | Drag the edges | This computer |
| Organization | The menu at the top of the sidebar | This app, remembered on this computer |
--background flag, but there is no switch for it in Settings. Whether it starts at login is not something you control from inside the app.About
The panel reads what this window is running and never invents a number. Where the webview does not expose a value, the row says Not reported by this webview instead of a zero.
Version and update
| Row | Meaning |
|---|---|
| Orkestia Cockpit 0.1.16 | The installed app, as the packaged app reports it. In a browser or the dev server it reads Checked in the desktop app |
| You're running the latest version. | The last check found nothing newer |
| Update available: X | A newer build exists |
| Couldn't check for updates: … | The check failed. The text is the updater's own error |
Check for Updates… looks again. When an update is available, Install and Restart downloads it and relaunches into it. A failed install shows Couldn't install the update: with the reason.
The same updater runs at launch and every 6 hours, quietly. How the row, the sheet and the dialogs behave is in Install and sign in.
Resource usage
| Row | Source |
|---|---|
| Uptime | How long this window has been up |
| Operating system | Name, version and architecture |
| Processor cores | hardwareConcurrency |
| Device memory | deviceMemory, in GB (Chromium-based webviews only) |
| Renderer heap | JavaScript heap used of its limit (Chromium-based webviews only) |
| Window | Width × height |
Webviews based on WebKit (macOS, and usually Linux) do not report device memory or heap, so those rows read Not reported by this webview there. It is a limit of the platform, not an error.
Cache
The list shows the settings the app itself stores on this computer and how large each is, and a total. Clear… asks first, then removes exactly those keys. It reports Cleared N stored settings. or There was nothing cached to clear.
What the list covers:
| Group | Examples |
|---|---|
| Interface | Appearance, open sidebar groups, pane sizes, sidebar arrangement, recent searches |
| Context | Last organization scope, chats-only view, selections in Agents, Coding and Runners, Coding repository tabs |
| Work in progress | Unsaved workflow drafts, workflow filters and assistant conversations, diagram preferences, local runner settings, detected sources |
| DGI | Turn-on flags, proposals, planner results, seen items, locally answered turns |
| Announcements | Decisions and shared chats already announced, so you are not notified twice |
| Tools | Allowed AI tools, app chat settings |
Not removed: your account, your organization, your chats, and your sign-in. Those are not in this list: the sign-in is in the operating system's secure store and everything else is on the platform. The Cockpit onboarding record (whether setup was skipped) is also outside the list.
Account
Shows Signed in as <email> and a Sign Out button. Without a Cockpit account (chats-only) it reads Using Orkestia without a Cockpit account. Signing out is described in Install and sign in.
What stays on this computer
| What | Where | Removed by |
|---|---|---|
| Sign-in tokens | The OS secure store, service dev.orkestia.cockpit | Sign out |
| App settings and drafts | The webview's local storage | Clear… in About (the keys listed above) |
| Window size and position | The app's window state | Reinstalling or deleting the app data folder |
The app data folder is named after the app identifier dev.orkestia.cockpit and sits in the usual per-user location: ~/Library/Application Support/ on macOS, %APPDATA% on Windows, ~/.local/share/ on Linux. The exact files depend on the platform, so treat any paths beyond that as depends on the platform.
Next: Troubleshooting.
Navigation and shortcuts
The Cockpit sidebar and how to arrange it, the ⌘K search palette, every keyboard shortcut, the tray, notifications and the Dock or taskbar badge
Troubleshooting
Sign-in loops and state mismatches, expired sessions, notifications that do not show, updater errors, the organization mismatch warning, billing outages and where the app keeps its data on your computer