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

File locations

Everything Veyyon stores lives under the config home — ~/.veyyon on Unix by default, or the Veyyon application directory on Windows. Override the directory name with PI_CONFIG_DIR; on Linux the XDG layout is available after veyyon config migrate.

Layout

PathContents
config.ymlYour configuration (config.yaml also accepted). See Configuration.
auth.jsonThe managed OpenAI/ChatGPT credential (in file credential-store mode).
local.ageThe encrypted managed-secrets store (general secrets, including BYOK provider keys).
veyyon_auth.ageThe encrypted auth-token store (in secrets credential-store mode).
sessions/Saved session rollouts (JSONL), one per thread.
archived_sessions/Sessions moved aside by /archive.
logs/Log files, including the login log.
history.jsonlComposer input history.
plugins/Installed plugins.
skills/Installed and local skills.
hooks/Lifecycle hook configuration.
agents/Agent definitions.
attachments/, avatars/Session attachments and account avatars.

Credential storage modes

Where credentials land depends on cli_auth_credentials_store_mode in config.yml:

  • file — auth.json, mode 0600, written atomically.
  • keyring — the OS keyring (with the encrypted secrets backend as one keyring option).
  • auto — keyring when available, falling back to the file.
  • ephemeral — in-memory only; nothing is written to disk.

BYOK provider keys always go to the encrypted managed-secrets store (local.age), never to plaintext config.yml; see Signing in.

Project-local files

Alongside your project (not under VEYYON_HOME):

PathPurpose
AGENTS.mdProject instructions Veyyon auto-loads. See AGENTS.md.
.veyyon/Optional per-project overrides and data.