Customizing your setup

Customizing your setup

Initial configuration

Run sc init to walk through all configuration options interactively:

sc init

Configuration file

All settings are stored in ~/.scaffolder-config.json:

{
  "yourName": "",
  "operatorAlias": "",
  "operatorDescription": "Solo developer, projects built to scale",
  "githubUsername": "",
  "defaultDrive": "/mnt/d/Claude/projects",
  "windowsUsername": "",
  "environment": "wsl2",
  "mode": "personal",
  "chatAiName": "Chat",
  "codeAiName": "Code",
  "commandPrefix": "sc",
  "timeTracking": true,
  "defaultGitHub": "",
  "defaultScaleTier": "hobby"
}

Managing configuration

View all settings:

sc config list

Get a specific setting:

sc config get chatAiName

Set a specific setting:

sc config set chatAiName "Planner"
sc config set codeAiName "Coder"
sc config set defaultGitHub "myusername"
sc config set defaultDrive "/mnt/d/projects"
sc config set defaultScaleTier "professional"
sc config set timeTracking false
sc config set mode "team"
sc config set operatorAlias "alex"
sc config set operatorDescription "Frontend developer on the payments team"

Mode: personal vs. team

Scaffolder supports two modes:

• personal (default) — full control over AI names, operator description, and all settings
• team — AI names locked to Chat/Code for consistency across team members

Set mode during sc init or:

sc config set mode "team"

Operator alias

The operator alias (max 5 characters) appears in session log filenames:

v00.07.01-2026-03-15-1430-code-purls.md

Set during sc init or:

sc config set operatorAlias "purls"

Operator description

Used in the [OPERATOR_DESCRIPTION] placeholder in ARCHITECT-REFERENCE.md. Describes who you are and your role.

sc config set operatorDescription "Solo developer, projects built to scale"

Changing AI names

The Chat AI name and Code AI name are used throughout project templates. They replace [CHAT_AI_NAME] and [CODE_AI_NAME] placeholders in all generated files.

Default names:

• Chat — the planning AI (used in chat/planning sessions)
• Code — the coding AI (used in Claude Code sessions)

To change them globally for all future projects:

sc config set chatAiName "YourPlannerName"
sc config set codeAiName "YourCoderName"

Note: In team mode, AI names are locked to Chat/Code and cannot be changed.

Customizing templates

All project templates live in the scaffolder’s templates/ directory. To customize what new projects get:

1. Find the template: ls $(npm root -g)/scaffolder/templates/
2. Edit the template file directly
3. New projects will use your customized version

Templates use these placeholders (replaced at project creation):

• [project-name] — the project name
• [github-username] — from config
• [CHAT_AI_NAME] / [CODE_AI_NAME] — from config
• [OPERATOR_DESCRIPTION] — from config

Recommended plugins

These optional plugins enhance Claude Code’s capabilities. Install them from within a Claude Code session:

claude-md-management

Audits CLAUDE.md quality, captures session learnings, keeps project memory current.

/plugin marketplace add anthropics/claude-plugins-official
/plugin install claude-md-management@anthropics/claude-plugins-official

pr-review-toolkit

Comprehensive PR review with specialized agents for code quality, tests, errors, and types.

/plugin marketplace add anthropics/claude-plugins-official
/plugin install pr-review-toolkit@anthropics/claude-plugins-official

skill-creator

Helps create new custom skills with proper structure and frontmatter.

/plugin marketplace add anthropics/claude-plugins-official
/plugin install skill-creator@anthropics/claude-plugins-official

Note: Plugin installation is per-user, not per-project. Install once and they’re available in all your Claude Code sessions.

Changing the command prefix

By default, all session commands use the sc prefix. To change it:

sc config set commandPrefix "myprefix"

After changing, rebuild and relink:

npm run build && npm link