Claude Gift Finder

A personal gift management system built as a Claude Code extension. Track the people you care about, their interests and preferences, and get AI-powered gift recommendations with local store availability.

Features

• People Profiles - Store interests, preferences, sizes, and important dates
• Gift History - Track what you've given and their reactions
• AI Research - Get personalized gift ideas with web search and synthesis
• Local Store Search - Find where to buy gifts in your area
• Shopping Lists - Generate mall-ready shopping lists grouped by store
• Slash Commands - Easy access via /gift-* commands in Claude Code

Quick Start

# Add someone to your gift list
/gift-add mom

# See all people and upcoming dates
/gift-list

# Get AI-powered gift ideas
/gift-idea mom

# Search for local store availability
/gift-stores mom

# Generate a shopping list
/gift-shopping mom

# Log a gift you gave
/gift-log mom

Commands

Command	Description
/gift	Show help and available commands
/gift-add <name>	Add a new person profile
/gift-list	List all people with upcoming occasions
/gift-show <name>	View someone's profile and saved ideas
/gift-idea <name>	Research personalized gift ideas (AI-powered)
/gift-stores <name>	Search for gift availability in local stores
/gift-shopping <name|all>	Generate shopping list from saved ideas
/gift-log <name>	Record a gift you gave
/gift-history <name>	View gift history for someone

Data Structure

All data is stored locally in the .gifts/ directory:

.gifts/
├── config.yaml         # Your location settings
├── mom/
│   ├── profile.yaml    # Interests, preferences, dates
│   └── history.yaml    # Past gifts and reactions
├── dad/
│   ├── profile.yaml
│   └── history.yaml
└── _example/           # Template for new profiles

Configuration

Set your location in .gifts/config.yaml:

location:
  city: "Montreal"
  region: "Quebec"
  country: "Canada"

Profile Schema

name: "Mom"
relationship: "mother"
birthday: "1965-03-15"
interests:
  - gardening
  - cooking
  - mystery novels
preferences:
  sizes:
    clothing: "M"
    shoe: "8"
  budget: "$50-150"
  dislikes:
    - "loud colors"
  loves:
    - "handmade items"
    - "experiences over things"
notes: "Prefers practical gifts. Allergic to lavender."
ideas:
  - name: "Ceramic herb planter"
    price: "$45"
    status: "considering"
    where: "mall"
    montreal_stores:
      - store: "Sephora"
        address: "Ste-Catherine West"
        confirmed: true

History Schema

gifts:
  - occasion: "birthday"
    date: "2024-03-15"
    gift: "Cooking class experience"
    price: "$120"
    reaction: "Loved it!"
    would_repeat: true

How It Works

1. Add people - Create profiles with their interests and preferences
2. Research ideas - Use /gift-idea to get AI-powered suggestions
3. Find local stores - Use /gift-stores to check availability in your area
4. Generate shopping list - Use /gift-shopping for a mall-ready list
5. Log gifts - Record what you gave and their reactions

Components

• Slash Commands (.claude/commands/) - User-invoked gift management
• Research Agent (.claude/agents/gift-researcher.md) - AI-powered gift discovery
• Discovery Skill (.claude/skills/gift-assistant/) - Autonomous help

Requirements

• Claude Code CLI tool

License

MIT