Configuration

Customize SiftCoder to your needs

⏱️ 5 minutes to configure

🚀 Quick Setup

SiftCoder works out of the box, but you can customize it for optimal results.

Start Here:

/siftcoder:config

Opens interactive configuration wizard

🎯 Workflow Modes

Choose how autonomous SiftCoder should be

RECOMMENDED

Autonomous

AI works independently with checkpoints

✅ Plans, codes, reviews, fixes automatically
✅ Stops at checkpoints for your review
✅ Self-heals build/test failures
✅ Best for: Most development tasks

workflowMode: "autonomous"

Interactive

AI asks before each major step

✅ More control over process
✅ Approve each phase
⚠️ Slower overall
✅ Best for: Learning SiftCoder

workflowMode: "interactive"

Pair Programming

AI suggests, you approve

✅ Collaborative approach
✅ Learn from AI suggestions
⚠️ Requires more interaction
✅ best for: Learning, teaching

workflowMode: "pair"

✅ Quality Gates

Configure automatic quality checks

Code Formatting

Auto-format before committing

Enabled

Runs Prettier/Black/Ruff based on language

Linting

Catch code style issues

Enabled

ESLint, Pylint, Rubocop, etc.

Type Checking

Validate types for TypeScript/Python

Enabled

tsc, mypy, pyright

Build Validation

Ensure project builds successfully

Enabled

npm run build, cargo build, make

Automated Testing

Run test suite before completion

Enabled

npm test, pytest, cargo test

Self-Healing

Auto-fix gate failures

Enabled

Retries up to 3 times with fixes

💡 Tip: Quality gates run automatically. If any gate fails, SiftCoder attempts to fix the issue and retry.

🛡️ Safety Boundaries

Protect files and directories from modification

Protect Critical Files

                        /siftcoder:scope add prod-config.json

                        /siftcoder:scope add .env

                        /siftcoder:scope add src/legacy/*

These files will never be modified without explicit approval

Set Blast Radius

/siftcoder:blast-radius "Add user feature"

See exactly what will be affected before making changes

Create Checkpoints

/siftcoder:checkpoint save "before-refactor"

Save restore point before risky changes

⚙️ Advanced Options

Fine-tune SiftCoder behavior

Parallel Execution

Run multiple agents simultaneously

parallelAgents: true Recommended for: Large projects

Max Iterations

Limit auto-retry attempts

maxIterations: 3 Default: 3, Range: 1-10

Verbosity

Control output detail level

verbosity: "normal" Options: minimal, normal, detailed

Session Persistence

Save context between sessions

persistence: true Resume work later with full context

Cost Awareness

Track token usage and costs

costTracking: true Monitor AI API usage

Preview Changes

Show diffs before applying

previewChanges: true Review before committing

📁 Configuration File

Store settings in your project

.siftcoder/config.json

{
  "workflowMode": "autonomous",
  "qualityGates": {
    "formatting": true,
    "linting": true,
    "typeChecking": true,
    "build": true,
    "testing": true,
    "selfHealing": true
  },
  "safety": {
    "protectedFiles": [
      ".env",
      "prod-config.json"
    ],
    "requireCheckpoints": true
  },
  "advanced": {
    "parallelAgents": true,
    "maxIterations": 3,
    "verbosity": "normal",
    "persistence": true,
    "costTracking": true,
    "previewChanges": true
  }
}

Create this file in your project root to share settings with your team