Axion Desktop App — Sennoric Help

Installation and first launch

The Desktop App is an Electron app that runs the real Axion 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

Appearance: light, dark, or follow system
Interface density, text scale, conversation width, corner roundness
Message-avatar and token-usage visibility
Home and Code special instructions (extra system guidance sent to the agent)
Active model and permission mode (ask / plan / auto)
Replay tour — 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.