Reference

Preferences

User preferences are stored at ~/.agently/preferences.json. These control UI behavior, appearance, keyboard shortcuts, and editor settings.

File Location

~/.agently/preferences.json

Preferences are separate from config.json intentionally: config.json controls how Agently connects to AI and tools, while preferences.json controls how the UI looks and feels.

Full Schema

{
  "version": 1,

  // Appearance
  "appearance": {
    // "system" | "light" | "dark"
    "colorScheme": "system",

    // Accent color hex (overrides theme default)
    "accent": "#00C78B",

    // UI font size in pixels (12–16)
    "fontSize": 14,

    // Chat line height
    // "compact" | "normal" | "relaxed"
    "lineHeight": "normal",

    // Sidebar width in pixels
    "sidebarWidth": 240,

    // Show conversation timestamps in sidebar
    "showTimestamps": true
  },

  // Editor (message input)
  "editor": {
    // Send on Enter (true) or Shift+Enter (false)
    "sendOnEnter": true,

    // Show character/token count
    "showTokenCount": false,

    // Spell check
    "spellCheck": true,

    // Auto-close brackets and quotes
    "autoClose": true
  },

  // Notifications
  "notifications": {
    // Desktop notification when agent completes a long task
    "taskComplete": true,

    // Sound on notification
    "sound": false
  },

  // Keyboard shortcuts (subset shown — full list in Settings UI)
  "shortcuts": {
    "newChat": "cmd+n",
    "search": "cmd+k",
    "toggleSidebar": "cmd+b",
    "switchWorkspace1": "cmd+1",
    "focusInput": "cmd+l"
  },

  // Language / locale
  // "auto" follows system, or set explicitly: "en", "ja", etc.
  "language": "auto",

  // Proxy settings (for corporate networks)
  "proxy": {
    "enabled": false,
    "url": "http://proxy.example.com:8080"
  },

  // Data retention: delete conversations older than N days (0 = never)
  "conversationRetentionDays": 0
}

Appearance Settings

appearance.colorScheme"system" | "light" | "dark"

Dark/light mode. "system" follows OS setting.

appearance.accenthex string

Primary accent color used for active states, links, and brand elements.

appearance.fontSize12–16 (number)

Base font size for the UI in pixels. Default is 14.

appearance.lineHeight"compact" | "normal" | "relaxed"

Chat message line height. Relaxed adds more breathing room between lines.

appearance.sidebarWidth200–400 (number)

Width of the left sidebar in pixels. Default is 240.

appearance.showTimestampsboolean

Show relative timestamps (e.g. '2h ago') next to conversations in the sidebar.

Editor Settings

editor.sendOnEnterboolean

If true, pressing Enter sends the message. Use Shift+Enter for newlines. If false, Enter adds a newline and Shift+Enter sends.

editor.showTokenCountboolean

Display a live token count in the bottom-right of the message input.

editor.spellCheckboolean

Enable system spell-checking in the message input.

editor.autoCloseboolean

Automatically insert matching closing bracket or quote when you type an opening one.

Resetting to Defaults

To reset all preferences to defaults, delete or rename preferences.json and relaunch Agently. The file will be recreated with defaults.

You can also reset individual sections from Settings → Advanced → Reset Preferences.