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
  }
}