CLI

Your stats,
in the terminal.

Pull your rounds, stats, and strokes gained data from any terminal. Pipe it into a spreadsheet, feed it to an AI, or just read it over coffee.

Install

Homebrew macOS / Linux

brew install --cask undeadC0rp/tap/yips

Go install any platform

go install github.com/undeadC0rp/theyips-cli/cmd/yips@latest

Getting started

Authenticate with your Google account. This opens a browser for OAuth — credentials are stored at ~/.config/yips/credentials.json and refreshed automatically.

yips login

Commands

yips rounds List all your rounds

ID        DATE        COURSE            HOLES  SCORE  +/-
a1b2c3d4  2024-11-03  Pine Valley GC    18     82     +10
b5c6d7e8  2024-10-20  Cypress Creek CC  18     79     +7

yips round <id> Hole-by-hole scorecard with strokes gained

Use the short ID prefix shown in yips rounds. Add --profile hcp_10 to compare against a different benchmark.

Pine Valley GC  ·  2024-11-03  ·  18 holes
Rating: 74.5  ·  Slope: 142  ·  Par: 72
SG benchmark: tour_pro (putting: scratch)

HOLE  PAR  SCORE  +/-   PUTTS  FIR  GIR  SG:TEE  SG:APP  SG:ARG  SG:PUTT
1     4    5      +1    2      Y    N    -       -       -       -0.78
2     3    4      +1    2      -    N    -       -       -       -0.42
4     4    4      E     1      Y    N    -0.21   -1.00   +0.18   +0.02
5     4    3      -1    1      Y    Y    -0.06   +0.95   -       +0.00
───   ───  ─────  ────  ─────  ───  ───  ──────  ──────  ──────  ───────
TOT   72   82     +10   34     9/14 10/18 +1.20  -3.41   +0.18   -1.18

yips hole <id> <hole> Shot-by-shot chart for a single hole

Requires shot data recorded in the mobile app. Each bar shows where the shot started relative to the hole length.

Hole 5  Par 4  350yds  Score: 3 (-1)

         0                        175                  350yds
         ────────────────────────────────────────────────────
TEE    1 █████████████████████████████░░░░░░░░░░░░░░░░░░░░░  200yds   FWY
APP    2 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░███████████████████████  155yds   FWY
PUTT   3 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░●  Gimmie

yips stats Aggregate stats across all rounds

12 rounds  ·  Last played 2024-11-03

METRIC           VALUE
Scoring average  84.2
Average +/-      +12.2
Putts / round    33.1
Fairways hit     58%
GIR              38%
Up & down        32%

PAR  HOLES  AVG SCORE
3    72     3.42
4    216    4.61
5    72     5.38

yips stats <id> Full breakdown for a single round

Pine Valley GC  ·  2024-11-03
SG benchmark: tour_pro (putting: scratch)

METRIC                VALUE
Score                 82 (+10)
Putts                 34
Fairways hit          9/14 (64%)
GIR                   10/18 (56%)
Up & down             4/8 (50%)
SG: Off-the-Tee       +1.20 (10 holes)
SG: Approach          -3.41 (12 holes)
SG: Around-the-Green  +0.18 (3 holes)
SG: Putting           -1.18 (16 holes)

SCORING  COUNT
Birdie   2
Par      8
Bogey    6
Double   2

yips clubs Distance and strokes gained per club

SG per club is aggregated from shot-level data. Add --json to emit raw data for further analysis.

CLUB               BRAND    SHOTS  AVG  MIN  MAX  SG TOTAL  SG/SHOT
Driver KING LTDx   Cobra      20   264  198  328    +7.47    +0.498
7 Wood             Cobra      10   178   40  234    +1.15    +0.128
7i                 Takomo      5   158  140  171    -0.65    -0.325
Putter             L.A.B.      0     -    -    -   -14.29    -0.265

yips holes <course> Per-hole breakdown across all rounds at a course

Accepts a partial, case-insensitive course name. Holes are flagged (*) when you're averaging +1.0 or worse and GIR is below 30% across 3+ rounds.

Course: Riverbend GC  ·  3 rounds

HOLE  PAR  RNDS  AVG +/-  FIR%  GIR%  TEE CLUB  ⚠
1     4    3     +0.7     67%   44%   Driver
7     4    3     +1.3     33%    0%   Driver     *

* Club selection review:
  Hole 7 (par 4) — Driver 3× (avg +1.3) — consider a shorter club off the tee

yips notes All notes across every round

Filter by course with --course <name>. Add --json to get raw output.

yips notes --course "Pine Valley"

Flags & options

Flag	Commands	Description
`--profile <slug>`	`round`, `stats`, `clubs`	SG benchmark profile. Valid slugs: `tour_pro`, `scratch`, `hcp_5`, `hcp_10`, `hcp_15`, `hcp_20`, `hcp_25`. Default: `tour_pro`.
`--estimate`	`round`, `stats`	Fill GPS-missing distances from hole yardage and club averages so partial holes still show a split. Estimated cells are marked with `~`.
`--json`	`notes`, `clubs`, `holes`	Emit raw JSON for piping into other tools.
`--course <name>`	`notes`	Filter by partial, case-insensitive course name.

Environment variables

Variable	Default	Description
`YIPS_TOKEN`	—	Google ID token; bypasses stored credentials.
`YIPS_API_URL`	`https://api.theyips.app`	Override the API base URL.

Pipe it anywhere

Every command that accepts --json outputs clean JSON you can pipe into anything — a spreadsheet, a script, or an AI.

yips holes 'Riverbend' --json | claude "where is my club selection hurting me most?"

yips clubs --json > clubs.json

yips rounds | grep "Pine Valley"

Your stats,in the terminal.