Help center

Sennoric Desktop App

Installing and using the desktop chat app — workspace access, chat history, and settings.

Installation and first launch

The Desktop App is an Electron app that runs the real Sennoric agent in its main process — the same agent the CLI uses — and shares its credentials, models, and saved conversations via ~/.axion.

On first launch, sign in (see Signing in) — any provider keys already configured in the CLI are picked up automatically.

The chat interface

The chat surface is ported from the website's web chat, sharing the same typography and design tokens so the two feel like one product. It follows your OS's light/dark theme automatically.

Workspace/account access menu

The account strip opens a Settings surface with fixed navigation and searchable controls — see Settings overview below for what's in there.

Connecting to the CLI (shared credential store)

The Desktop App and CLI read from the same ~/.axion directory — models, credentials, modes, workspaces, and saved conversations are shared automatically. There's nothing to manually sync; setting a key in one shows up in the other.

Security note. Your session token lives only in the app's main process — the chat UI itself never has direct access to it, only to display-safe account metadata like your email and plan.

Chats library

Past conversations are saved and searchable from the chats library, so you can find and resume a previous conversation instead of starting fresh each time.

Settings overview

  • Profile, Usage (plan, weekly and 5-hour limits, credit codes) and Permissions
  • Appearance: light, dark, or follow system, plus density, text scale, conversation width and corner roundness
  • Message-avatar and token-usage visibility
  • Keyboard shortcuts, which you can change
  • Home and Code special instructions (extra system guidance sent to the agent)
  • Permission mode for Code: ask, plan, decide or auto
  • Apps and extensions: GitHub, Google and Notion connections
  • Help: links to this help center, the API docs, announcements and status, and Replay tour, which restarts onboarding without losing your saved preferences

Changes auto-save and apply immediately — there's no separate save step.

Troubleshooting: app won't start / crashes on launch

Since the app shares its credential store with the CLI, first confirm the CLI itself runs correctly — if the CLI is broken, the Desktop App will be too. If the CLI works but the app doesn't, try reinstalling the Desktop App itself before touching ~/.axion, since that directory holds your saved conversations and credentials for both products.