ITENPLUK
Reference

Useful commands

A terminal cheat-sheet to diagnose and tune SkillFishOS.

SkillFishOS is designed not to require the terminal: the Tuner and the graphical apps are enough for normal use. This page is for those who want to tinker or diagnose. Privileged commands use sudo.

Before risky experiments, remember the safety net: Btrfs snapshots and rollback from the GRUB menu (see Storage & snapshots).

System and kernel

uname -r                      # running kernel (should end with -skillfishos)
cat /proc/cmdline             # active boot parameters
journalctl -b -p err          # errors from the current boot
inxi -Fxxxz                   # full hardware summary

GPU, clocks and temperatures

# GPU temperature from amdgpu sysfs
cat /sys/class/drm/card*/device/hwmon/hwmon*/temp1_input   # °C ×1000
# SMU GPU governor status
systemctl status cyan-skillfish-governor
cat /etc/cyan-skillfish-governor/config.toml               # freq/volt safe-points
# real-time GPU monitoring
nvtop        # or: radeontop

On the BC-250 frequency control does not go through standard amdgpu sysfs but through the SMU governor. Change the values from the Tuner, not by hand.

CPU — overclock/undervolt

systemctl status bc250-smu-oc.service   # "inactive" after applying is normal (one-shot)
cat /etc/bc250-smu-oc.conf              # applied clock/voltage
lscpu | grep MHz                        # current core frequencies
sensors                                 # temperatures/voltages (nct6686, k10temp)

Live Compute Units (skillfish-cu)

skillfish-cu get          # JSON state: active CUs + per-row (SE/SH) mask
sudo skillfish-cu max     # route all CUs (40)
sudo skillfish-cu stock   # back to 24 (driver baseline)
sudo skillfish-cu set 0x1f   # WGP mask for all rows (0x07=24 .. 0x1f=40)
cat /run/skillfish/cu_active # "40/40" (also read by the HUD)
vulkaninfo | grep -i "deviceName\|driverName"   # GPU as seen by Vulkan (RADV)

CUs are best managed from the Tuner grid (click + presets, with “CU test”). The first 24 are driver-locked and always on.

Quick benchmarks (the same ones the Tuner uses):

vkpeak                # FP32 throughput (GFLOPS)
clpeak                # memory bandwidth (GB/s)
sysbench cpu run      # CPU stress/benchmark

Unified memory (VRAM/GTT)

cat /proc/cmdline | tr ' ' '\n' | grep -E 'gttsize|ttm'   # GTT/TTM params
glxinfo | grep -i "memory"                                 # memory seen by the driver
free -h                                                     # shared RAM/GDDR6

Gaming

flatpak list                         # Flatpak apps (Steam, EmuDeck emulators…)
flatpak update                        # update Flatpak apps
gamescope -- %command%               # (set this in Steam launch options)
# Bluetooth controllers
bluetoothctl                         # scan on / pair / connect / trust

Local AI

# a single native service — no containers: Docker is not installed
systemctl status skillfish-unsloth   # AI engine status
sudo systemctl start skillfish-unsloth   # start it
sudo systemctl stop skillfish-unsloth    # stop it and free GPU/RAM
curl -s localhost:8888/              # the Unsloth Studio UI (loopback only)

Snapshots and rollback (Btrfs)

sudo snapper list                    # list snapshots
sudo snapper create -d "before X"    # manual snapshot
sudo btrfs subvolume list /          # subvolumes (@, @home, @log, @cache)

# go back to a snapshot, for real (takes effect at the next reboot)
sudo skillfish-rollback --list       # which snapshots are available
sudo skillfish-rollback 12           # make snapshot 12 the running system
sudo skillfish-rollback --undo       # changed your mind: put the old one back
sudo skillfish-rollback --clean      # drop the systems set aside by past rollbacks

# from the GRUB menu → "SkillFishOS snapshots" you get the same snapshot
# READ-ONLY: good to look around and rescue files, then run the command above

Updates and repository

sudo apt update && sudo apt full-upgrade   # update the system
apt-mark showhold                          # held packages (incl. the kernel)
sudo apt install skillfishos-kernel        # install/update the kernel from the repo
apt policy <package>                        # which repo/version a package comes from

Network and remote access

nmcli device status                  # network interface status
ip a                                 # IP addresses
systemctl status x11vnc              # VNC server for the remote desktop
hostname -I                          # IP to use with the VNC client

Display (DisplayPort HPD)

systemctl status skillfish-dp-hotswap   # daemon that works around the broken HPD
xrandr                                   # outputs and resolutions (X11 session)

Sources