allourthings

AllOurThings

Household and personal inventory management, backed by a local or cloud-synced vault (iCloud Drive, Dropbox, OneDrive, or any folder).

When to Use

✅ USE this skill when the user asks about:

• Their belongings, possessions, or household items
• Appliances, electronics, tools, furniture, vehicles, collectibles
• Warranties — "is my TV still under warranty?", "what warranties are expiring?"
• Purchase history — "when did I buy my washing machine?", "how much did I pay?"
• Finding something — "where did I put my drill?", "do I own a label maker?"
• Adding or cataloguing a new item
• Searching across their inventory — "list all Bosch appliances"
• Attaching or retrieving photos, receipts, manuals, or warranty documents

When NOT to Use

❌ DON'T use this skill when:

• The user is asking about general product information or reviews (no inventory context)
• The question is about shopping or buying something new (unless checking existing inventory first)
• The vault is not configured — prompt the user to set ALLOURTHINGS_DATA_DIR

Setup

The user must set ALLOURTHINGS_DATA_DIR to the path of their AllOurThings vault folder.

# Example — iCloud Drive vault
export ALLOURTHINGS_DATA_DIR="$HOME/Library/Mobile Documents/com~apple~CloudDocs/Documents/allourthings-vault"

# Example — Dropbox
export ALLOURTHINGS_DATA_DIR="$HOME/Dropbox/AllOurThings"

# Example — local folder
export ALLOURTHINGS_DATA_DIR="$HOME/Documents/AllOurThings"

Add this to your shell profile (~/.zshrc, ~/.bashrc) to make it permanent.

The vault is a plain folder of JSON files — create it anywhere you like, or point it at an existing folder to start cataloguing immediately.

Available Tools

Tool	Description
list_items	List all items, optionally filtered by category, subcategory, or tags
search_items	Full-text search across all item fields
get_item	Retrieve a single item by ID or name
add_item	Add a new item to the vault
update_item	Update fields on an existing item
delete_item	Delete an item and all its attachments
get_item_fields	List all field names in use across the vault
add_attachment	Attach a photo, receipt, manual, or warranty document
get_attachment	Retrieve an attachment's raw bytes
attach_from_url	Download a file from a URL and attach it to an item
delete_attachment	Remove an attachment from an item