Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Configuration Overview

Xenocept stores all of its state — sessions, screenshots, settings, destinations — inside a single AeorDB-backed file (xenocept.aeordb). The paths described below are paths inside that file, not paths on your real filesystem.

Edit through the Settings UI in the desktop app, or via the HTTP endpoints listed below.

Where the Database Lives

PlatformPath
Linux(depends on Tauri’s resolved app-data dir, typically under ~/.local/share/xenocept/)
macOS~/Library/Application Support/<Xenocept-app-id>/
Windows%APPDATA%\<Xenocept-app-id>\

The exact directory is resolved by Tauri’s app_data_dir at startup ( around the state_store initialization). The Settings UI in the running app is the authoritative source of the actual path on your system.

The Three Config Documents

Inside the AeorDB store:

PathConcern
/config/settings.jsonUser-facing settings (hotkey, autostart, screenshot export path/template). See Settings.
/config/destinations.jsonConfigured destinations (recipients of submitted sessions). See Destinations.
/config/auto-send-destinations.jsonWhich destinations auto-send on Submit, plus a master enable flag.

HTTP Endpoints For Config

EndpointMethodPurpose
/api/v1/settingsGET / POSTRead or overwrite settings.json
/api/v1/destinationsGET / POSTList or create destinations
/api/v1/destinations/{id}PUT / DELETEUpdate or delete a destination
/api/v1/auto-sendGET / PUTRead or update the auto-send config

The HTTP Server Itself

When Xenocept starts, it spawns its HTTP server on:

http://127.0.0.1:9500

Both the host and the port are hardcoded. There is no server configuration block in settings.json. The MCP channel-mode CLI accepts a --port flag, but that flag tells the channel server which port the running Xenocept GUI listens on (defaulting to 9500) — it does not change the listening port.