Command reference

Command reference

Project creation

sc create "project-name"

Creates a new project with full scaffolding: folders, docs, Git (main/staging/dev branches), GitHub repo, skills, and slash commands. Also available as create "project-name".

Options:

• --dry-run — preview what would be created without creating anything
• --version — show scaffolder version
• --help — show usage information

Examples:

sc create "my-app"
sc create --dry-run "my-app"
create "my-app"

Configuration

sc init

Interactive setup for scaffolder configuration. Walks through all settings: your name, GitHub username, default drive path, Windows username, environment, AI names, command prefix, and time tracking. Runs automatically on first use.

sc config list

Show all current configuration values.

sc config get [key]

Show a specific configuration value.

Example:

sc config get chatAiName

sc config set [key] [value]

Set a specific configuration value.

Example:

sc config set chatAiName "Planner"

sc migrate-path [old-path] [new-path]

Find and replace all path references in ~/.scaffolder-config.json and all project .scaffolder files. Creates backup before making changes.

Example:

sc migrate-path /mnt/c/Projects /mnt/d/Claude/projects

Session management

sc start [type] [project]

Start a session timer. Types: planning, build, testing. Prompts for type and project if not provided.

Examples:

sc start planning my-app
sc start build my-app
sc start testing my-app
sc start

sc pause

Pause the active session timer. Shows elapsed time.

sc resume

Resume a paused session timer.

sc end

End the active session. Calculates total time, updates TIME-LOG.md and MASTER-TIME-LOG.md.

sc done

End all active sessions and run full end-of-session checklist:

• Ends active session and logs time
• Generates session log to sessions/logs/ with version, date, type, and operator
• Provides copy command for saving the log file

sc exit

End the active session, log time, and exit cleanly. Use this for a quick session close without generating a full session log.

sc status [project]

Show current status: active session, duration, open issues count, current version, update availability.

Example:

sc status my-app

Time tracking

sc log [time] [type] [project] "description"

Add a manual time entry to TIME-LOG.md and MASTER-TIME-LOG.md.

Example:

sc log "2h 30m" planning my-app "Architecture review"
sc log 45m testing my-app "QA session v0.1.0"

sc history [project]

Show time summary for a project: planning, build, and testing totals plus last 5 log entries.

Example:

sc history my-app

Navigation

sc open [project]

Open a project in VS Code. Resolves path from defaultDrive config.

Example:

sc open my-app

sc build [project]

Open a project, start Claude Code, and auto-start a build session timer.

Example:

sc build my-app

Task queue

sc queue

Show numbered list of open items from ~/.scaffolder-queue.json.

sc queue add "description" [project]

Add a new item to the queue.

Example:

sc queue add "Fix login bug" my-app

sc queue done [number]

Mark a queue item as complete.

Example:

sc queue done 1

sc queue next

Show the highest priority (first) open queue item.

Help

sc help

Show all available commands with one-line descriptions.

sc help [command]

Show detailed usage, options, and examples for a specific command.

Example:

sc help start

sc help [topic]

Show workflow guides. Available topics: planning, build, testing, new, update, config.

Example:

sc help planning

Project updates

sc update "project-name"

Update a project to the latest scaffolder version. Creates backup, shows diffs, prompts for each file.

sc update "project-name" --rollback

Restore a project from a backup. Lists available backups and prompts for selection.

update-scaffolder

Update scaffolder itself. Pulls latest from GitHub, rebuilds, and relinks globally.

Slash commands

Slash commands are available inside Claude Code sessions. Type the command name and Code will execute it.

All /sc slash commands invoke the corresponding sc CLI command and handle session context automatically.

Available commands:

• /sc-start — start a session timer
• /sc-end — end session, update CURRENT.md
• /sc-exit — end session and exit Claude Code
• /sc-done — full session close with log generation
• /sc-status — show project status
• /sc-create — create a new project
• /sc-queue — manage task queue
• /sc-history — show time summary
• /sc-log — add manual time entry
• /sc-config — view/update configuration
• /sc-help — show help

Slash commands live in .claude/commands/ and are created automatically by sc create.

Skills

Skills are automatic workflows that Code uses when relevant. They don’t need to be invoked — Code detects when to use them.

Built-in skills:

• session-start — reads project state, checks git, reports readiness at session start
• session-end — updates CURRENT.md, writes session log, commits at session end
• plan-mode-reminder — suggests plan mode for complex tasks (3+ files, new functionality)

Skills live in .claude/skills/ and are created automatically by sc create.

Creating custom skills

Create a new folder in .claude/skills/ with a SKILL.md file:

.claude/skills/my-skill/
└── SKILL.md

The SKILL.md needs frontmatter with name and description:

---
name: my-skill
description: "When to use this skill"
---

# Instructions for Code
...

Code will automatically discover and use skills when the description matches the current task.