Developer Tool

Turn any project structure
into real files instantly

Paste a tree from a README. Drop a JSON spec. Pipe from stdin. scaffold-craft reads it and builds the project on disk in one command.

View on GitHub See demo
terminal
$ pip install scaffold-craft
How it works

Input → Files on disk

Copy a tree from any README, save it, and scaffold it. That's it.

structure.txt
my-api/ ├── app/ │ ├── __init__.py │ ├── main.py │ └── models.py ├── tests/ │ └── test_main.py └── requirements.txt
scaffold tree --input structure.txt
scaffold-craft [LIVE] → /projects mkdir my-api/ mkdir my-api/app/ touch my-api/app/__init__.py touch my-api/app/main.py touch my-api/app/models.py mkdir my-api/tests/ touch my-api/tests/test_main.py touch my-api/requirements.txt Created: 3 dirs, 5 files
Input formats

Three ways to define a structure

tree string
The ASCII/Unicode format from README files and the tree command. Copy and paste directly.
JSON spec
Nested JSON object. File values can be null (empty) or a string (file content).
YAML spec
Same structure as JSON in YAML syntax. Requires pip install "scaffold-craft[yaml]".
image (v1.1)
Screenshot of VS Code file explorer. Parsed via Ollama vision or OpenAI vision API.
Roadmap

What's coming next

v1.0
Tree, JSON, YAML, CLI DONE
Core scaffold engine with dry-run, overwrite, and skip-existing.
v1.1
Image input
Screenshot of VS Code file explorer → scaffold. Powered by Ollama vision (llava) or OpenAI vision API.
v1.2
VS Code extension
Right-click in the explorer → "Scaffold from structure". Or paste a tree into the command palette.
v1.3
Template variables
Use {{project_name}}, {{author}}, {{year}} in file content.
v2.0
AI mode
Describe your project in plain English. AI generates the structure. scaffold-craft builds it.