Skip to main content

Netrunner integration

ymirr CLI v2 integrates Netrunner for database clone management. You can use it from the Developer Tools menu or from the command line.

From the menu​

  1. Run ymirr (no arguments).
  2. Choose Developer Tools.
  3. Choose Netrunner — clone.
  4. Then choose:
    • List clones — runs netrunner clone list
    • Create clone — prompts for clone ID and project slug (default from ymirr.toml), then runs netrunner clone create <id> --project <slug>
    • Destroy clone — prompts for clone ID, runs netrunner clone destroy <id>
    • Clone status — prompts for clone ID, runs netrunner clone status <id>

This works even when you are not in a project directory; only Create uses the current project as a default for --project.

From the command line​

All arguments after ymirr netrunner are passed to the Netrunner CLI:

ymirr netrunner clone list
ymirr netrunner clone create my-db --project my-project
ymirr netrunner clone create my-db --project my-project --ttl 2h --sync
ymirr netrunner clone status my-db
ymirr netrunner clone destroy my-db

See Netrunner — Database cloning for the full Netrunner command reference (branch, database names, --sync, --ttl, etc.).

Requirements​

  • @ymirr/netrunner must be installed (e.g. npm install -g @ymirr/netrunner or via ymirr setup → Global packages).
  • Authentication — Netrunner uses the same token as the legacy ymirr auth: set CLI_AUTH_TOKEN in ~/.ymirr-env or use ymirr login (from the legacy @ymirr/ymirr package) so the token is stored where Netrunner expects it.
  • API_URL — Optional; defaults to https://netrunner.semiotic.eu/ if not set. Can be set in ~/.ymirr-env.

The CLI does not implement auth itself; it only forwards to the Netrunner binary and passes through the environment (including CLI_AUTH_TOKEN and API_URL).