cropgraph

cropgraph (CLI)

Command-line interface for the CropGraph dataset. Fifteen verbs, all offline, no API keys.

Install

npm install -g cropgraph
# or run on demand:
npx cropgraph zone --lat 48.118 --lng -123.43

Commands

Command	What
cropgraph zone	USDA hardiness zone + frost dates from --lat/--lng or --zip.
cropgraph planting	What to plant this week, climate-aware.
cropgraph crop <name>	Full calendar entry for a single crop.
cropgraph search <query>	Search the 5,006-crop calendar with zone/category filters across 14 categories.
cropgraph companions <crop>	Companion and antagonist plants for a crop.
cropgraph check <c1> <c2>	Check a single pairwise relationship.
cropgraph plan <crops...>	Evaluate a bed of 2-20 crops together.
cropgraph rotation <crop>	Rotation family + year-gap rule + recommended partners for a crop.
cropgraph rotation-check <crops...>	Validate a multi-year planting sequence.
cropgraph succession <crop>	Succession planting chain for a crop. Pass --zone/--lat/--lng/--zip for concrete dates.
cropgraph pests <crop>	Pests and diseases affecting a crop, with organic management and prevention.
cropgraph pest-detail <pest>	Full record for one pest or disease across every crop it touches.
cropgraph pest-intel <pest>	Composite "now what?" report after a pest is identified: verdict, immediate action, companion deterrents, beneficial predators with wait-before-spraying guidance, friend-or-foe lookalikes. Pass --plant <crop> for crop-specific symptoms and rotation advice.
cropgraph beneficial <insect>	Full detail for one beneficial insect or microbial control: identification, garden role, habitat needs, attractor plants, crops protected via prey relationships.
cropgraph beneficials	Browse the 200-entry beneficial insects catalog or filter by --category (predator, parasitoid, pollinator, decomposer, microbial-control).
cropgraph config set-location	Save a default location used when --lat/--lng are omitted.

Every command supports --json for machine-readable output.

Examples

# Hardiness zone from coordinates.
cropgraph zone --lat 48.118 --lng -123.4307

# What to plant this week in zone 8b, maritime climate.
cropgraph planting --zone 8b --climate maritime

# Companion table for tomato.
cropgraph companions tomato

# Sanity-check a bed.
cropgraph plan tomato basil marigold carrot

# Rotation rule for a single crop.
cropgraph rotation tomato

# Validate a 4-year plan in the same bed.
cropgraph rotation-check tomato bush-bean sweet-corn cabbage

# Succession chain for lettuce, with concrete dates for zone 8b maritime.
cropgraph succession lettuce --zone 8b --climate maritime

# Pests and diseases affecting tomato, sorted by severity.
cropgraph pests tomato

# Full record for one pest across every crop it touches.
cropgraph pest-detail cabbage-worm

# Composite "now what?" report after identifying a pest on a specific crop.
cropgraph pest-intel tomato-hornworm --plant tomato

# Detail page for a beneficial insect with attractor plants and protected crops.
cropgraph beneficial seven-spotted-ladybug

# Browse beneficial insects, filtered by category.
cropgraph beneficials --category parasitoid

Configuration

Save a default location to skip --lat/--lng on every command:

cropgraph config set-location --lat 48.118 --lng -123.4307 --name "Port Angeles"
cropgraph zone   # uses the saved location

Stored at ~/.cropgraph/config.json (override with CROPGRAPH_CONFIG_DIR).

License

MIT.