Code-crew crew-config

Manages CodeCrew configuration. Allows users to customize default mode, model tiers, agent activation, token budgets, and auto-index settings without editing JSON files.

install
source · Clone the upstream repo
git clone https://github.com/d3x293/code-crew
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/d3x293/code-crew "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/crew-config" ~/.claude/skills/d3x293-code-crew-crew-config && rm -rf "$T"
manifest: skills/crew-config/SKILL.md
source content

Crew Config - User Configuration Manager

Reads and writes

.claude/crew-config.json
to customize CodeCrew behavior.

When to Activate

  • User runs
    /crew config show|set|reset
  • Other skills check for config overrides at startup

Config File

Location:

.claude/crew-config.json
(created on first
set
command)

Default values (used when file doesn't exist):

{
  "defaultMode": "full",
  "modelOverrides": {},
  "agentOverrides": {},
  "tokenBudgets": {
    "opus": 3000,
    "sonnet": 2000,
    "sonnet-planner": 2500,
    "haiku": 800
  },
  "autoIndex": true,
  "historyLimit": 50
}

Subcommands

show
— Display Current Configuration

  1. Read
    .claude/crew-config.json
    (if exists, otherwise show defaults)
  2. Display:
Config: Mode={full|lite} | Auto-Index={on|off} | History={count}
Budgets: Opus {t}tk/{s}sk | Sonnet {t}tk/{s}sk | Sonnet-planner {t}tk/{s}sk | Haiku {t}tk/{s}sk
Model overrides: {none | list}
Agent overrides: {none | list}

set <key> <value>
— Update a Setting

Supported keys:

KeyValuesExample
mode
full
,
lite
/crew config set mode lite
auto-index
true
,
false
/crew config set auto-index false
history-limit
number
/crew config set history-limit 100
agent.<name>.model
opus
,
sonnet
,
haiku
/crew config set agent.senior-dev.model opus
agent.<name>.active
true
,
false
/crew config set agent.security-analyst.active true
budget.<tier>
number (tokens)
/crew config set budget.sonnet 2500

Process:

  1. Read existing
    .claude/crew-config.json
    (or start with defaults)
  2. Validate the key and value
  3. Apply the change
  4. Write back to
    .claude/crew-config.json
  5. Confirm:
    "Set {key} = {value}"

Validation rules:

  • mode
    : must be
    full
    or
    lite
  • agent.<name>.model
    : agent must exist in crew-team.json
  • budget.<tier>
    : must be a positive number, max 5000
  • Warn if user sets a Haiku agent to Opus (expensive, possible but discouraged)

reset
— Restore Defaults

  1. Delete
    .claude/crew-config.json
  2. Confirm:
    "Configuration reset to defaults"

Integration with Other Skills

Other skills should check for config overrides at startup:

1. Check if .claude/crew-config.json exists
2. If yes, read it and apply overrides:
   - task-router / lite-router: check defaultMode to decide which router to use
   - skill-injector: check tokenBudgets for custom limits
   - execution-orchestrator: check autoIndex, modelOverrides
3. If no, use built-in defaults

This check adds ~50 tokens per skill invocation but enables full user customization.