huckleberry

Huckleberry CLI

Command-line interface for Huckleberry, a baby tracking app. Authenticate once and log sleep, feeds, diapers, and growth from your terminal.

Note: This is an unofficial tool and is not affiliated with Huckleberry.

Install

pip install huckleberry-cli

Quick start

huckleberry login
huckleberry children
huckleberry sleep start

Commands

Sleep

huckleberry sleep start      # Start sleep timer
huckleberry sleep stop       # Complete sleep (saves duration)
huckleberry sleep pause      # Pause sleep timer
huckleberry sleep resume     # Resume paused sleep
huckleberry sleep cancel     # Cancel without saving

Feeding

Breastfeeding:

huckleberry feed start --side=left    # Start nursing (left side)
huckleberry feed start --side=right   # Start nursing (right side)
huckleberry feed switch               # Switch sides mid-feed
huckleberry feed stop                 # Complete feeding

Bottle:

huckleberry feed bottle <amount> [--type=TYPE] [--units=UNITS]

# Examples:
huckleberry feed bottle 120                           # 120ml formula (default)
huckleberry feed bottle 4 --units=oz                  # 4oz formula
huckleberry feed bottle 100 --type="Breast Milk"      # 100ml pumped milk

Types: Formula, Breast Milk, Mixed Units: ml (default), oz

Diapers

huckleberry diaper pee                              # Wet only
huckleberry diaper poo                              # Dirty only
huckleberry diaper both                             # Wet + dirty
huckleberry diaper dry                              # Dry check

# With details:
huckleberry diaper poo --color=yellow               # With color
huckleberry diaper poo --consistency=soft           # With consistency
huckleberry diaper both --color=brown --consistency=runny

Colors: yellow, green, brown, black, red Consistency: runny, soft, solid, hard

Growth

huckleberry growth --weight=7.5                     # Weight in kg
huckleberry growth --height=65                      # Height in cm
huckleberry growth --head=42                        # Head circumference in cm
huckleberry growth --weight=7.5 --height=65 --head=42  # All at once

# Imperial units:
huckleberry growth --weight=16.5 --units=imperial   # Weight in lbs

Info

huckleberry children           # List children
huckleberry --json children    # JSON output (--json before subcommand)
huckleberry status             # Current status

Multiple Children

huckleberry --child="Baby" sleep start   # Specify child by name
huckleberry -c "Baby" diaper pee

Authentication

Config stored at ~/.config/huckleberry/config.json.

huckleberry login                        # Interactive setup

Or use environment variables:

export HUCKLEBERRY_EMAIL="your@email.com"
export HUCKLEBERRY_PASSWORD="your-password"
export HUCKLEBERRY_TIMEZONE="America/Los_Angeles"

Requirements

• Python 3.11+
• huckleberry-api

Unit Conversions

• 1 oz ≈ 30 ml
• 1 lb ≈ 0.45 kg
• 1 inch ≈ 2.54 cm