calorie-counter

Calorie Counter

Simple, reliable calorie and protein tracking with SQLite database.

Features

• Manual Entry: Add food with calories and protein
• Protein Tracking: Monitor daily protein intake
• Daily Goals: Set custom calorie targets
• Weight Tracking: Log weight in pounds
• Instant Feedback: See totals immediately after adding food
• History: View past days and trends

Usage

Adding Food

python scripts/calorie_tracker.py add "chicken breast" 165 31
python scripts/calorie_tracker.py add "banana" 100 1

Shows immediate feedback with today's totals and remaining calories.

Viewing Today's Summary

python scripts/calorie_tracker.py summary

Shows:

• All entries for today
• Total calories and protein consumed
• Daily goal and remaining calories
• Progress percentage

Setting Goals

python scripts/calorie_tracker.py goal 2000

Sets the daily calorie goal (persists).

Weight Tracking

python scripts/calorie_tracker.py weight 175
python scripts/calorie_tracker.py weight-history

Weight is in pounds (decimals allowed: 175.5).

Viewing History

# Last 7 days
python scripts/calorie_tracker.py history

# Last 30 days
python scripts/calorie_tracker.py history 30

Deleting Entries

# List entries to get ID
python scripts/calorie_tracker.py list

# Delete by ID
python scripts/calorie_tracker.py delete 42

Database

SQLite database: calorie_data.db

Tables

entries - Food log

• id (INTEGER) - Auto-increment
• date (TEXT) - YYYY-MM-DD
• food_name (TEXT)
• calories (INTEGER)
• protein (INTEGER)
• created_at (TIMESTAMP) - Automatic

daily_goal - Single calorie target

• id (INTEGER) - Always 1
• calorie_goal (INTEGER)

weight_log - Weight tracking

• id (INTEGER) - Auto-increment
• date (TEXT) - YYYY-MM-DD
• weight_lbs (REAL) - Pounds with decimals
• created_at (TIMESTAMP) - Automatic

Agent Instructions

Important: The skill is located at workspace/calorie-counter/ in your agent's workspace. All commands should use this path prefix.

When user mentions food:

1. Extract food name, calories, and protein (estimate if not provided)
2. Run: python3 workspace/calorie-counter/scripts/calorie_tracker.py add "food" CALORIES PROTEIN
3. The command outputs immediate totals (no need to run summary separately)

Example:

• User: "I had a chicken breast for lunch, about 165 calories"
• Estimate protein (chicken is ~30g per 165 cal)
• Run: python3 workspace/calorie-counter/scripts/calorie_tracker.py add "chicken breast" 165 30

When user wants remaining calories:

1. Run: python3 workspace/calorie-counter/scripts/calorie_tracker.py summary

When user sets a goal:

1. Run: python3 workspace/calorie-counter/scripts/calorie_tracker.py goal CALORIES

When user logs weight:

1. Convert to pounds if needed (1 kg ≈ 2.205 lbs)
2. Run: python3 workspace/calorie-counter/scripts/calorie_tracker.py weight POUNDS

When user wants to delete entry:

1. Run: python3 workspace/calorie-counter/scripts/calorie_tracker.py list to show IDs
2. Run: python3 workspace/calorie-counter/scripts/calorie_tracker.py delete ID

Protein Estimation Guide

If user doesn't specify protein, estimate based on food type:

• Lean meats (chicken, turkey): ~0.30g per calorie
• Fish: ~0.25g per calorie
• Red meat: ~0.20g per calorie
• Eggs: ~0.12g per calorie (1 egg = 70 cal, 6g protein)
• Greek yogurt: ~0.10g per calorie
• Nuts: ~0.04g per calorie
• Bread/pasta: ~0.03g per calorie
• Fruits: ~0.01g per calorie or less
• Vegetables: ~0.02-0.04g per calorie

When uncertain, estimate conservatively or ask the user.

Notes

• Calories and protein are integers (no decimals)
• Weight is in pounds (decimals allowed)
• Database created automatically on first use
• All times in local timezone
• Dates in YYYY-MM-DD format
• Time shown in lists is from created_at timestamp (HH:MM format)

Example Session

# Set goal
$ python scripts/calorie_tracker.py goal 2000
✓ Set daily goal: 2000 cal

# Add breakfast
$ python scripts/calorie_tracker.py add "oatmeal" 150 5
✓ Added: oatmeal (150 cal, 5g protein)
  Entry ID: 1
  Today: 150 / 2000 cal (remaining: 1850) | Protein today: 5g | Entries: 1

# Add lunch
$ python scripts/calorie_tracker.py add "grilled chicken salad" 350 45
✓ Added: grilled chicken salad (350 cal, 45g protein)
  Entry ID: 2
  Today: 500 / 2000 cal (remaining: 1500) | Protein today: 50g | Entries: 2

# Check summary
$ python scripts/calorie_tracker.py summary
============================================================
DAILY SUMMARY - 2026-02-05
============================================================
Entries: 2
Total consumed: 500 cal | 50g protein
Daily goal: 2000 cal
Remaining: 1500 cal
  25.0% of goal consumed
============================================================

# Log weight
$ python scripts/calorie_tracker.py weight 175.5
✓ Logged weight: 175.5 lbs