🦀 ClawHub
Nexus — Workout & Nutrition Tracker
by @kiluazen
Log and track workouts, meals, weight, and fitness friends with OAuth-secured cloud storage and conversational queries in Nexus.
TERMINAL
clawhub install nexus-fitness📖 About This Skill
Nexus — Workout & Nutrition Tracker
Track workouts, meals, and weight from your terminal. Nexus is a CLI tool that stores fitness data in the cloud so you can log, query, and update your training and nutrition history.
Installation
uv tool install nexus-fitness
When to use this skill
Use Nexus when the user wants to:
Authentication
Before using Nexus, sign in with Google:
nexus auth login
Check auth status or sign out:
nexus auth status
nexus auth logout
Commands
nexus log
Log workouts, meals, or weight. Provide entries as JSON via file, inline, or stdin.
nexus log --file entries.json
nexus log --entries '[{"type":"workout","exercise":"bench_press","sets":[{"weight_kg":80,"reps":8}]}]'
cat entries.json | nexus log --stdin
nexus log --file workouts.json --date 2026-04-09
Entry types:
nexus history
Fetch past entries with optional filtering by date, type, or friend.
nexus history
nexus history --date 2026-04-09
nexus history --type workout
nexus history --from-date 2026-04-01 --to-date 2026-04-09 --type meal
nexus history --friend-id abc123 --type weight
Options:
--date: entries for a specific date--from-date / --to-date: date range query--type: filter by workout, meal, or weight--friend-id: view a friend's historynexus update
Modify an existing entry by its ID (get IDs from nexus history).
nexus update --entry-id 123 --file updated-entry.json
nexus update --entry-id 456 --data '{"exercise":"cycling","duration_min":45}'
nexus friends
Manage social fitness connections.
nexus friends list
nexus friends add --code NEXUS-A1B2
nexus friends accept --display-name "John Doe"
nexus friends reject --display-name "Jane Smith"
nexus friends remove --display-name "Old Friend"
Guidelines
bench_press, pull_ups)