CLI Reference

The trident command-line tool — manage instances, mods, accounts, and more from the terminal.

Installation

The CLI (trident) is included with Polymerium. It's also available as a standalone .NET tool:

dotnet tool install --global Trident.Cli

Option	Description
`--home <path>`	Override the data directory
`--json`	Output results as JSON
`--no-interactive`	Disable interactive prompts
`--verbose` / `--debug`	Increase output verbosity

trident instance create my-modpack --version 1.21.4 --loader fabric

Options:

trident instance list

trident instance inspect my-modpack

Shows version, loader, mod count, deploy status, and more.

trident instance build my-modpack

Runs the full deploy pipeline. Equivalent to clicking "Deploy" in the GUI.

trident instance run my-modpack

Deploys if needed, then launches Minecraft.

trident instance export my-modpack --format modrinth --output ./release/

Supported formats: trident, curseforge, modrinth, multimc.

trident instance import ./my-pack.mrpack

Auto-detects the format.

trident instance delete my-modpack

trident package search "sodium"

trident package add modrinth:sodium

The purl format is repository:project-id or repository:project-id@version-id.

trident package list --instance my-modpack

trident package enable modrinth:sodium --instance my-modpack
trident package disable modrinth:sodium --instance my-modpack

trident package version list modrinth:sodium

trident package version set modrinth:sodium <version-file-id>

trident loader list --instance my-modpack

trident loader set my-modpack --loader neoforge --version 21.4.0

trident account add

Launches the Device Code Flow in the terminal.

trident account add-offline --username Steve

trident account list

trident account remove <uuid>

trident repository list

trident repository status

trident repository add my-repo https://api.example.com

Start an MCP server for AI agent integration:

trident --mcp

See MCP Mode → for details.