Account, email and CLI login

Create your account

KubeFit is publicly available, closed-source and free to use. The source repository is private. Create a free account ↗ with your email and a password of at least 12 characters, then follow the confirmation link in your inbox. Check your spam folder if it hasn’t arrived. No invite is required. The same account signs in on the site and approves the CLI.

The getting-started walkthrough

The first time you sign in, the app opens a three-step walkthrough instead of the page you asked for. A CLI approval link is the exception and goes straight through.

1. Your goal. Pick a track and, if you have one, an exam date. The date is saved to your Profile in your device's time zone. OPS takes no date.
2. Your terminal. Install commands for macOS or Linux, then kubefit doctor and kubefit login. Check my connection confirms that a CLI token exists for your account; it does not test your machine.
3. Your first rep. The first drill for your track and kubefit grade.

It covers the same ground as the Quickstart. Reopen it at any time from Profile, under "Revisit the getting-started walkthrough".

Email did not arrive

Confirmation and account mail is sent from the kubefit.com domain. If nothing shows up within a few minutes:

1. Check spam, junk and any quarantine. Work and university mailboxes often hold mail from new senders. Search for kubefit, then mark the message as not spam so later mail lands.
2. Check the address. A typo at signup sends the link somewhere else. Registering again with the correct address is fine.
3. Request a fresh link. Open Create a free account ↗ and register again with the same email. While the address is unconfirmed, that sends a new confirmation link. Wait a few minutes between tries: repeated requests are rate limited, and the page says Too many attempts when you hit the limit.
4. Already confirmed? A reused or expired link shows That confirmation link is no longer valid. Try signing in with your password first; most of the time the account is already active.
5. Still stuck? Write to hello@kubefit.com from the address you registered with and say roughly when you signed up. Never send your password.

You do not need the confirmation to install the CLI or run kubefit doctor. You do need it before kubefit login can be approved.

Forgotten password or a leaked token

Use Forgot password ↗ to request a reset link and open it in the same browser. Choose a password of at least 12 characters. If the link has expired, request a fresh one.

If your CLI token or ~/.kubefit/config.json has leaked, open Account security ↗ from your profile and choose Revoke all CLI sign-ins. This invalidates server-side CLI tokens and pending approvals for your account. Reconnect trusted machines with kubefit login. Your reps and reports remain. Already running local drills and downloaded packs are not removed.

kubefit logout only removes the local token; changing your password does not revoke CLI tokens. Use Account security for revocation. If account recovery still fails, contact hello@kubefit.com.

Your profile and exam dates

Open Profile in the app to set your preferred name, training time zone and a date for each certification. Use a booked exam date or your own target. Dates are private to your account; you can change or clear them at any time. OPS is a workshop and has no exam date.

Coach Caz suggests the track with your nearest upcoming exam when you open My practice. An explicit track selection still wins. With no upcoming date, Caz falls back to the track of your most recent rep, then CKA. In the last 30 days, new workouts give extra priority to every drill whose latest attempt was not a cold pass at or under 1.2 times the target: untried, failed, assisted, paused, passed after more than one grade, or slow. This focus increases in the final seven days. Past dates are ignored until you update them; reaching a date does not record an exam result.

Changes apply to new workouts. An active workout keeps its saved plan and original countdown. This date guidance is on the site; the CLI’s kubefit next and reports retain their existing scheduler rules. A countdown is a planning aid, not an exam-readiness score.

CLI sign-in

kubefit login starts a browser approval:

1. The CLI asks the site for a ten-character code and prints a link.
2. You open the link, sign in if needed, confirm the code matches, and approve.
3. The CLI collects a token and stores it in ~/.kubefit.

Codes expire after ten minutes and work once. Tokens are long-lived; kubefit logout forgets the local copy. The site stores only a hash of each token.

When login does not complete

• The code expired. Run kubefit login again for a new one. An old link cannot be reused.
• The code on the page does not match your terminal. Do not approve it. Close the page and start kubefit login again.
• The browser asks you to sign in and the password fails. That is the account, not the CLI: confirm your email first (above), and use the password you registered with.
• No browser on this machine. Open the printed link on any device where you can sign in; the terminal that printed the code collects the token.
• Commands say you are not signed in. The token is missing or was removed with kubefit logout. Run kubefit login.

What syncs

• Reps upload after every recorded drill, and on kubefit sync. Mock exams create no reps.
• Mock exam records upload when an exam ends, and on kubefit sync, which also pulls the records from your other machines.
• Notes upload the same way, and kubefit sync also pulls notes written on the site so kubefit notes shows both.
• Packs download on kubefit packs, and every drill or mock exam refreshes the track's pack first when the site has a newer version.

Uploads are idempotent: a rep or note is identified by a client id, so retrying never duplicates it.

Quotas

The API applies per-account daily limits that are generous for one person training. Each has its own count, resets the next day, and answers with a 429 whose message says which limit it was.

One upload request carries up to 500 reps, 200 notes or 50 mock exam records, and up to 512 KiB. A note holds up to 10,000 characters, and a notebook name is 1 to 40 characters starting with a letter or digit. Reports and Notebooks read your latest 2,000 reps and notes and your latest 200 mock exam records.

Local files

The token, cached packs, reps and notes live under ~/.kubefit. Local files and environment lists every path and what kubefit end removes.

Contact

hello@kubefit.com reaches the person who builds KubeFit. Use it for account problems, mail that never arrives, or a grader you believe is wrong. Include your CLI version (kubefit version) and the exercise id where it applies.