Skip to content

Releases

Spawn v1.1.1

Choose a tag to compare

@Abhiix0 Abhiix0 released this 09 Nov 16:04
32cd50a

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 spawnio

Package: spawnio
Version: 1.1.1

Spawn v1.1.0

Choose a tag to compare

@Abhiix0 Abhiix0 released this 27 Oct 01:01
668e227

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 stdout

What 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 partial status 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*.txt and package.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, src layout, and Spawn-generated projects.

Other changes

  • spawn --version prints the same line as spawn version.
  • spawn inspect --verbose shows more detail in the human report.
  • A documented JSON report contract (schema 1.0) with validate_report, to_json and from_json in spawn.inspection.
  • New exit code 7 for an invalid path or failed inspection. In --json mode errors go to stderr and stdout stays empty.
  • Release smoke test now runs spawn inspect . --json on a generated project and verifies it is unchanged.
  • create, doctor and version behave 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, coverage and 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.xml and 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_json for library callers (the CLI still works). A fix is planned.
  • summary.name is the directory name, and primary_framework may be inferred.

Upgrade

pip install -U spawnio    # or: uv tool upgrade spawnio

Full changelog: see docs/changelog.md

Spawn v1.0.9

Choose a tag to compare

@Abhiix0 Abhiix0 released this 09 Oct 08:36
99fdeac

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-uv is now honored for template projects. It previously still ran uv. Without uv, Spawn skips uv init, dependency installs and extras that need pyproject.toml (Dockerfile, CI workflow, ruff/pytest/mypy config). It prints one line listing what was skipped. File-only extras such as pre-commit are still written.
  • Interactive spawn create --dry-run now 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.destination and to_dict(), plus plan_project and generate_project as 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=1 to 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).
  • --config with an explicit --no-git/--no-uv now 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

Choose a tag to compare

@Abhiix0 Abhiix0 released this 28 Sep 12:40
aef457d

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.example and pyproject.toml are reported as manual actions.
  • Ctrl+C or a declined prompt exits cleanly (130) with nothing written.

Added

  • --license mit|none on spawn create (also "license" in JSON config files), plus an interactive license prompt, MIT by default. The holder comes from git config user.name, falling back to " contributors".
  • CHANGELOG.md is generated for every new project (Keep a Changelog format).
  • pre-commit and mypy extras 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 Mypy option.

Fixed

  • --template help text now lists all 8 slugs, including mcp.

Upgrade

pip install -U spawnio    # or: uv tool upgrade spawnio

Full changelog

See CHANGELOG.md for complete details.

Spawn v1.0.7

Choose a tag to compare

@Abhiix0 Abhiix0 released this 21 Aug 06:42
e2e322a

v1.0.7

Fixed

  • UTF-8 console output crash on Windows — spawn create and spawn doctor no longer raise UnicodeEncodeError when 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 with errors="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 of PRN raising a raw traceback.

Documentation

  • Clarified the Python 3.12+ prerequisite — installing via pip on 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

Choose a tag to compare

@Abhiix0 Abhiix0 released this 15 Aug 10:37
cd9c1e1

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 stays spawn.

Fixed

  • spawn create no longer shows the banner (bare spawn remains the
    "home screen" that shows it).
  • docs/commands.md and docs/getting-started.md rewritten 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

Choose a tag to compare

@Abhiix0 Abhiix0 released this 13 Aug 04:06
bdc134b

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 by questionary) instead
    of numbered prompts.
  • spawn with 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 single Cancelled. message and exits with code 130.
    Previously this varied by exactly where you interrupted: Click's
    own Aborted./exit-1 at text prompts, questionary's own
    Cancelled by user/exit-130 at menus, and a bare ^C with 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

Choose a tag to compare

@Abhiix0 Abhiix0 released this 06 Aug 09:28

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.md Generation — 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 (not OLLAMA_BASE_URL)

  • openai-agents + openrouter $\rightarrow$ OPENAI_API_KEY + OPENAI_BASE_URL (not OPENROUTER_API_KEY)

  • RAG System: States the required OPENAI_API_KEY and ingestion mechanics.

  • MCP Server: Explains how to add tools/resources via the mcp SDK decorator API.

  • Custom Structure Support — Generates AGENTS.md only if included in the user's pasted structure (matching README.md and .gitignore behavior).

  • --claude-md / --no-claude-md Flags — Opt-in generation of an identical CLAUDE.md file alongside AGENTS.md (supported via CLI flag, interactive prompt, and "claude_md" config file key; off by default).

  • spawn doctor Check — Now checks for AGENTS.md under Recommended-tier Documentation items.

Compatibility

  • Fully backward compatible. Existing templates and workflows remain unchanged.

Verification

  • 916 tests passing. Verified end-to-end across:
  • --config JSON opt-in flow
  • Interactive Custom Structure opt-in (confirmed byte-identical output between AGENTS.md and CLAUDE.md)
  • Non-standard environment variable provider/framework mappings

Spawn v1.0.3

Choose a tag to compare

@Abhiix0 Abhiix0 released this 04 Aug 10:34
4199f84

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 official mcp Python SDK's MCPServer class,
    with one working example tool (add) and one example resource
    (info://server) over stdio transport, 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 into claude_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

Choose a tag to compare

@Abhiix0 Abhiix0 released this 04 Aug 04:55
938a395

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 create now 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 --git

or with a config file:

{
  "name": "my-api",
  "template": "backend-api",
  "framework": "fastapi",
  "extras": ["ruff", "pytest"],
  "git": true,
  "uv": true
}
spawn create --config spawn.json

Compatibility

Fully backward compatible — running spawn create with no flags behaves
exactly as before. 866 tests passing (33 new).