ticruz38 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
cd skills/pantry-tracker
npm install
npm run build
Usage
CLI Commands
# 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
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.