sparky

What This Skill Does

Sparky is a comprehensive command-line interface for the SparkyFitness server, enabling users to maintain a detailed health journal directly from their terminal or via an AI agent. It handles food nutrition logging, exercise performance tracking, and daily biometric check-ins (weight, steps, mood). By leveraging both local database caches and open-source APIs like Open Food Facts, Sparky ensures that health data is accurate, searchable, and easily summarized over time.

Installation

To get started, you must have Go 1.21 or higher installed. For macOS or Linux users, the recommended method is using Homebrew: brew tap aronjanosch/tap && brew install sparky-cli. Alternatively, you can build from source by cloning the repository from https://github.com/aronjanosch/sparky-cli, running go build -o sparky ., and moving the binary to your path. Once installed, configure the server URL and API key using sparky config set-url and sparky config set-key, then verify the connection with sparky ping.

Use Cases

This skill is perfect for users who prioritize privacy and self-hosting for their health data. It is ideal for those who track macros, log progressive overload in gym routines, or want a quick way to record daily mood and steps without opening heavy GUI applications. The ability to search by barcode makes grocery tracking exceptionally fast, while the exercise logging supports detailed metrics like sets, reps, weight, and RPE, making it a powerful tool for dedicated fitness enthusiasts.

Example Prompts

1. "Sparky, please log 200 grams of chicken breast for my lunch today and show me my nutritional summary for the last week."
2. "I did 4 sets of 10 bench presses at 80kg with an RPE of 8 today, can you record that in my exercise diary?"
3. "Hey, log a weight check-in for today at 75.5kg and tell me my average mood score over the last 30 days."

Tips & Limitations

Always prefer using the --id flag when logging food or exercises to eliminate ambiguity that can arise from name-based searches. If you encounter an item not in your local library, you may need to search and log it once to import it into your local cache. Note that the tool requires an active internet connection to communicate with your self-hosted SparkyFitness server and to fetch metadata from external APIs. Be mindful that data is only as accurate as the input provided; use consistent units to ensure your long-term trends remain statistically valid.