JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV DEC
Cadence
Cadence CLI · Agents welcome

Run your 12 weeks from the terminal.
Or let your agent do it.

The Cadence CLI checks in, scores the week, runs the weekly review, and plans the next cycle. Use it yourself, or hand it to Claude Code, Codex, or any agent that can run a command — it installs its own skill.

$ curl -fsSL https://cadenceweek.com/install-cli | bash
On Homebrew? brew install rizwanreza/tap/cadence
macOS & Linux · Open source, MIT · Works with your Cadence account
~ — cadence status
$ cadence status

Today is Thursday, Oct 1 2026 (America/Chicago)
Cycle: Spring build — week 4 of 12 (2026-09-07 to 2026-11-29)

Check-ins: 1 / 4 done
  ✓ Lift 3x/week
  ✗ 160g protein  112 / 160 g
  ✗ Deep work block  1 / 2 sessions
  ✗ Write 500 words

Last week's commitment: Pack protein before any trip.

Up next
  • 1 of 4 goals checked in today.
    cadence today
01 / BRING YOUR AGENT

The whole cycle, in plain words.

Claude Code, Codex, Cursor — any agent that can run a shell command can run Cadence. cadence skill install teaches it the method: log the work, check the score, ask the review questions, and save the answers where you'll see them.

DAILYA MORNING CHECK-IN
claude — ~/
Just finished my lift and a deep work block. Log both — what's left today?
cadence complete --goal "Lift 3x/week"
Lift 3x/week: ✓ done for 2026-10-01.
cadence add --goal "Deep work block" --value 1
Added 1 (no entry → 1). Deep work block: 1 / 2 sessions — ✗ incomplete for 2026-10-01.
cadence today
1 / 4 goals completed
Both logged. Lift is done and deep work is at 1 of 2. Still open today: a second deep work block, 48g more protein, and 500 words. Writing has slipped the last two Thursdays, so I'd do it before lunch.
WEEKLYTHE SUNDAY REVIEW
claude — ~/
It's Sunday. Run my weekly review.
cadence score
Weekly execution: 84% (21 / 25 points)
Pace: 84%; tier: Strong
160g protein · 4 / 7 · 57.1%
Week 3 closed at 84%. Everything held except protein, which missed Thursday through Saturday. Four questions. What was your biggest win?
Four deep work blocks before noon. Best writing week so far.
What derailed you — the root cause, not the symptom?
The Denver trip. I didn't plan food, so protein fell apart.
One change for next week?
Pack protein before any trip.
And next week's constraint?
Two early flights on Tuesday.
cadence week review set --win "Four deep work blocks before noon" --derail "Denver trip, no food plan" --change "Pack protein before any trip" --constraint "Two early flights Tuesday"
Saved the review for the week of 2026-09-21.
Weekly review — week of 2026-09-21
Biggest win: Four deep work blocks before noon
Derail cause: Denver trip, no food plan
One change: Pack protein before any trip
Constraint: Two early flights Tuesday
Saved. Tuesday's flights mean no lift that day, so Monday and Wednesday carry it. Next week's review will show your change as last week's commitment.
END OF CYCLEPLAN THE NEXT 12 WEEKS
codex — ~/
My cycle ends Sunday. Close it out and set up the next 12 weeks. Keep everything except protein.
cadence cycles review set --what-drove-results "Deep work blocks before noon" --next-cycle-adjustment "Plan food before any travel"
Saved 2 reflection answer(s) for cycle 1.
cadence cycles next --start after --goals "Lift 3x/week,Deep work block,Write 500 words"
Next cycle drafted
Summer build [draft] — 2026-11-30 to 2027-02-21 (cycle 2)
1. Lift 3x/week — 1; 3 scored days/week (1 points/day)
2. Deep work block — 1 session; 10 points/week (1 points per 1 session)
3. Write 500 words — 1; 5 scored days/week (1 points/day)
Nothing is active yet. Review with `cadence cycles show --id 2`, …
Your review is saved. The next cycle is drafted to start Monday with Lift 3x/week, Deep work block, and Write 500 words — I left 160g protein out. Nothing is active yet: look it over, and say the word and I'll activate it.
02 / WHAT TO ASK

Prompts that follow the rhythm.

The 12 Week Year runs on three clocks: the day, the week, the cycle. Say it the way you'd say it to a person — the skill knows which command each one needs.

DAILY
Log the work

Seconds a day, without opening a tab.

  • “Log today's lift and 140g protein.”
  • “I did two deep work blocks this morning.”
  • “What's left for today?”
WEEKLY
Score and review

One honest look back, one change forward.

  • “Am I on pace this week?”
  • “Run my weekly review — ask me the four questions.”
  • “Which goal keeps slipping, and on which days?”
EVERY 12 WEEKS
Close and reset

Review the cycle, then plan the next one.

  • “Walk me through my cycle review.”
  • “Plan the next 12 weeks. Keep lifting and writing.”
  • “I fell off. Start me fresh from today.”
03 / FOR HUMANS, TOO

The scoreboard, in your terminal.

No agent required. The same numbers as the dashboard, one command away — and every command takes --json when you'd rather script it.

~ — cadence score
$ cadence score

Weekly execution: 84% (21 / 25 points)
Pace: 84%; tier: Strong
Cycle 1, 2026-09-21 to 2026-09-27; snapshot 2026-09-27

 Goal                 Points     Done      Pace
 Lift 3x/week         3 / 3      3 / 3     100%
 160g protein         4 / 7      4 / 7     57.1%
 Deep work block      10 / 10    10 / 10   100%
 Write 500 words      4 / 5      4 / 5     80%
~ — cadence history
$ cadence history --from 2026-09-21 \
    --to 2026-09-27 --goal protein

Entries 2026-09-21 to 2026-09-27
 Date        Goal           Value
 2026-09-21  160g protein   160 g
 2026-09-22  160g protein   165 g
 2026-09-23  160g protein   160 g
 2026-09-27  160g protein   170 g
~ — cadence insight
$ cadence insight

Coaching for the week of 2026-09-28

Assessment: 76% through Thursday, after weeks of 88%, 91% and 84%. Lift and deep work are on track; protein is the drag.

Guidance: Log protein at each meal today and put the writing block before lunch.

Risk: Protein missed Thursday through Saturday last week. Plan food before the trip, not at the gate.

Leverage: Writing before lunch has landed 4 of 4 times. Keep it there.

source: llm

cadence status
Where you stand: the cycle clock, this week's score, today's goals.
cadence complete · set · add
Check in. A checkbox, a total, or one more unit.
cadence today
What's done and what's still open today.
cadence score · history
This week's execution and pace, and every entry you've logged.
cadence week review set
Save the four weekly review answers.
cadence insight
Coaching from your numbers: one risk, one move.
cadence cycles next · fresh-start
Plan the next 12 weeks, or start over from today.
cadence doctor
Checks your install, token, and connection.
04 / QUICK START

Four steps. About a minute.

You'll need a Cadence account with a cycle to track. The CLI signs in with a personal token, not your password.

  1. 01 MACOS · LINUX
    Install the CLI

    Downloads the right build for your machine and checks it against the release checksums.

    $ curl -fsSL https://cadenceweek.com/install-cli | bash

    Or with Homebrew:

    $ brew install rizwanreza/tap/cadence
  2. 02 IN CADENCE
    Generate a token

    Open Settings → CLI Access and generate a token. Copy it; you'll paste it once.

  3. 03 TERMINAL
    Sign in

    Paste the token when asked, then run cadence status to see your week.

    $ cadence login
  4. 04 OPTIONAL
    Teach your agent

    Installs the Cadence skill for your coding agents. Then just ask: “Log today's workout.”

    $ cadence skill install

Something off? cadence doctor checks the install, your token, and the connection, and tells you what to fix.

05 / SECURITY & TRUST

Your data, your key.

An agent acting on your goals should be easy to trust and easy to stop. The token works only with the Cadence API, lives only where you put it, and you can take it back in one click.

Read the source on GitHub →
STAYS ON YOUR MACHINE

Your token is saved in a local config file only you can read (permissions 0600). Your password never touches the terminal.

REVOCABLE ANYTIME

Revoke or regenerate the token from Settings → CLI Access. The old one stops working immediately — for you and for any agent using it.

RATE-LIMITED

The API caps how fast any one token can call it, so a looping script or a runaway agent can't hammer your account.

OPEN SOURCE

The CLI and the agent skill are MIT-licensed. Read exactly what runs on your machine and what it sends.

Put the next 12 weeks where you work.

Start a cycle in Cadence, then check in from the terminal — or let your agent keep the score.

First 12 weeks free · $6/month after · CLI included
JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV DEC