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 |
Example Interactions
"What electronics do I own?"
→ list_items with category: "Electronics"
"Is my dishwasher still under warranty?"
→ search_items for "dishwasher", check warranty_expires
"I just bought a Dyson V15 vacuum for £499"
→ add_item with name, brand, purchase price, and date
"Show me everything I bought from Amazon last year"
→ search_items for "Amazon" or list_items filtered by retailer
"Attach the receipt for my MacBook"
→ add_attachment with kind receipt
CLI
AllOurThings also ships a standalone CLI (@allourthings/cli) for scripting
and automation outside of an AI session:
npx @allourthings/cli list
npx @allourthings/cli search "bosch"
npx @allourthings/cli add --name "Dyson V15" --category "Appliances"
Set ALLOURTHINGS_DATA_DIR or pass --data-dir to point at your vault.
Notes
- Data is stored as plain JSON files — fully portable, no lock-in
- Works with any sync provider that exposes a local folder path (iCloud Drive, Dropbox, OneDrive, etc.)
- The MCP server and CLI share the same vault format — interchangeable