hjertefolger/cortex/cortex-configure

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%

1. Restoration Token Budget (number)

• Max tokens for restoration context
• Default: 2000

1. Restoration Message Count (number)

• Number of messages to restore
• Default: 5

1. Statusline Enabled (true/false)

• Show Cortex in status line
• Default: true

1. 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

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

1. If specific settings:

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

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