plant-tracker（植物追踪器）

Plant Tracker

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