Migrondi.Core 2.0.1

dotnet add package Migrondi.Core --version 2.0.1
                    
NuGet\Install-Package Migrondi.Core -Version 2.0.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Migrondi.Core" Version="2.0.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Migrondi.Core" Version="2.0.1" />
                    
Directory.Packages.props
<PackageReference Include="Migrondi.Core" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Migrondi.Core --version 2.0.1
                    
#r "nuget: Migrondi.Core, 2.0.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Migrondi.Core@2.0.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Migrondi.Core&version=2.0.1
                    
Install as a Cake Addin
#tool nuget:?package=Migrondi.Core&version=2.0.1
                    
Install as a Cake Tool

.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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Migrondi.Core:

Package Downloads
Migrondi.Mcp

This is the core library for the Migrondi CLI, you can use this library to run the same functionality of Migrondi as part of your source code or to write an abstraction for different kind of tools.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.1 60 11/16/2026
2.0.0 59 11/16/2026
1.3.0 215 6/27/2026
1.3.0-beta-001 151 6/27/2026
1.2.0 594 2/11/2026
1.1.0 152 2/11/2026
1.0.1 174 2/10/2026
1.0.0-rc-002 397 6/17/2025
1.0.0-beta-014 266 5/26/2025
1.0.0-beta-013 441 5/12/2025
1.0.0-beta-012 312 5/12/2025
1.0.0-beta-011 285 10/31/2024
1.0.0-beta-010 278 2/18/2024
1.0.0-beta-009 226 2/17/2024
1.0.0-beta-008 265 2/8/2024
1.0.0-beta-007 234 2/8/2024
1.0.0-beta-006 280 10/11/2023
1.0.0-beta-005 189 10/4/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.