spin v0.0.2-alpha

spin v0.0.2-alpha

The one where spin new stops blindly running shell scripts.

Interactive hook review

2026-07-22T05-19-41-911Z.mp4

spin new now has a second TUI step after the params form. Before any hook
runs, you see a scrollable list of every [[pre]] and [[post]] command
the template will execute. Press R to open a Run / Skip / Cancel modal.
No shell command runs without your review.

The right pane streams live output with ANSI coloring, tree-styled headers,
and proper wrapping. No more curl | sh anxiety.

Templated prompts and defaults

Params can now reference other values in their prompts and defaults:

[params]
project_name = { type = "text", prompt = "Project name" }
module       = { type = "text", default = "github.com/me/{{ .project_name }}" }

The TUI form also opens pre-filled with name, project_name, and any
--param values you pass, matching the non-interactive path.

Shared hook output

Hook output in the TUI now uses tree-styled headers and dim indented
lines (├── pre-hook, │ continuation) instead of raw log output. The
tree writer is shared between TUI and CLI paths.

Fixes

• Registry and pin updates now report "already up to date" instead of
  silently succeeding.

• Select params reject defaults outside the option list.
• min_spin_version check handles development builds (no more false
  rejections from go test or dirty working trees).

Under the hood

• Bubble Tea upgraded to v2.0.8.
• Template helper functions (upper, lower, snake_case, etc.) moved
  into internal/params for shared use across the codebase.
• Version command improved — derives correct version from build info when
  installed via go install, falls back to devel for local builds.

Released 2026-07-22T05:05:51Z.

Changelog

• c406568 FORMAAAAAAAAAAAT
• bea70bc better version code thanks @charmbracelet/crush <:
• 2c9234c chore(deps): bump charm.land/bubbletea/v2 from 2.0.7 to 2.0.8 (#5)
• 6d6e190 feat(cmd): add interactive hooks review TUI for spin new
• daf3f50 feat: render param prompts and defaults as templates
• 5d7ea3e feat: seed builtins and --param values into the TUI form
• d6a1517 fix for ci <:
• 42fae93 fix the wrong stuff i made while merging conflicts <:
• 00b08d7 fix version command and updated goreleaser/taskfile
• 50854a8 fix(cmd): polish hooks TUI with wrapping, Cancel, and layout constants
• cdb52c0 fix(registry): report "already up to date" for unchanged registries
• cab2dbb fix(update): report "already up to date" when a pin is unchanged
• 0988f1b fix: apply CodeRabbit auto-fixes
• 83c3cc6 fix: reject select defaults outside option list
• 1b8d6e0 fixed the stuff coderabbit said it but in better way <:
• ebb7d61 formating
• e4e528c go mod tidy <:
• 28d5c28 min spin version isnt needed today
• d095ef5 refactor(cmd): extract shared hook tree writer and StepStart callback
• f531584 refactor: consume shared FuncMap from internal/params
• d64e0c6 refactor: move template helpers to internal/params
• 0372af4 sanity readme comments formatting XDDDD
• eacdb8d static check stuff
• d360e85 update readme.

Install

go install github.com/N1xev/spin@v0.0.2-alpha

Or download a binary below.

spin v0.0.1-alpha

spin v0.0.1-alpha

Released 2026-07-15T23:44:27Z.

Changelog

• 86a6c40 .planning update
• 317fc70 Add task install target for local development
• 6f79af6 Add terminal-aware table rendering with auto-truncation
• 7468efd Block scaffolding when template requires a newer spin version
• 9cb0a95 Build test binary once and reuse across all integration tests
• a5255b1 Create govulncheck.yml
• d33c731 Fix broken symlinks for relative local paths and validate templates at pin time
• ea3845e Flatten CLI error messages to zero-level and document the convention
• 76b36c6 Improve terminal table display with column separators and ~ path shorthand
• cdfd371 Prevent git clone tests from hanging for 2 minutes
• 7cf071f Remove version field from spin.toml and wire min_spin_version to all load paths
• 6101677 Wire git describe output into spin version at build time
• ccc8380 added better docs to use with docus (i may remove it later)
• 9885709 another fix on goreleaser >:
• 2c336bb bump
• 1975303 charm: promote bubbletea/v2 to a direct dependency
• 8c82071 chore(02): gofumpt formatting + Phase 2 closeout
• ebc6090 chore(04-01): promote charm.land/lipgloss/v2 to direct dep
• 0d372bf chore(04-05): strip generated-by markers from 26 .tmpl files per D-12
• 343a1c4 chore(deps): add charm.land/log/v2 for structured logging
• 95b6fe4 chore(deps): bump charm.land/lipgloss/v2 from 2.0.3 to 2.0.5
• 6c4e402 chore(deps): bump golang.org/x/text from 0.24.0 to 0.40.0
• 1e8d8d2 chore: add project config
• 86cca5c chore: add trailing newline to internal/version/doc.go
• e67b0e4 chore: merge Plan 02-05 worktree (template restructure + walker substitution)
• 73ff988 chore: merge executor worktree (worktree-agent-a0bb80fd652e968c2)
• 7e36846 chore: merge executor worktree (worktree-agent-aa49889d557bf80a1)
• 8cfd101 chore: merge quick task 260604-7jt worktree (drop glow + modifiers)
• 2b95acb chore: remaining infrastructure and utility changes
• 9adbbf3 chore: remove unused dogfood workflow and v1-leak grep script
• b7b6013 chore: remove unused taskfile targets and scripts
• 811692f chore: switch license from MIT to Apache 2.0
• 24df007 chore: update Go toolchain to 1.26.5
• 39f8136 chore: update linter to v2 format, add Taskfile fmt task, fix goreleaser install path
• c215d8e ci(04-06): add dogfood + base CI workflows and dependabot
• 674be8b ci(04-06): add dogfood smoke-test script
• 3ffe957 ci: update workflows to Go 1.26.5, add fmt/tidy/staticcheck/install checks
• 6bd5cf2 docs(01): add code review report
• 04c7759 docs(01): add phase verification report
• 058c4d2 docs(01): create phase 1 plan — scaffolder foundation + core TUI stack
• bad2dd5 docs(01): track wave 1+2 plan completion
• 0672353 docs(01-01): complete walking skeleton plan summary
• ae0b574 docs(01-02): complete plan 02 summary
• 445e5d9 docs(01-03): complete template engine + full TUI scaffold plan
• 83ab252 docs(01-04): complete CI grep suite + integration test + repo polish plan
• 1d2a377 docs(02): add code review report
• 108af1c docs(02): research + 4 plans + plan-check report (CLI variant + wrappers + libs + external templates)
• 34aa270 docs(02): update VERIFICATION status to verified (WR-010 fixed)
• 4b702e6 docs(02-01): add plan summary (foundation refactor)
• eca3a14 docs(02-02): add plan summary (post-executor recovery)
• 285cee1 docs(02-03): add plan summary (post-quota recovery)
• 561cd64 docs(02-04): add plan summary
• 9d392d6 docs(02-05): plan + summary + verification addendum; update 03-04 for new layout
• c16b099 docs(03): UI design contract
• 4c58289 docs(03): add code review report
• b2a4c24 docs(03): add phase verification report
• 5877940 docs(03): create phase plan
• f9f2ced docs(03): research phase 3 — interactive prompts + AGENTS.md
• 40ab4a7 docs(03-01): add plan summary
• b053507 docs(03-02): add plan summary
• 7446d3b docs(03-03): complete gum shell-out backend plan
• 5900aaa docs(03-04): complete AGENTS.md + --ai flag plan
• ea2d981 docs(04): capture phase context
• b88d849 docs(04): create phase 4 plan — 6 plans in 4 waves (post-scaffold health + dogfooding)
• 42dde6d docs(04): create phase plan
• 7e5e8d8 docs(04): mark phase 4 complete in STATE + ROADMAP
• 7ca150c docs(04-01): complete spin doctor plan
• b076488 docs(04-02): complete spin lint plan
• db6ee5f docs(04-03): complete spin update engine plan
• 7b56d05 docs(04-04): complete plan summary
• 6a2b56e docs(04-05): complete plan summary
• 5d9267a docs(04-06): complete CI dogfood plan summary
• cce1905 docs(05): add CONTEXT.md from conversation
• 31eb1be docs(05): add code review report
• bd03b34 docs(05): add loader.go to plan 04 task 3 files (cloner field)
• 935a161 docs(05): complete phase execution
• 7ac97c3 docs(05): create phase 5 plan (4 plans, 2 waves)
• 26e8773 docs(05): create phase plan
• e5c6853 docs(05): evolve PROJECT.md after phase completion
• 55c7439 docs(05): revise plans per plan-checker feedback
• b71ed9f docs(05-02): complete ecosystem dispatch + template loader plan
• 10bbf9a docs(05-02): update STATE.md and ROADMAP.md after plan 05-02
• 0de7ac0 docs(05-03): complete registry client hardening plan summary
• c39fc55 docs(05-04): complete runner integration plan summary
• 0234035 docs(260604-7jt): pre-dispatch plan for remove glow + modifiers
• 26ea3b3 docs(quick-260604-7jt): remove glow library + modifiers flag from spin
• 436ef67 docs(research): synthesize v2.x local-registry research
• d759fa8 docs(state): record phase 04 context session
• 7361cf3 docs: create roadmap (4 phases)
• c64acc6 docs: create v2.x local-registry roadmap (3 phases)
• 954f57f docs: define v1 requirements
• c67e93b docs: define v2.x local-registry requirements
• 42c4ced docs: initialize project
• 83db6b7 docs: minor CONTRIBUTING.md update
• 311abf3 docs: research charmbracelet v2 ecosystem for spin
• 91c255c docs: rewrite README to be minimal and human-readable
• 1862871 docs: start milestone v2.x local-registry
• 03479c9 docs: update README, remove CLAUDE.md and PRD.md, add AGENTS.md and spin-registry.md
• 2d0bedc feat(01-01): scaffold engine with Project struct, embed walker, and render pipeline
• 83c02af feat(01-01): spin binary scaffold (go.mod + main.go + cmd/root.go + cmd/new.go)
• 5b779a1 feat(01-01): walking skeleton end-to-end smoke test
• bf3ef3b feat(01-01): walking skeleton templates (_base + variant_tui + lib/bubbletea)
• 86ccb74 feat(01-02): VerifyBuild smoke test + GitInit (env-guarded)
• b823e89 feat(01-02): expand Project struct + ResolveFlags for full flag binding
• cad2eee fea...