tenk-connect

Connect your TenK account to your AI assistant. Log practice sessions, check progress, and manage your 10,000-hour journey from chat.

Manage your TenK account (tenk.oventlabs.com) from your AI assistant. Log sessions, view skill progress, check stats, and track your path to 10,000 hours.

Setup

On first use, run:

bash <SKILL_DIR>/scripts/tenk.sh auth

Opens a browser URL. User logs in with TenK credentials. CLI polls until approved. Token saved to ~/.config/tenk-connect/token (chmod 600).

Commands

• tenk.sh auth Authenticate via OAuth Device Flow
• tenk.sh whoami Show logged-in user
• tenk.sh skills List all skills with accumulated hours
• tenk.sh stats Total hours and % progress toward 10,000h
• tenk.sh log <skill> <minutes> [note] Log a practice session
• tenk.sh streak Last activity per skill
• tenk.sh logout Clear saved token

Usage

Use <SKILL_DIR>/scripts/tenk.sh <command> for all operations.

Auth check

Before any command, verify authentication:

bash <SKILL_DIR>/scripts/tenk.sh whoami

If it fails, run auth first and show the user the link and code.

Logging sessions

When the user says something like "log 45 minutes of guitar":

1. Run tenk.sh skills to find the matching skill (fuzzy match on name)
2. Run tenk.sh log <partial_name> <minutes> [optional note]
3. Confirm with the returned result

Showing progress

When asked about progress, hours, or stats:

• Run tenk.sh stats for totals
• Run tenk.sh skills for per-skill breakdown

Notes

• Tokens are valid for 7 days. Re-run auth if expired.
• Skill matching is case-insensitive and fuzzy on skill name.
• Authorize URL: https://tenk.oventlabs.com/#/authorize/<code>
• API base: https://tenk.oventlabs.com/api
• Requires: curl and python3 (standard on macOS/Linux)