# Pantry Tracker

> Track pantry inventory with barcode scanning, expiration dates, and low stock alerts

- Skill: `ticruz38/pantry-tracker` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add ticruz38/pantry-tracker`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ticruz38/pantry-tracker/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ticruz38 (https://skillmd.com/u/ticruz38)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ticruz38/pantry-tracker

---


## Overview

Pantry Tracker is a comprehensive inventory management system for tracking food and household items. It supports barcode scanning (manual entry), expiration date tracking, low stock alerts, and automatic shopping list generation.

## Features

- **Barcode Scanning**: Track items by barcode for quick lookup and restocking
- **Quantity Tracking**: Monitor exact quantities with customizable units
- **Expiration Dates**: Track expiration dates with automatic alerts
- **Low Stock Alerts**: Get notified when items fall below threshold
- **Shopping List**: Auto-generate shopping lists from low stock and expired items
- **Categories**: Organize items by category (produce, dairy, pantry, etc.)
- **Search**: Find items by name, barcode, or notes

## Installation

```bash
cd skills/pantry-tracker
npm install
npm run build
```

## Usage

### CLI Commands

```bash
# Check status
npx pantry-tracker status

# Add items
npx pantry-tracker add "Milk" -q 2 -u gallon -c dairy -e 2026-02-15
npx pantry-tracker add "Eggs" -q 12 -u count -c dairy --threshold 3

# Scan barcode (auto-restock if exists)
npx pantry-tracker scan 123456789 "Organic Milk" -q 1 -c dairy

# List items
npx pantry-tracker list
npx pantry-tracker list --category produce
npx pantry-tracker list --low-stock

# View details
npx pantry-tracker get 5

# Update items
npx pantry-tracker update 5 --quantity 3 --expires 2026-03-01

# Consume/restock
npx pantry-tracker consume 5 0.5    # Use 0.5 units
npx pantry-tracker restock 5 2      # Add 2 units

# Alerts and shopping
npx pantry-tracker alerts           # Low stock alerts
npx pantry-tracker expiring 7       # Items expiring in 7 days
npx pantry-tracker shopping-list    # Generate shopping list

# Management
npx pantry-tracker stats            # Pantry statistics
npx pantry-tracker clear-expired    # Remove expired items
```

### Library Usage

```typescript
import { PantryTrackerSkill } from '@openclaw/pantry-tracker';

const pantry = new PantryTrackerSkill();

// Add items
const milk = await pantry.addItem({
  barcode: '0123456789',
  name: 'Organic Milk',
  quantity: 2,
  unit: 'gallon',
  category: 'dairy',
  expirationDate: '2026-02-15',
  lowStockThreshold: 1
});

// Get alerts
const lowStock = await pantry.getLowStockAlerts();
const expiring = await pantry.getExpirationAlerts(7);

// Generate shopping list
const shoppingList = await pantry.generateShoppingList();

// Clean up
await pantry.close();
```

## Categories

- **produce** - Fresh fruits and vegetables
- **meat** - Meat products
- **seafood** - Fish and seafood
- **dairy** - Milk, cheese, eggs
- **bakery** - Bread, pastries
- **frozen** - Frozen foods
- **pantry** - Dry goods, canned items
- **beverages** - Drinks
- **household** - Cleaning supplies, paper goods
- **other** - Miscellaneous

## Data Storage

All data is stored locally in SQLite at `~/.openclaw/skills/pantry-tracker/pantry.db`.

## No External Dependencies

This skill works entirely offline with no API keys or external services required.