v1.4.1 - Added DB commands

Adds CLI-direct wipe / seed / fresh commands against vormia-go db.Wipe and seed.Run. Depends on vormia-go v1.2.1+.

Commands

Command	Description
vormia db:wipe	Drop all tables on the target connection
vormia db:seed	Run *.sql seeders under database/seeders (filename order; no tracking table)
vormia db:fresh	Wipe, migrate all, then seed
vormia migrate:fresh	Wipe all tables, then re-run all migrations

Shared flag on each: --database=<name> (empty = DB_CONNECTION, else "default").

Behavior note

migrate:fresh uses wipe-then-Up, not replaying .down.sql. That differs from migrate:refresh (reset via downs, then up) and matches Laravel’s migrate:fresh semantics — more robust when down files are incomplete.

Notes

• Seeders are expected to be idempotent (INSERT … ON CONFLICT / IGNORE)
• Not in this release: cache:*, route:list, queue/schedule/mail generators

Docs

• README, aiguide/GUIDE.md, aiguide/CURSOR_CODEX_MCP_GUIDE.md

v1.4.0

v1.4.0

Adds toolchain wrappers, make:* generators, and vormia upgrade. All are CLI-only — no new vormia-go APIs required.

Install

go install github.com/vormialabs/vormia-go-cli/cmd/vormia@v1.4.0

Or: vormia self-update

Toolchain

Command	Description
vormia build / vormia run build	go build -o bin/<name> .
vormia run dev	Alias of serve
vormia test	go test ./...
vormia tidy	go mod tidy
vormia install	go mod download or go get <pkg...>
vormia about	Pretty-print .vormia.json

Generators

make:handler, make:controller (deprecated alias), make:service, make:model, make:middleware, make:adapter, make:provider, make:test, make:migration

Upgrade

vormia upgrade runs go get @latest for Vormia modules present in go.mod, then go mod tidy.

Not in this release

migrate:fresh, db:wipe, db:seed, db:fresh, cache:*, route:list, queue/schedule/mail generators

See RELEASE_NOTES.md for full details.

CLI Command Added

v1.3.0

Adds CLI-direct migrate commands against ./database/migrations, using the project's .env and bundled SQLite / Postgres / MySQL drivers. Depends on vormia-go v1.1.1+ (Migrator.Status).

Commands

Command	Description
vormia migrate	Run all pending migrations
vormia migrate:rollback	Roll back the last batch (--steps=N optional)
vormia migrate:reset	Roll back all migrations
vormia migrate:refresh	Reset, then re-run all migrations
vormia migrate:status	Show applied vs pending
vormia migrate:version	Print the latest applied version

Shared flag on each: --database=<name> (empty = DB_CONNECTION, else "default"). Named connections use DB_<NAME>_* env keys (e.g. DB_MYSQL2_DRIVER).

vormia migrate
vormia migrate --database=mysql2
vormia migrate:rollback --steps=1
vormia migrate:status

Notes

• Runs from a project root (requires .vormia.json); migrations live in database/migrations/ as <version>.up.sql / <version>.down.sql
• Pure Go build (modernc SQLite — no cgo)
• Not in this release: migrate:fresh, db:wipe, db:seed, db:fresh (need db.Wipe + a seeder model first)

Docs

• README, aiguide/GUIDE.md, aiguide/CURSOR_CODEX_MCP_GUIDE.md

---

Patch release: unauthenticated REST API rate limit is exhausted.

vormia-go-cli v1.2.1

Patch release after v1.2.0. Fixes vormia starterkit install when GitHub’s unauthenticated REST API rate limit is exhausted.

Install

go install github.com/vormialabs/vormia-go-cli/cmd/vormia@v1.2.1

Or update an existing install:

vormia self-update
# or: go install github.com/vormialabs/vormia-go-cli/cmd/vormia@v1.2.1

Requires Go 1.26+. Verify with vormia --version → vormia version 1.2.1.

Highlights

vormia starterkit install no longer uses api.github.com

Install now resolves and downloads the vormia-go-starter-kit release tarball over public github.com HTTPS only:

• Latest stable — follows github.com/.../releases/latest to discover the tag, then downloads vormia-starterkit-<tag>.tar.gz
• Pinned — --version vX.Y.Z downloads that tag’s tarball directly
• Unaffected by REST API rate limits (the previous 403 Forbidden when an IP hit 60 unauthenticated requests/hour)

vormia starterkit install                  # latest stable
vormia starterkit install --version v1.0.1 # pin a tag
vormia starterkit install --beta --version v1.1.0-beta.1  # pin a pre-release

--beta alone is invalid — pin a pre-release with --version. GitHub’s /releases/latest never points at prereleases.

Docs

• README, aiguide/GUIDE.md, and aiguide/CURSOR_CODEX_MCP_GUIDE.md updated for the new download path and --beta / --version rules

Related packages

• vormia-go — application kernel and contracts
• vormia-go-starter-kit — scaffold folders installed via vormia starterkit install
• vormia-go-driver-chi — chi router driver
• vormia-go-driver-sqlite — SQLite driver
• vormia-go-driver-postgresql — PostgreSQL driver
• vormia-go-driver-mysql — MySQL driver
• vormia-go-driver-redis — Redis cache driver

License

Apache-2.0 — see LICENSE.

Release of the Vormia Go CLI

vormia-go-cli v1.2.0

Release of the Vormia Go CLI since v1.0.0. Adds starter kit install/publish (introduced in the v1.1.0 line of work) and vormia self-update for refreshing the CLI binary. Slice 1 commands (new, serve, doctor) are unchanged.

Install

go install github.com/vormialabs/vormia-go-cli/cmd/vormia@v1.2.0

Or update an existing install:

vormia self-update
# or: go install github.com/vormialabs/vormia-go-cli/cmd/vormia@v1.2.0

Requires Go 1.26+. Verify with vormia --version → vormia version 1.2.0.

Highlights

vormia starterkit install / publish

Optional fuller app layout from vormia-go-starter-kit, run after vormia new (or on a hand-written Vormia app with .vormia.json + go.mod):

cd blog
vormia starterkit install                  # latest stable release tarball
vormia starterkit install --version v1.0.1 # pin a tag
vormia starterkit install --beta           # include pre-releases

vormia starterkit publish                  # prompts for drivers + output mode
vormia starterkit publish --drivers sqlite,postgres

• Downloads the release tarball and extracts config/, database/, internal/, logs/, pkg/, and templates/
• Additive only — never overwrites existing files; skipped paths are reported
• Rewrites the module placeholder to the project's go.mod module path
• publish renders main.go (stdout / main.go.example / overwrite + .bak), .env.example, and INTEGRATION.md

vormia self-update

Reinstalls the CLI binary via go install (cobra-only; no new dependencies):

vormia self-update                  # @latest
vormia self-update --version v1.2.0 # pin
vormia self-update --check          # current vs latest stable; no install

• Requires go on PATH
• With --check, --version is ignored — comparison is always against the latest stable GitHub release
• Replaces a binary installed into GOPATH/bin (or GOBIN); a hand-built ./vormia elsewhere is not updated

Docs

• README — starter kit, self-update, and how to check/update the CLI vs framework packages
• aiguide/GUIDE.md — architecture walkthrough
• aiguide/CURSOR_CODEX_MCP_GUIDE.md — agent operating rules

What's next

Still deferred until matching framework / manifest work lands:

• make:model, make:controller, make:service — ORM slice
• migrate up / migrate down — migration system
• upgrade — bump a project's pinned framework/driver versions in go.mod (not the CLI binary; use self-update for that)

Related packages

• vormia-go — application kernel and contracts
• vormia-go-starter-kit — scaffold folders installed via vormia starterkit install
• vormia-go-driver-chi — chi router driver
• vormia-go-driver-sqlite — SQLite driver
• vormia-go-driver-postgresql — PostgreSQL driver
• vormia-go-driver-mysql — MySQL driver
• vormia-go-driver-redis — Redis cache driver

License

MIT — see LICENSE.

First stable release

vormia-go-cli v1.0.0

First stable release of the Vormia Go CLI — the artisan-style command-line tool for the Vormia Go application framework. This release ships Slice 1: scaffold a project, run it locally, and verify your environment.

Install

go install github.com/vormialabs/vormia-go-cli/cmd/vormia@v1.0.0

Requires Go 1.26+. Verify with vormia --version.

Highlights

vormia new — project scaffolding

Creates a working slice-1 application in seconds:

vormia new blog --db sqlite
cd blog
go mod tidy
vormia serve

• Chi router, /health route, and graceful shutdown wired through the vormia-go kernel
• Database driver of your choice: --db sqlite (default), postgres, or mysql
• Optional Redis cache with --cache redis
• Custom module path with --module example.com/blog
• Generates main.go, go.mod (with pinned framework and driver versions), .env.example, .gitignore, and .vormia.json project metadata for future upgrade tooling
• Templates are embedded in the binary via //go:embed — no external files needed, works offline

vormia serve — run the app

Runs go run . from the project root. Requires .vormia.json, so it only runs inside a scaffolded Vormia project. The app kernel handles serving and shutdown; the CLI stays out of the run loop.

vormia doctor — environment checks

Confirms the Go toolchain is on PATH and, when run inside a project, that .vormia.json is present.

Generated project layout

blog/
├── main.go           # kernel + chi + driver wiring + /health route
├── go.mod            # pinned framework and driver versions
├── .env.example      # APP_PORT, DB_*, REDIS_* placeholders
├── .gitignore
└── .vormia.json      # project metadata (name, module, drivers, framework version)

Generated projects pin v1.0.0 of vormia-go and the selected drivers.

What's next

Commands ship alongside the framework slices they depend on:

• make:model, make:controller, make:service — waiting on the framework ORM slice
• migrate up / migrate down — waiting on the migration system
• install — waiting on the config/provider slice
• upgrade — waiting on release manifests

Related packages

• vormia-go — application kernel and contracts
• vormia-go-driver-chi — chi router driver
• vormia-go-driver-sqlite — SQLite driver
• vormia-go-driver-postgresql — PostgreSQL driver
• vormia-go-driver-mysql — MySQL driver
• vormia-go-driver-redis — Redis cache driver

License

MIT — see LICENSE.