Kahunas CLI

Fetch workouts from Kahunas and preview them locally.

Quick start

1. Install and build:

pnpm install
pnpm build

2. Optional: add auto-login credentials at ~/.config/kahunas/auth.json:

{
  "email": "[email protected]",
  "password": "your-password"
}

3. Sync workouts, then run the preview server:

pnpm kahunas sync
pnpm serve

Open http://127.0.0.1:3000.

If auth.json is missing, sync will prompt for credentials and save them after a successful login. After syncing, the CLI prints the cache JSON written to ~/.config/kahunas/workouts.json, including calendar events with per-exercise date labels. Raw Kahunas payloads are cached under ~/.config/kahunas/cache for offline preview. The preview UI is served by a local Vite dev server using Solid, so it requires JavaScript in the browser.

Testing

Run the test suite:

pnpm test

Generate coverage reports (CI enforces coverage thresholds):

pnpm test:coverage

Advanced usage

See docs/advanced.md for all commands, flags, and configuration options.