Install the CLI

Log weigh-ins, meals, and measurements from your terminal with @skeptrune/skcal.

@skeptrune/skcal is a terminal client for skcal. It logs weigh-ins, meals, and measurements and prints your daily snapshot. It’s handy for scripting and wiring into your own tooling.

Install

npm install -g @skeptrune/skcal

npx @skeptrune/skcal <command>

Prefer no Node? Grab a standalone binary for your platform from the latest release.

Sign in

skcal login

This opens your browser to sign in with your phone number and caches the token locally.

Authenticate with an API key

For scripts and CI, use a bearer API key instead of the browser flow:

skcal login --api-key skcal_your_key_here      # caches the key, or
export SKCAL_API_KEY=skcal_your_key_here        # use the env var (no login)

Create and scope keys in the app under profile → API keys.

Usage

skcal whoami                     # signed-in account + token expiry
skcal status                     # today: weight, S:W ratio, calories/protein

skcal weight log 158.2           # log a weigh-in in pounds
skcal weight log 72 --kg --bf 17 --note "morning, fasted"
skcal weight list -n 10          # recent weigh-ins
skcal weight note 42 re-weighed  # set/clear a note on reading #42

skcal meal describe "chicken breast + toum, skipped the salad"  # AI macros
skcal meal list                  # meals logged today (--date YYYY-MM-DD)

skcal measure waist 32.5         # inches (--cm for centimetres)
skcal targets                    # your goals

skcal logout

Next steps