home-inventory

Document everything you own for insurance, moving, or estate planning. Manage a JSON database of household items with depreciation tracking, insurance-ready reports, and moving box labeling.

Track everything you own — for insurance claims, moving logistics, or estate planning.

Quick Start

bash

# Add an item
python scripts/inventory.py add \
  --name "MacBook Pro" \
  --category "electronics" \
  --room "office" \
  --value 2400 \
  --brand "Apple" \
  --model "MacBook Pro 14 M3" \
  --serial "C02XK1234ABC" \
  --purchase-date "2024-03-15" \
  --notes "AppleCare+ until 2027"

# List all items
python scripts/inventory.py list

# Search by keyword
python scripts/inventory.py search "MacBook"

# Items in a specific room
python scripts/inventory.py by-room kitchen

# Total value of everything
python scripts/inventory.py total-value

# Export to CSV (for spreadsheets / insurance upload)
python scripts/inventory.py export-csv --output inventory.csv

# Insurance report (replacement cost, room-by-room breakdown)
python scripts/inventory.py insurance-report

# Depreciation report (current vs purchase value by category)
python scripts/inventory.py depreciation-report

# Assign items to moving boxes and generate box manifests
python scripts/inventory.py assign-box --item-id 3 --box "BOX-001"
python scripts/inventory.py box-manifest BOX-001

Data Storage

All items are stored in inventory.json (configurable via --db). Each item has:

Field	Description
id	Auto-incremented unique ID
name	Item name
category	electronics, furniture, jewelry, …
room	Where the item lives
purchase_date	ISO date (YYYY-MM-DD)
estimated_value	Current replacement value (float)
brand_model	Manufacturer and model
serial_number	Serial number for ID/claims
photo_path	Path to a photo of the item
qr_label_id	QR label identifier
box_id	Moving box assignment
notes	Free-text notes

Depreciation Model

Depreciation rates are defined by category in references/depreciation-tables.md:

• Electronics: fast depreciation (~25%/yr, ~5yr lifespan)
• Furniture: slow depreciation (~8%/yr, ~15yr lifespan)
• Appliances: moderate (~12%/yr, ~10yr lifespan)
• Clothing: fast (~20%/yr, ~5yr lifespan)
• Jewelry: appreciates (~3%/yr)
• Art/Collectibles: appreciates (~5%/yr)

See references/depreciation-tables.md for full details.

Insurance Reports

The insurance report provides:

• Total replacement cost across all items
• Room-by-room breakdown
• Category subtotals
• High-value item flags (>$1,000)

See references/insurance-claims-guide.md for claim documentation best practices.

Moving Box System

• Assign items to boxes with assign-box
• Generate QR-friendly manifests with box-manifest
• Each manifest lists all items, total value, and a compact QR-encodable summary