Migrondi 2.0.1

dotnet tool install --global Migrondi --version 2.0.1
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local Migrondi --version 2.0.1
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Migrondi&version=2.0.1
                    
nuke :add-package Migrondi --version 2.0.1
                    

.NET Core NuGet Version NuGet Version NuGet Version

Migrondi

Migrondi is a SQL migrations tool: write versioned .sql files and it tracks which ones a database has applied, then applies pending migrations or rolls applied ones back.

It supports SQLite, SQL Server, PostgreSQL, and MySQL. The CLI runs on Windows, Linux, and macOS (x64 and arm64). The desktop app, Migrondi UI, runs on Windows x64, Linux x64, and macOS arm64.

Install

.NET tools

The CLI installs as migrondi; the desktop app and its HTTP MCP host install as migrondiui. Both tools target .NET 10 and .NET 11, so a tool install needs a matching .NET 10 or .NET 11 runtime. The Migrondi.Core and Migrondi.Mcp libraries target .NET 10 only.

dotnet tool install --global Migrondi
dotnet tool install --global MigrondiUI

Run a tool without installing it:

dnx Migrondi -- list
dnx MigrondiUI -- --http 8080

Windows: Scoop

scoop install https://github.com/AngelMunoz/Migrondi/releases/latest/download/migrondi.json
scoop install https://github.com/AngelMunoz/Migrondi/releases/latest/download/migrondi-ui.json

These addresses serve the newest stable release manifest. Scoop checks the SHA-256 before installing, and scoop update adopts each new release.

migrondi.json installs the CLI command on Windows x64 and ARM64. migrondi-ui.json installs the desktop app with a Start-menu shortcut on Windows x64 only; the UI has no Windows ARM64 build.

Linux: Flatpak

Install from the Flatpak channel to get updates with flatpak update --user: the CLI for Linux x64 and ARM64, the UI for Linux x64 only.

flatpak install --user --from https://angelmunoz.github.io/Migrondi/io.github.angelmunoz.migrondi.flatpakref
flatpak install --user --from https://angelmunoz.github.io/Migrondi/io.github.angelmunoz.migrondi.ui.flatpakref

That registers the migrondi channel and installs the newest stable release; Flatpak picks the build for your machine's architecture. The CLI installs as io.github.angelmunoz.migrondi and provides the migrondi command (flatpak run io.github.angelmunoz.migrondi list). The UI installs as io.github.angelmunoz.migrondi.ui with its desktop launcher.

Direct-install bundles ride each release for one-off installs (migrondi-linux-<arch>.flatpak and migrondiui-linux-x64.flatpak, plus versioned names); a bundle install gets no updates, so prefer the channel above:

flatpak install --user --bundle https://github.com/AngelMunoz/Migrondi/releases/latest/download/migrondi-linux-x64.flatpak

Binary archives

Download the archive for your platform from the releases page. Each release also carries a .sha256 file for its archives.

App Platforms Archive
CLI win-x64, win-arm64, linux-x64, linux-arm64, osx-x64, osx-arm64 migrondi-<version>-<rid>.zip
Migrondi UI win-x64, linux-x64, osx-arm64 migrondiui-<version>-<rid>.zip

The archives are self-contained: they bundle the .NET 11 runtime and need no .NET installation. Extract the archive and add its folder to PATH (the CLI) or start the app from it (the UI).

Migrondi UI keeps its database and virtual project files in your local application data folder, so an app or tool update does not replace them.

Migrondi UI needs Vulkan 1.3. On Linux it also needs a native Wayland session; X11 and XWayland are not supported.

Agent skills

The repository ships two agent skills: migrondi-cli (drive the CLI and its MCP server) and migrondi-library (embed Migrondi.Core). Install them with the skills CLI:

npx skills add AngelMunoz/Migrondi --skill migrondi-cli --skill migrondi-library

Run npx skills add AngelMunoz/Migrondi --list to see everything the repository offers first.

Quick usage reference

Usage:
  Migrondi [command] [options]

Options:
  --version       Show version information
  -?, -h, --help  Show help and usage information

Commands:
  init, setup <path>         Creates a migrondi.json file where the command is invoked or the path provided
  create, new <name>         Creates a new SQL migration file in the configured migrations directory
  apply, up <amount>         Applies pending migrations
  down, rollback <amount>    Rolls applied migrations back
  list, show                 Reads migration files and the database to show the current state
  show-state, status <name>  Checks whether a migration is applied or pending
  mcp                        Runs an MCP server over stdio for the project in the current directory or --config

Build

dotnet restore
dotnet build Migrondi.slnx
dotnet test Migrondi.slnx

Publish a self-contained folder for a platform:

dotnet publish src/Migrondi/Migrondi.fsproj -c Release -f net11.0 -r <RID> --self-contained true -o dist
dotnet publish src/Migrondi.UI/Migrondi.UI.fsproj -c Release -f net11.0 -r <RID> --self-contained true -o dist

The release workflow (.github/workflows/release.yml) packs the .NET tools, builds the archives, and publishes the release. See CONTRIBUTING.md for the release checklist.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed.  net11.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
2.0.1 66 11/16/2026
2.0.0 59 11/16/2026
1.3.0 627 6/27/2026
1.3.0-beta-001 143 6/27/2026
1.2.0 1,252 2/11/2026
1.0.1 428 2/10/2026
1.0.0-rc-002 375 6/17/2025
1.0.0-beta-014 362 5/26/2025
1.0.0-beta-013 331 5/12/2025
1.0.0-beta-012 308 5/12/2025
1.0.0-beta-011 246 10/31/2024
1.0.0-beta-010 276 2/18/2024
1.0.0-beta-009 243 2/17/2024
1.0.0-beta-008 265 2/8/2024
1.0.0-beta-007 190 2/8/2024
1.0.0-beta-006 378 10/11/2023
1.0.0-beta-005 428 10/4/2023
1.0.0-beta-004 352 10/2/2023
Loading failed

### Added

- **Migrondi:** The CLI now installs on Windows ARM64 through Scoop (`migrondi.json` carries an `arm64` build beside `64bit`) and on Linux ARM64 through a Flatpak bundle (`migrondi-<version>-linux-arm64.flatpak`, plus the stable `migrondi-linux-arm64.flatpak` alias) built on an ARM runner. The UI still has no Windows or Linux ARM64 build, so its Scoop package and Flatpak bundle stay x64-only.
- **Project:** Releases now publish a Flatpak channel: each release's bundles are imported into an OSTree repository kept on the `flatpak` branch and served with the docs site, so installing via the `.flatpakref` files registers the `migrondi` remote and `flatpak update` picks up every new release. Direct-install bundles still ride each release.
- **Project:** The `migrondi-cli` agent skill now covers the `mcp` command, and the README shows how to install the Migrondi skills with `npx skills add AngelMunoz/Migrondi`. The MCP documentation is CLI-first and its harness examples register the server without `--config`, passing `configPath` per tool call.