Repository navigation
Releases
Spawn v1.1.1
Spawn v1.1.1
A reliability and quality release.
Spawn v1.1.1 focuses on making project generation, repository inspection, and generated templates safer and more predictable.
What's Fixed
Filesystem Safety
- Improved protection against pre-existing symlinks and Windows junctions.
- Safer rollback behavior that avoids deleting directories not created by the current generation run.
- Correct handling of directory entries with trailing slashes across custom structure formats.
Inspection and CLI Reliability
- Escaped untrusted Rich error messages.
- Bounded regex processing during inspection.
- Improved URL credential redaction in uv error output.
Generated Project Quality
- Fixed linting and formatting issues across supported template variants.
- Corrected the generated RAG test's OpenAI status exception fixture.
- Updated generated Django CI to use Django's native test runner.
Validation
- 1,915 tests passed.
- 25 tests skipped.
- 40 generated template variants passed Ruff validation.
- Ruff lint and formatting checks passed.
Upgrade
pip install --upgrade spawnioPackage: spawnio
Version: 1.1.1
Spawn v1.1.0
Spawn v1.1.0 — spawn inspect
Spawn can now read a repository, not just create one. Point it at any local project and get a deterministic, evidence-backed summary of what it contains.
spawn inspect # inspect the current directory
spawn inspect ./my-app # inspect a path
spawn inspect . --json # full machine-readable report on stdoutWhat spawn inspect does
- Read-only and static. It never runs project code, installs dependencies, makes network calls, or needs an LLM, and it writes nothing to the target.
- Evidence-backed. Every finding carries repo-relative evidence and one of five states:
detected,inferred,not_detected,unknown,not_checked. A dependency declaration alone is reported as inferred, not detected. - Deterministic. The same repository gives the same report, with stable ordering and no machine-specific absolute paths.
- Partial results. Unreadable or malformed files produce diagnostics and a
partialstatus instead of aborting the run.
What it detects
- Languages and frameworks: 25 languages; React, Next.js, Vue, Nuxt, Angular, Svelte, Express, FastAPI, Flask, Django, Starlette, Pydantic, Laravel.
- Dependencies and package managers: direct dependencies from
pyproject.toml,requirements*.txtandpackage.json; uv, poetry, pipenv, pip, npm, yarn, pnpm, bun. - Tooling and layout: linters, formatters, test runners, git, CI systems, Docker/Compose, database drivers, tests directory,
srclayout, and Spawn-generated projects.
Other changes
spawn --versionprints the same line asspawn version.spawn inspect --verboseshows more detail in the human report.- A documented JSON report contract (schema
1.0) withvalidate_report,to_jsonandfrom_jsoninspawn.inspection. - New exit code 7 for an invalid path or failed inspection. In
--jsonmode errors go to stderr and stdout stays empty. - Release smoke test now runs
spawn inspect . --jsonon a generated project and verifies it is unchanged. create,doctorandversionbehave exactly as before.
Known limitations
- Framework imports are matched with regular expressions. Import-like text in comments or strings can produce false positives (for example, scaffolding tools that embed sample code), and multi-line or destructured imports are missed.
- Directories named
build,dist,env,venv,target,vendor,coverageand similar are skipped at any depth. - CI, container and pre-commit detection is by file presence only; YAML is not parsed.
- Databases are inferred from driver packages only.
Pipfile,setup.py,Cargo.toml,go.mod,Gemfile,composer.json,pom.xmland Gradle files produce no dependency findings. Rails is not detected.- A pip and an npm package with the same name share one finding.
- On POSIX, filenames that aren't valid UTF-8 can break
to_jsonfor library callers (the CLI still works). A fix is planned. summary.nameis the directory name, andprimary_frameworkmay be inferred.
Upgrade
pip install -U spawnio # or: uv tool upgrade spawnioFull changelog: see docs/changelog.md
Spawn v1.0.9
Spawn v1.0.9 — Core Hardening
A reliability release. Project generation is now safer, errors are predictable, and the internals are cleaner for what comes next. Generated output for default options is unchanged from v1.0.8.
Behavior changes
- Failures now exit non-zero. Generation, git/uv and GitHub-publish failures used to print an error and exit
0. They now exit with a stable code (see the table below), so scripts and CI can trust the result. --no-uvis now honored for template projects. It previously still ran uv. Without uv, Spawn skipsuv init, dependency installs and extras that needpyproject.toml(Dockerfile, CI workflow, ruff/pytest/mypy config). It prints one line listing what was skipped. File-only extras such aspre-commitare still written.- Interactive
spawn create --dry-runnow validates and prints the config without creating anything. It previously created the project.
Security
- Custom-structure paths that escape the project directory (
../, absolute paths, backslashes, drive letters) are rejected. - Failure cleanup only removes directories created by the current run.
- Git and GitHub error output no longer includes URL credentials.
Added
ProjectConfig.destinationandto_dict(), plusplan_projectandgenerate_projectas the single plan and generate entry points.read_project_metadata(): read-only access to.spawn/meta.json. The metadata is historical, not proof of current repo state.- A typed error hierarchy and documented exit codes.
SPAWN_DEBUG=1to get a full traceback for unexpected errors.SECURITY.md, golden-tree fixtures for every template, and expanded CI (Python 3.12/3.13, wheel smoke test).--configwith an explicit--no-git/--no-uvnow warns that the config file takes precedence.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Success (including a valid --dry-run) |
| 1 | Invalid input or config |
| 2 | CLI usage error |
| 3 | Filesystem error (e.g. directory exists) |
| 4 | Toolchain error (git/uv missing or failed) |
| 5 | Generation / template error |
| 6 | GitHub publish error |
| 10 | Unexpected error |
| 130 | Cancelled |
Upgrade
pip install --upgrade spawnio
If you script spawn create, check how it handles non-zero exits, since failures that used to exit 0 now don't.
Full changelog: https://github.com/Abhiix0/Spawn/blob/main/docs/changelog.md
Spawn v1.0.8
Highlights
spawn doctor --fix can now repair a project, not just report on it.
spawn doctor my-project --fix # review the plan, then confirm
spawn doctor my-project --fix --dry-run # show what would change, write nothing
spawn doctor my-project --fix --yes # apply without prompting
spawn doctor my-project --fix --license mit
- Creates missing README, AGENTS.md, .gitignore, CHANGELOG.md, tests/, LICENSE (opt-in), pre-commit config, and a CI workflow; adds pytest, ruff and mypy config to pyproject.toml.
- Never overwrites an existing file and never installs packages. It prints the
uv add --dev ...line for you to run. - CI is generated with ruff and pytest steps only when those are declared as dependencies, so a fixed project's CI doesn't go red.
- Dockerfile,
.env.exampleandpyproject.tomlare reported as manual actions. - Ctrl+C or a declined prompt exits cleanly (130) with nothing written.
Added
--license mit|noneonspawn create(also"license"in JSON config files), plus an interactive license prompt, MIT by default. The holder comes fromgit config user.name, falling back to " contributors".CHANGELOG.mdis generated for every new project (Keep a Changelog format).pre-commitandmypyextras on all 8 templates. mypy adds config and a dev dependency with no CI step, so new projects' CI stays green.- Custom Structure now offers a
Mypyoption.
Fixed
--templatehelp text now lists all 8 slugs, includingmcp.
Upgrade
pip install -U spawnio # or: uv tool upgrade spawnio
Full changelog
See CHANGELOG.md for complete details.
Spawn v1.0.7
v1.0.7
Fixed
- UTF-8 console output crash on Windows —
spawn createandspawn doctorno longer raiseUnicodeEncodeErrorwhen stdout is redirected or piped (e.g.spawn create ... > out.txt). This previously caused a successful run to exit with code 1. stdout/stderr are now reconfigured to UTF-8 witherrors="replace"at startup. - Windows reserved device name validation — project names matching Windows reserved device names (
CON,PRN,AUX,NUL,COM1–COM9,LPT1–LPT9) are now rejected upfront with a clear error, instead ofPRNraising a raw traceback.
Documentation
- Clarified the Python 3.12+ prerequisite — installing via
pipon an older Python version fails with no clear message; this is now called out explicitly.
Thanks
Thanks to Heinrich Neb for the extremely thorough bug report and Windows stress-testing that found both issues.
Install
pip install spawnio
Spawn v1.0.6
v1.0.6 — Now on PyPI
Spawn is now installable directly from PyPI.
Added
- Published to PyPI as
spawnio—pip install spawnio,
uv tool install spawnio, or run once with
uvx --from spawnio spawn create. The CLI command staysspawn.
Fixed
spawn createno longer shows the banner (barespawnremains the
"home screen" that shows it).docs/commands.mdanddocs/getting-started.mdrewritten to match
the current tool — previously described only 4 of the 8 templates
and omitted non-interactive mode,--claude-md, and arrow-key menus
entirely.
Compatibility
Backward compatible. No changes to templates, non-interactive mode,
AGENTS.md/CLAUDE.md generation, or spawn doctor.
Verified
918 tests passing. New docs cross-checked field-by-field against the
actual template registry and CLI flag definitions, not just reviewed
for completeness.
Spawn v1.0.5
v1.0.5 — Arrow-Key Menus & Cleaner CLI UX
Every interactive prompt in spawn create now feels like a modern
scaffolding CLI — arrow keys instead of typed numbers, a proper landing
screen, and consistent behavior when you back out mid-flow.
Added
- Arrow-key selection menus — template, framework, provider, CLI
type, project type, extras, and Custom Structure's optional setup all
use arrow-key/spacebar selection (powered byquestionary) instead
of numbered prompts. spawnwith no arguments now shows the banner, current version,
and a list of available commands, instead of Click's default usage
error.
Fixed
- Consistent, clean cancellation — Ctrl+C at any point in
spawn create— a text prompt, an arrow-key menu, or mid-generation —
now shows a singleCancelled.message and exits with code130.
Previously this varied by exactly where you interrupted: Click's
ownAborted./exit-1 at text prompts,questionary's own
Cancelled by user/exit-130 at menus, and a bare^Cwith no
message at all mid-generation. All three now go through the same
path and produce the same result.
Compatibility
Backward compatible. Existing templates, non-interactive mode,
AGENTS.md/CLAUDE.md generation, and spawn doctor are unaffected.
Verified
918 tests passing. Verified live, not just via the test suite — five
separate real Ctrl+C interrupt points were individually reproduced via
a pty (Project Name prompt, an arrow-key menu, a typer.confirm
prompt, mid-generation, and both of Custom Structure's typer.prompt/
typer.confirm sites), confirming identical output and exit code at
every one.
Spawn v1.0.4
v1.0.4 — AGENTS.md / CLAUDE.md Generation
Every project Spawn generates now ships an AGENTS.md file alongside its README.md — orienting coding agents (Claude Code and others) on project structure, setup, and conventions from the moment the project exists.
Added
-
AGENTS.mdGeneration — Automatically generated for every template using shared defaults (uv sync,uv run pytest, conventions) for Automation, CLI, and Data Projects, alongside template-specific overrides: -
Backend API: States the framework and its exact run command.
-
AI Chatbot / AI Agent: States the provider and required environment variables, accounting for framework-specific naming:
-
litellm+ollama$\rightarrow$ OLLAMA_API_BASE(notOLLAMA_BASE_URL) -
openai-agents+openrouter$\rightarrow$ OPENAI_API_KEY+OPENAI_BASE_URL(notOPENROUTER_API_KEY) -
RAG System: States the required
OPENAI_API_KEYand ingestion mechanics. -
MCP Server: Explains how to add tools/resources via the
mcpSDK decorator API. -
Custom Structure Support — Generates
AGENTS.mdonly if included in the user's pasted structure (matchingREADME.mdand.gitignorebehavior). -
--claude-md/--no-claude-mdFlags — Opt-in generation of an identicalCLAUDE.mdfile alongsideAGENTS.md(supported via CLI flag, interactive prompt, and"claude_md"config file key; off by default). -
spawn doctorCheck — Now checks forAGENTS.mdunder Recommended-tier Documentation items.
Compatibility
- Fully backward compatible. Existing templates and workflows remain unchanged.
Verification
- 916 tests passing. Verified end-to-end across:
--configJSON opt-in flow- Interactive Custom Structure opt-in (confirmed byte-identical output between
AGENTS.mdandCLAUDE.md) - Non-standard environment variable provider/framework mappings
Spawn v1.0.3
v1.0.3 — MCP Server Intent
Spawn can now scaffold Model Context Protocol servers — the eighth
project template, joining Backend API, CLI, Automation, Chatbot,
Agent, RAG, and Data Project.
Added
- MCP Server intent (
spawn create→ template 8) — generates a
server built on the officialmcpPython SDK'sMCPServerclass,
with one working example tool (add) and one example resource
(info://server) overstdiotransport, ready to connect to
Claude Desktop, Claude Code, or any other MCP client. - Ships with a README explaining how to run the server directly and
how to wire it intoclaude_desktop_config.json. - Same fixed-stack shape as RAG System — no framework or provider
prompt. Extras:ruff,pytest,github-actions. - Fully supported by non-interactive mode (
--template mcp,--config
JSON files,--dry-run) with zero additional code — confirms the
registry-driven design from v1.0.2 extends cleanly to new intents.
Compatibility
Backward compatible. Existing templates and workflows unchanged.
Targets the mcp SDK's current v2.0 line (MCPServer, not the
now-legacy FastMCP/v1.x API).
Verified
893 tests passing (866 v1.0.2 baseline + 27 new). Verified end-to-end
with a live spawn create --template mcp run — real mcp package
install, generated project's own test suite passing, ruff check
clean, and the server module loading and running correctly.
Spawn v1.0.2
v1.0.2 — Non-Interactive Mode
Spawn can now be driven entirely without prompts — built for scripting,
CI, and agent-driven callers (Claude Code, other coding agents, etc.)
that need to scaffold a project without a human at the keyboard.
Added
- Non-interactive flags —
spawn createnow accepts--name,
--template,--framework,--provider,--cli-type,--data-type,
--extras,--git/--no-git, and--uv/--no-uv. Passing--name
switches the command into non-interactive mode and skips every prompt. --config <file.json>— point at a JSON config file instead of
flags. Takes precedence over individual flags when both are given.--dry-run— validates the resolved config and prints it without
creating anything, useful for a pre-flight check in scripts.--yes/-y— explicitly skips the GitHub-publish prompt.
Non-interactive mode also skips it automatically on its own, so
agent-driven runs never block waiting on stdin.
Covers all 7 registry templates (Backend API, CLI, Automation, Chatbot,
Agent, RAG, Data Project). Custom Structure remains interactive-only in
this release.
Example
spawn create --name my-api --template backend-api --framework fastapi \
--extras ruff,pytest --gitor with a config file:
{
"name": "my-api",
"template": "backend-api",
"framework": "fastapi",
"extras": ["ruff", "pytest"],
"git": true,
"uv": true
}spawn create --config spawn.jsonCompatibility
Fully backward compatible — running spawn create with no flags behaves
exactly as before. 866 tests passing (33 new).