Cortex Configure

Adjust Cortex settings after initial setup.

Configuration Options

Presets

Offer quick presets for common configurations:

Full - All features enabled

• •Statusline: enabled
• •Auto-archive: enabled
• •Auto-save threshold: 70%
• •Awareness: enabled

Essential - Core features only

• •Statusline: enabled
• •Auto-archive: enabled
• •Auto-save threshold: 75%

Minimal - Commands only

• •Statusline: disabled
• •Auto-archive: disabled
• •Auto-save threshold: 85%

Individual Settings

Allow fine-tuning of specific settings:

1. •

   Auto-save Threshold (0-100%)

   • •When to automatically save context
   • •Default: 70%
2. •

   Restoration Token Budget (number)

   • •Max tokens for restoration context
   • •Default: 2000
3. •

   Restoration Message Count (number)

   • •Number of messages to restore
   • •Default: 5
4. •

   Statusline Enabled (true/false)

   • •Show Cortex in status line
   • •Default: true
5. •

   Awareness (section)

   • •Injects user/time/date context at session start and after context clear

   Step 1: enabled (true/false) — ask first, before anything else:

   • •If currently enabled: "Keep enabled", "Disable"
   • •If currently disabled: "Enable", "Keep disabled"
   • •If the user disables awareness, skip userName and timezone questions entirely.

   Step 2: userName — only ask if awareness is enabled:

   • •If already set (show current value): "Keep current", "Change" (ask for new name), "Turn off" (set null)
   • •If not set: "Set a name" (ask for name string), "Skip" (keep null)
   • •IMPORTANT: Never pre-fill or guess the user's name. Always let the user type it.

   Step 3: timezone — only ask if awareness is enabled:

   • •"Auto-detect" → set null (uses system timezone)
   • •"Custom" → ask user for IANA timezone string (e.g. "America/New_York")
   • •"Off" → set "off" (omit Date/Time lines entirely, only show User if set)
   • •IMPORTANT: Never pre-fill a timezone value. Let the user choose and type.

Usage Flow

1. •

   Ask user what they want to configure:

   • •Apply a preset
   • •Adjust specific settings
2. •

   If preset: Apply using node dist/index.js configure <preset>

3. •

   If specific settings:

   • •Read current config from ~/.cortex/config.json
   • •Ask about specific setting to change
   • •Update and save config
4. •

   Confirm changes applied

Configuration File

Location: ~/.cortex/config.json

{
  "statusline": {
    "enabled": true,
    "showFragments": true,
    "showLastArchive": true,
    "showContext": true
  },
  "archive": {
    "autoOnCompact": true,
    "projectScope": true,
    "minContentLength": 50
  },
  "automation": {
    "autoSaveThreshold": 70,
    "restorationTokenBudget": 2000,
    "restorationMessageCount": 5
  },
  "awareness": {
    "enabled": false,
    "userName": null,
    "timezone": null
  }
}