Skill: food-journal CLI

This skill describes how an agent should use the food-journal CLI to record and query meals.

Quick Start

Assumes food-journal is installed and in PATH.

food-journal <command>

Logging meals

Add a meal entry with macros:

food-journal add "Greek Yogurt" 120 20 8 0 0 breakfast "Plain, 170g"

Optional images list (store as a single string; comma-separated works well):

food-journal add "Salad" 320 8 24 18 6 lunch "With vinaigrette" --images "salad.jpg,plate.png"

Edit an entry by id (use recent to find ids):

food-journal edit 12 "Updated Salad" 350 9 26 20 6 lunch "Extra dressing" --images "salad2.jpg"

Checking totals

Show everything for today:

food-journal today

Show totals so far today (current time cutoff):

food-journal today --so-far

Show totals for a specific date up to a time:

food-journal show 2026-02-03 --until 14:30

Searching and cleanup

• Search by name:

  food-journal search chicken
  

• List recent entries:

  food-journal recent 10
  

• Delete an entry by id:

  food-journal delete 42
  

Data storage

Entries are stored at:

~/.local/share/food-journal/food_journal.db