Skip to content
  1. Home
  2. Docs
  3. CLI Reference
Back to docs
Documentation

CLI Reference

Every cryoctl command in one place. Just getting set up? Start with the docs overview — install, config, and the permission model.

Reference

cryoctl complete reference

All 14 commands with at least one real invocation example. cryoctl talks to the daemon over /run/cryo.sock — no root needed once your user is in the cryo group.

14 of 14

cryoctl status

One-shot snapshot of the daemon state — profile, temps and session peaks, fan RPM + boost, dGPU load/power/clock, VRAM with a per-process breakdown, power source and turbo

Options

--json — print the raw telemetry frame instead of the summary

Examples

cryoctl status
$ cryoctl status
cryoctl status
$ cryoctl status --json
profile   balanced
cpu       48°C  ·  peak 93°C  ·  1805 rpm (0%)  0 rpm (0%)
gpu       42°C  ·  peak 71°C  ·  1769 rpm (0%)  2846 rpm (0%)
dgpu      0% load  ·  16 W  ·  210 MHz
vram      1.4 / 12.0 GB
            0.2 GB  hyprland
            0.2 GB  chromium
            0.1 GB  python
power     AC  ·  turbo on

cryoctl watch

Live view of the 1 Hz telemetry stream — subscribes over the socket and re-renders until Ctrl-C

Options

--log FILE.csv — also append every frame as a CSV row (time, profile, temps, dGPU load/power/clock, VRAM, gaming/guard flags, fan RPMs, top VRAM process) for long sessions

Examples

cryoctl watch
$ cryoctl watch
cryoctl watch
$ cryoctl watch --log ~/cryo-session.csv

cryoctl profile <name>

Switch power mode: cool, quiet, balanced, performance, gmode, or custom. Manual picks stick until the next auto-rule event

No command-specific options.

Examples

cryoctl profile
$ cryoctl profile performance
cryoctl profile
$ cryoctl profile custom

cryoctl gmode

Toggle G-Mode — the same maximum-cooling profile the dedicated G-key and game detection trigger

No command-specific options.

Examples

cryoctl gmode
$ cryoctl gmode

cryoctl boost <cpu|gpu> <0-100>

Set a fan group's boost directly (percent). Thermal Guard still outranks manual boosts if a trip threshold is crossed

No command-specific options.

Examples

cryoctl boost
$ cryoctl boost cpu 60
cryoctl boost
$ cryoctl boost gpu 100

cryoctl turbo <on|off>

Toggle CPU Turbo via intel_pstate/no_turbo

No command-specific options.

Examples

cryoctl turbo
$ cryoctl turbo off

cryoctl light <effect> [RRGGBB]

Set the lighting effect on the chassis lights and, where present, the per-key keyboard: quantum, static, breathe, spectrum, rainbow, wave, backforth, or off. Color-based effects take an optional hex color

No command-specific options.

Examples

cryoctl light
$ cryoctl light quantum
cryoctl light
$ cryoctl light static 00d1ff

cryoctl brightness <0-100>

Set lighting brightness (percent) on the chassis lights and the per-key keyboard

No command-specific options.

Examples

cryoctl brightness
$ cryoctl brightness 80

cryoctl config

Print the effective daemon configuration — your /etc/cryo/config.json overrides deep-merged over the shipped defaults — plus the overrides on their own

No command-specific options.

Examples

cryoctl config
$ cryoctl config

cryoctl reapply

Re-assert lighting, the platform profile and NVML after the hardware came back changed — cryod-resume.service runs this after suspend and hibernate, and it is safe to run by hand

No command-specific options.

Examples

cryoctl reapply
$ cryoctl reapply

cryoctl cap

CPU performance cap per power mode (intel_pstate max_perf_pct): a ceiling on the CPU's top P-state, applied on every mode switch and after resume. No argument shows the current cap in the status line

Options

<10-100> — cap for the mode you're in right now<profile> <10-100> — cap for a specific mode, e.g. gmode 95off / on — leave the knob alone entirely / manage it again

Examples

cryoctl cap
$ cryoctl cap 90
cryoctl cap
$ cryoctl cap gmode 100
cryoctl cap
$ cryoctl cap off
power     AC  ·  turbo on  ·  cap 90%

cryoctl curve

Fan curve points and tuning. Points are TEMP:BOOST pairs; the daemon requires 2–8 points with rising temperatures and non-falling boosts, and rejects anything else with a reason

Options

show — points, hysteresis, min step<cpu|gpu> T:B [T:B…] — replace a curvehysteresis <°C> — dead zone before fans move (0–15)step <pct> — minimum boost change to write (1–25)

Examples

cryoctl curve
$ cryoctl curve show
cryoctl curve
$ cryoctl curve cpu 45:0 60:15 70:35 80:60 88:85 95:100
cryoctl curve
$ cryoctl curve hysteresis 2
cpu         45:0  60:15  70:35  80:60  88:85  95:100
gpu         45:0  60:15  70:40  80:70  87:100
hysteresis  3.0 °C
min step    5 %
curves      on

cryoctl guard

Thermal Guard thresholds — trip temperatures (60–105 °C), how far below trip both temps must fall to release (1–30 °C), and the minimum hold (0–600 s)

Options

show — current thresholds<cpu|gpu> <°C> — trip temperaturerelease <°C> — degrees below trip to releasehold <s> — minimum seconds engaged

Examples

cryoctl guard
$ cryoctl guard show
cryoctl guard
$ cryoctl guard cpu 90
cryoctl guard
$ cryoctl guard release 8
cpu trip    90 °C
gpu trip    85 °C
release     8 °C below trip
min hold    30 s
boost       100 %
guard       on

cryoctl doctor

Hardware/driver compatibility report: model, driver, fans, profile choices, power supply, turbo and cap controls, lighting controller and per-key keyboard, NVML, the daemon's probed capabilities, ending with a SUPPORTED / PARTIAL / LIMITED / UNSUPPORTED verdict and its reasons. Works without root and without the daemon; formatted for pasting into a GitHub model report; exits 2 when unsupported

No command-specific options.

Examples

cryoctl doctor
$ cryoctl doctor
cryo                   0.6.0
model                  Alienware Alienware m18 R2
profile choices        cool quiet balanced balanced-performance performance custom
cpu cap control        /sys/devices/system/cpu/intel_pstate/max_perf_pct
known AW-ELC           True
per-key keyboard (0d62) /dev/hidraw3 (64-byte report)
nvml                   NVIDIA GeForce RTX 4080 Laptop GPU

verdict                SUPPORTED - everything Cryo does is available here