Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/SGizek/Raiku/llms.txt

Use this file to discover all available pages before exploring further.

raiku pin lets you lock a package at a specific version so that raiku update --all skips it entirely. Pinning is useful whenever a package serves as a stable baseline — a library whose API your code depends on, a toolchain at a known-good version, or a package you are evaluating before committing to an upgrade. Pins are recorded in ~/.raiku/pins.json and persist across sessions.

​
Usage

raiku pin add PACKAGE [VERSION] [--reason TEXT]
raiku pin remove PACKAGE
raiku pin list

​
Subcommands

SubcommandDescription
add PACKAGE [VERSION]Pin PACKAGE at VERSION. If VERSION is omitted, the currently installed version is used.
remove PACKAGERemove the pin from PACKAGE, allowing future updates.
listShow all currently pinned packages with version, date, and reason.

​
Flags for add

FlagDescription
--reason TEXTOptional note stored alongside the pin explaining why it was created.

​
Behavior

  • Pinned packages are skipped by raiku update --all. Raiku will print a notice that the package is pinned and move on.
  • Pinned packages can still be updated explicitly by naming them directly (raiku update fast-math) and using --force if needed.
  • The pin stores the version string at the time pin add is called. If you later install a different version manually, you may want to re-pin with the new version.
  • Pin storage: ~/.raiku/pins.json — a JSON file keyed by lowercase package name containing the pinned version, timestamp, and optional reason.

​
Examples

raiku pin add fast-math

​
Sample raiku pin list output

 Package      Pinned Version  Pinned Since  Reason
 ─────────────────────────────────────────────────────────────────
 fast-math    1.0.0           2024-10-05    stable baseline for prod
 goqueue      0.9.1           2024-09-18    —

2 pinned package(s).

​
Pin storage format (~/.raiku/pins.json)

{
  "pins": {
    "fast-math": {
      "name": "fast-math",
      "version": "1.0.0",
      "reason": "stable baseline for prod",
      "pinned_at": 1728086400
    }
  }
}
Pin packages that serve as integration baselines before running raiku update --all. This way you can update the majority of your packages safely without risking regressions in the packages that matter most. Add a --reason to document your intent for future reference.
Pins are per-machine — they live in ~/.raiku/pins.json and are not committed to source control. If you want reproducible installs across machines, use raiku from-lock with a committed raiku.lock file instead of relying solely on pins.

Build docs developers (and LLMs) love

Get started for freeTalk to us