Plant Tracker

Manage and track your plants and garden with care schedules, growth monitoring, and detailed records for watering, fertilizing, pruning, harvesting, and more.

Manage your plants and garden with structured tracking and care schedules.

Quick Start

Add a plant to your collection

plant_tracker.py add "<plant_name>" --species "<species>" --location "<location>"

List all plants

plant_tracker.py list

Show plant details

plant_tracker.py show "<plant_name>"

Record care (watering, fertilizing, etc.)

plant_tracker.py care "<plant_name>" --action "<action>" [notes]

Search plants

plant_tracker.py search "<query>"

Export plant data

plant_tracker.py export "<output_file>"

Usage Patterns

For indoor plant collections

Track houseplants with care schedules:

# Add your plants
plant_tracker.py add "Snake Plant" --species "Sansevieria trifasciata" --location "Living Room - North Window"
plant_tracker.py add "Monstera" --species "Monstera deliciosa" --location "Bedroom - East Window"
plant_tracker.py add "Pothos" --species "Epipremnum aureum" --location "Bathroom"

# Record watering
plant_tracker.py care "Snake Plant" --action "water" "Watered thoroughly, let drain"
plant_tracker.py care "Monstera" --action "water" "Watered until runoff, humidity 60%"

# Check what needs attention
plant_tracker.py list

For vegetable gardens

Track your edible plants with planting dates and harvests:

# Add vegetables
plant_tracker.py add "Tomatoes" --species "Solanum lycopersicum" --location "Backyard - Bed 3" --planted "2026-04-15"
plant_tracker.py add "Basil" --species "Ocimum basilicum" --location "Backyard - Container" --planted "2026-05-01"
plant_tracker.py add "Lettuce" --species "Lactuca sativa" --location "Front Yard - Raised Bed" --planted "2026-04-20"

# Record care and harvests
plant_tracker.py care "Tomatoes" --action "water" "Deep watering, weather hot"
plant_tracker.py care "Tomatoes" --action "fertilize" "Added organic tomato fertilizer"
plant_tracker.py care "Basil" --action "harvest" "Harvested 20 leaves for pesto"

# See what's ready to harvest
plant_tracker.py search "harvest"

For flower gardens

Track ornamental plants and seasonal care:

# Add flowers
plant_tracker.py add "Roses" --species "Rosa" --location "Front Garden" --planted "2025-03-10"
plant_tracker.py add "Lavender" --species "Lavandula" --location "Side Garden" --planted "2025-04-20"
plant_tracker.py add "Sunflowers" --species "Helianthus annuus" --location "Backyard" --planted "2026-05-15"

# Record seasonal care
plant_tracker.py care "Roses" --action "prune" "Spring pruning, removed dead wood"
plant_tracker.py care "Lavender" --action "prune" "Post-bloom pruning to encourage new growth"
plant_tracker.py care "Sunflowers" --action "harvest" "Harvested seeds for next year"

For multi-garden management

Track plants across different locations:

# Indoor plants
plant_tracker.py add "Peace Lily" --location "Living Room"
plant_tracker.py add "Fiddle Leaf Fig" --location "Bedroom"

# Outdoor beds
plant_tracker.py add "Peppers" --location "Backyard - Bed 1"
plant_tracker.py add "Carrots" --location "Backyard - Bed 2"

# Community garden plot
plant_tracker.py add "Squash" --location "Community Plot A - Row 3"

# Filter by location
plant_tracker.py search "Bedroom"
plant_tracker.py search "Backyard"

Actions Reference

Available care actions

• water - Watering schedule
• fertilize - Adding nutrients/compost
• prune - Trimming and shaping
• harvest - Collecting fruits/vegetables/herbs
• repot - Moving to a larger container
• plant - Initial planting or transplanting
• pesticide - Pest treatment
• inspect - General health check
• note - General observation

Security

Path Validation

The export function validates output paths to prevent malicious writes:

• ✅ Allowed: ~/.openclaw/workspace/, /tmp/, and home directory
• ❌ Blocked: System paths (/etc/, /usr/, /var/, etc.)
• ❌ Blocked: Sensitive dotfiles (~/.bashrc, ~/.ssh, etc.)

Data Storage

• All plant data is stored in: ~/.openclaw/workspace/plants_db.json
• Each plant tracks: name, species, location, planting date, care history
• Care history includes: action, timestamp, notes
• JSON format makes it easy to backup or migrate

Search Features

• Case-insensitive search across all plants
• Matches plant names, species, locations, and care notes
• Shows full plant details with care history
• Perfect for finding specific plants or care patterns

Examples

New garden setup

# Plan and track your new garden
plant_tracker.py add "Tomatoes - Beefsteak" --species "Solanum lycopersicum" --location "Backyard - Bed 1" --planted "2026-04-15"
plant_tracker.py add "Tomatoes - Cherry" --species "Solanum lycopersicum" --location "Backyard - Bed 1" --planted "2026-04-15"
plant_tracker.py add "Bell Peppers" --species "Capsicum annuum" --location "Backyard - Bed 2" --planted "2026-04-20"
plant_tracker.py add "Cucumbers" --species "Cucumis sativus" --location "Trellis - South Wall" --planted "2026-05-01"

# Export your garden plan
plant_tracker.py export "~/garden-planting-plan.md"

Weekly garden maintenance

# Check your garden
plant_tracker.py list

# Record this week's care
plant_tracker.py care "Tomatoes - Beefsteak" --action "water" "Deep watering, mulch added"
plant_tracker.py care "Bell Peppers" --action "fertilize" "Added compost, plants look healthy"
plant_tracker.py care "Cucumbers" --action "inspect" "Found aphids on some leaves, treated with neem oil"

Track growth and yields

# Record harvests
plant_tracker.py care "Tomatoes - Cherry" --action "harvest" "Harvested 2 cups, sweet and juicy"
plant_tracker.py care "Bell Peppers" --action "harvest" "Harvested 3 peppers, good size"
plant_tracker.py care "Cucumbers" --action "harvest" "Harvested 5 cucumbers, about 15cm each"

# Review harvest history
plant_tracker.py search "harvest"

Best Practices

1. Use descriptive names - "Tomatoes - Beefsteak" not just "Tomatoes"
2. Include planting dates - helps track age and harvest windows
3. Be specific with locations - "Backyard - Bed 1" not just "Garden"
4. Record care regularly - builds history for future reference
5. Note observations - pests, diseases, flowering, fruiting
6. Export regularly - backup your plant data