Migrondi.Core
2.0.1
dotnet add package Migrondi.Core --version 2.0.1
NuGet\Install-Package Migrondi.Core -Version 2.0.1
<PackageReference Include="Migrondi.Core" Version="2.0.1" />
<PackageVersion Include="Migrondi.Core" Version="2.0.1" />
<PackageReference Include="Migrondi.Core" />
paket add Migrondi.Core --version 2.0.1
#r "nuget: Migrondi.Core, 2.0.1"
#:package Migrondi.Core@2.0.1
#addin nuget:?package=Migrondi.Core&version=2.0.1
#tool nuget:?package=Migrondi.Core&version=2.0.1
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 | Versions 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. |
-
net10.0
- FSharp.UMX (>= 1.1.0)
- FsToolkit.ErrorHandling (>= 5.2.0)
- IcedTasks (>= 0.11.9)
- Microsoft.Data.SqlClient (>= 7.1.1)
- Microsoft.Data.Sqlite (>= 10.0.14)
- Microsoft.Extensions.Logging (>= 10.0.14)
- Microsoft.Extensions.Logging.Console (>= 10.0.14)
- MySql.Data (>= 26.10.0)
- Npgsql (>= 10.0.3)
- SQLitePCLRaw.bundle_e_sqlite3 (>= 3.0.5)
- System.Security.Cryptography.Pkcs (>= 10.0.14)
- Thoth.Json.Net (>= 12.0.0)
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 |
### 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.