Calorie Tracker
Log and track daily calorie intake, macronutrients, body weight, and waist measurements locally in a SQLite database. Provides granular statistics, weekly averages, and future calorie budgets.
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.4.4
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.4.4release · observed Aug 16, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s178t29f61bmma8whfnmacavhx83eknq:caloric-intake-tracker- Install using `clawhub skill install s178t29f61bmma8whfnmacavhx83eknq:caloric-intake-tracker` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/patello/caloric-intake-tracker before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-patello-caloric-intake-tracker/snapshot"
Documentation
CLAWHUB
123,505 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: caloric-intake-tracker
description: Log and track daily calorie intake, macronutrients, body weight, and waist measurements locally in a SQLite database. Provides granular statistics, weekly averages, and future calorie budgets.
metadata: {"openclaw": {"requires": {"bins": ["python3"]}}}
---
# Local Calorie Tracker Skill
Track daily calorie intake, macronutrients, body weight, and waist measurements locally using a SQLite database.
## Installation & Setup
This is a standalone, skill-first OpenClaw skill. It runs out-of-the-box using standard Python libraries.
The default SQLite database file is named `health_data.db` and is resolved relative to the current working directory (Cwd) of the running agent. To override the database path, pass the `--database PATH` option to any command.
## Operational Instructions for the Agent
1. **No Compensatory Entries:** If a food entry was logged incorrectly (e.g. wrong calorie or protein count), do not log a new positive or negative "balancing" or "corrective" entry. Instead, identify the incorrect entry's ID using the `list` or `stats day` command, and run the `update` or `delete` command to fix it.
2. **No Bogus Logs:** Every logged entry's description must contain only the actual name of the food or drink consumed. Do not store summaries, calorie calculations, or meta-data in the food description (e.g., do not name an entry "1875 kcal, 72g protein" to force-balance a day).
3. **Standardized Meal Types:** Every logged food entry must have a valid `--meal` type. Allowed types are: `breakfast`, `lunch`, `dinner`, `snack`, `fika`, `drink`, `dessert`, `evening`, and `other`. Valid meal types are loaded and validated dynamically from the database.
## Day Completeness Quality Levels
When marking a day as complete using the `complete` command, use one of the following completeness quality levels:
* `full`: Default. All meals and drinks consumed for the target day were fully tracked.
* `partial`: Some meals are missing, or the day relies heavily on rough estimates.
* `minimal`: Only sporadic entries were logged; most of the day's intake is unknown.
## Interpreting Weekly Averages & Budgets
When reviewing weekly averages using the `stats week` command, averages and budgets are tailored dynamically to today's completion status by default (`--include-today auto`):
* **If Today is Incomplete:** The command excludes today's data from the active average display, showing the **Monday-to-Yesterday Average** and the **Daily Budget Starting Today** (including a dynamic helper showing remaining calories for today).
* **If Today is Complete:** The command includes today's data, showing the **Monday-to-Today Average** and the **Daily Budget Starting Tomorrow**.
* **Customizing Scope:** You can use the `--include-today` flag to force a specific behavior:
- `--include-today yes`: Forces inclusion of today (shows Mon-Today average and Starting Tomorrow budget).
- `--include-today no`: ForceREADME.md
# Calorie Tracker OpenClaw Skill
A skill-first OpenClaw skill to track daily calorie intake, macronutrients, body weight, and waist measurements locally in a SQLite database.
## Features
- **No Packaging Overheads:** Zero setup or pip installs required. Runs immediately using Python's standard libraries.
- **Dynamic Meal Types:** Allowed meal types are configured and validated directly in the SQLite database.
- **Granular Analytics:** Subcommands for daily, weekly, trend-based, and body measurement reports.
- **Intelligent Budgets:** Computes future daily budgets and historical averages (excluding incomplete days) to aid health coaching and planning.
## CLI Usage
The core script is located at `scripts/tracker.py`.
### Global Options
The script supports two global options that must be placed *before* the subcommand:
- `--database PATH`: Specifying a path to the database (defaults to `health_data.db` in current directory).
- `--today YYYY-MM-DD`: Time-travel option to simulate the system date for all operations (logs, lists, budgets, averages).
### Core Commands
- **Config Goal:** `python scripts/tracker.py goal CALORIES [PROTEIN]`
- **Log Food:** `python scripts/tracker.py add "description" CALORIES [protein] [carbs] [fat] --meal TYPE`
- **List Food:** `python scripts/tracker.py list [DATE] [--no-group]` (groups by meal type by default)
- **Update Entry:** `python scripts/tracker.py update ID [--name NAME] [--cal CALORIES] ...`
- **Delete Entry:** `python scripts/tracker.py delete ID`
- **Mark Complete:** `python scripts/tracker.py complete DATE [--completeness QUALITY]`
- **Check Complete:** `python scripts/tracker.py check-complete [DATE]`
- **Log Weight/Waist/Measurement:** `python scripts/tracker.py weight KG` / `python scripts/tracker.py waist CM` / `python scripts/tracker.py measure TYPE VALUE`
*(Weight and waist are first-class measurement types; the `weight` and `waist` shortcuts delegate to `measure`. `weight` is the canonical type for body weight and powers BMI.)*
*(Note: Default types `waist`, `hips`, and `neck` are pre-seeded automatically. The key `waist` is specifically used to compute Waist-to-Height Ratio (WHtR) and power the legacy shortcut.)*
### Reports & Statistics
- **Daily Stats:** `python scripts/tracker.py stats day [DATE] [--no-group]` (groups by meal type by default)
- **Weekly Stats:** `python scripts/tracker.py stats week [DATE] [--weeks N] [--compact] [--include-today {auto,yes,no,both}]`
- **Rolling Trends:** `python scripts/tracker.py stats trend [--days N]`
- **Weight History:** `python scripts/tracker.py stats weight [-N ENTRIES] [--days DAYS]` (defaults to `-N 5`)
- **Waist/Measurement History:** `python scripts/tracker.py stats waist` / `python scripts/tracker.py stats measure TYPE [-N ENTRIES] [--days DAYS]`
For detailed operational rules and specifications, see [SKILL.md](SKILL.md)._meta.json
{
"ownerId": "kn7cxaw1m27d1fe93wbz40vqkd8309h7",
"slug": "caloric-intake-tracker",
"version": "1.4.4",
"publishedAt": 1786885513433
}skill-card.md
## Description: Log and track daily calorie intake, macronutrients, body weight, and waist measurements locally in a SQLite database, with daily and weekly statistics, rolling averages, and future calorie budgets. This skill is ready for commercial/non-commercial use. ## Publisher: [patello](https://clawhub.ai/user/patello) ### License/Terms of Use: MIT-0 ## Use Case: External users and agents use this skill to record food intake, body measurements, goals, and completion status in a local tracker. It supports health coaching and personal tracking workflows by producing local CLI commands and readable reports for daily, weekly, trend, weight, waist, and custom measurement views. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill stores food, weight, waist, and related notes in a local SQLite database that may contain sensitive health data. Mitigation: Choose a private database location with --database, track where health_data.db is created, and manage file permissions and backups accordingly. Risk: Generated log commands can include stored food names from the local database, which may be unsafe to copy if existing database content is untrusted or unusual. Mitigation: Review generated Log command output before pasting or running it. ## Reference(s): - [ClawHub Skill Page](https://clawhub.ai/patello/skills/caloric-intake-tracker) - [Publisher Profile](https://clawhub.ai/user/patello) - [Skill Documentation](artifact/SKILL.md) - [README](artifact/README.md) ## Skill Output: **Output Type(s):** [text, shell commands, guidance] **Output Format:** [Markdown with inline shell commands] **Output Parameters:** [1D] **Other Properties Related to Output:** [Outputs are intended for a local Python CLI and local SQLite database; no external service output is produced.] ## Skill Version(s): 1.4.4 (source: server release evidence and artifact metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
changelog.txt
- Merge pull request #2 from patello/migrate-weight-to-measure - Migrate body weight to measurement system, single source of truth
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/patello/skills/caloric-intake-tracker",
"sourceUrl": "https://clawhub.ai/patello/skills/caloric-intake-tracker",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T11:52:42.317Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-patello-caloric-intake-tracker/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-patello-caloric-intake-tracker/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T11:52:42.317Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/patello/caloric-intake-tracker",
"sourceUrl": "https://clawhub.ai/patello/caloric-intake-tracker",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T11:52:42.317Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.4.4",
"href": "https://clawhub.ai/patello/caloric-intake-tracker",
"sourceUrl": "https://clawhub.ai/patello/caloric-intake-tracker",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-16T13:05:13.433Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-patello-caloric-intake-tracker/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-patello-caloric-intake-tracker/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.4.4",
"description": "- Merge pull request #2 from patello/migrate-weight-to-measure - Migrate body weight to measurement system, single source of truth",
"href": "https://clawhub.ai/patello/caloric-intake-tracker",
"sourceUrl": "https://clawhub.ai/patello/caloric-intake-tracker",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-16T13:05:13.433Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
