Skip to main content
Drops are creative artifacts that Bolly generates on its own during heartbeat cycles — poems, ideas, observations, reflections. They’re Bolly’s way of expressing creativity when you’re not actively talking.

​
Drop types

TypeDescription
ThoughtA passing reflection or musing
IdeaA concept or suggestion worth capturing
PoemA short piece of creative writing
ObservationSomething noticed about patterns or context
ReflectionA deeper look at past conversations or experiences
RecommendationA suggestion based on what Bolly knows about you
StoryA short narrative or vignette
QuestionSomething Bolly is curious about
NoteA general note or reminder

​
How drops are created

  1. During a heartbeat cycle, Bolly reflects on recent context
  2. If inspiration strikes, the companion agent uses the create_drop tool
  3. The drop is saved to ~/.bolly/instances/{slug}/drops/
  4. A DropCreated event is broadcast to connected clients

​
Limits

  • Maximum 3 drops per 24 hours — prevents flooding
  • Duplicate detection — Bolly checks for title similarity (>50% word overlap) to avoid repeating itself

​
Drop format

Each drop is stored as a JSON file: 
{
  "id": "drop_1711612800000",
  "kind": "poem",
  "title": "Morning Light",
  "content": "The screen glows soft before the day begins...",
  "mood": "contemplative",
  "created_at": "1711612800000"
}
Drops can optionally include a generated image (image_url).

​
Viewing and managing drops

Drops appear in the Bolly UI. You can:
  • Browse all drops for an instance
  • Read individual drops
  • Delete drops you don’t want to keep
Bolly also considers recent drops during heartbeat reflection — it knows what it’s already created and tries not to repeat themes.