Trails

Understanding Bread trails: your organization's breadcrumb paths.

What is a Trail?

A trail is a dedicated path for storing and searching conversation breadcrumbs. Think of it as a journey through your AI conversations, leaving markers to find your way back to important insights.

Key Characteristics

• Isolated search index: Each trail has its own vector embeddings
• Team collaboration: Trails can be shared with team members
• Scoped permissions: Row Level Security ensures proper access
• Unlimited breadcrumbs: No limits on conversation storage

Common Use Cases

📁 Project-Based

One trail per project or codebase

Frontend, Backend API, Mobile app trails

👥 Team-Based

One trail per team or department

Engineering, Product, Design team trails

🎯 Purpose-Based

One trail per activity or goal

Research, Bug investigations, Feature planning

👤 Personal

Private trails for individual use

Personal notes, Side projects, Learning journal

Trail Properties

Name

Human-readable identifier that can be changed anytime

Example: "My SaaS App"

Description

Optional explanation of the trail's purpose

Example: "React frontend development"

UUID

Unique identifier for API calls

550e8400-e29b-41d4...

Ownership & Members

Owner has full control; members can read and contribute

Default Trail

Every user has a default trail that's automatically created when they sign up. This trail is used when no explicit trailId is provided.

• No setup required - works immediately
• Simplifies API calls
• Perfect for personal use
• Can be customized like any other trail

Multiple Trails Strategy

When to Use Multiple Trails

✓ Separate work projects from personal learning
✓ Share relevant conversations with specific teams
✓ Narrow search scope to relevant content
✓ Separate experimental work from production

When to Use a Single Trail

✓ Getting started with the system
✓ Personal use without collaboration
✓ Want to search across all work
✓ Prefer simplicity over organization

Managing Trails

Creating a Trail

Navigate to Dashboard
Click "+ New Trail"
Enter name and optional description
Click "Create Trail"

Using Trails in Code

// Use default trail
drop-breadcrumb({ content: "..." })

// Use specific trail
drop-breadcrumb({
  content: "...",
  trailId: "trail-uuid-here"
})

⚠️ Deleting a Trail

Permanently removes:

• All breadcrumbs
• AI enrichment data
• Vector embeddings
• Analytics data

This cannot be undone.

Best Practices

✓ Start simple: Begin with the default trail
✓ Meaningful names: Use clear, descriptive names
✓ Document purpose: Add descriptions for team clarity
✓ Review periodically: Archive unused trails
✓ Coordinate with team: Agree on trail strategy