cortex-configure

Category: Tools & Productivity | Uploader: hjertefolger | Downloads: 0 | Version: v1.0（Latest）

Configure Cortex settings with presets

Changelog: Source: GitHub https://github.com/hjertefolger/cortex

Directory Structure

Current level: skills/cortex-configure/

📄 SKILL.md 2.9 KB

SKILL.md

---
name: cortex-configure
description: Configure Cortex settings with presets
allowed-tools: Bash, Write, Read, AskUserQuestion
user-invocable: true
---

# 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`

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

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

cortex-configure

Directory Structure

SKILL.md

Report

Notice