OpenParable
Skip to content
← Back to skills

cortex-configure

Apps & Automation

Configure Cortex settings with presets

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/hjertefolger/cortex/blob/HEAD/skills/cortex-configure/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/cortex-configure, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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