events

Manage a SQLite-based event queue via command-line interface.

43|4|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/gordonbrander/busytown --skill events-gordonbrander
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: events
Source: https://github.com/gordonbrander/busytown/tree/main/.claude/skills/events
Command: npx skills add https://github.com/gordonbrander/busytown --skill events-gordonbrander

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a command-line interface for interacting with a SQLite-backed event queue, enabling seamless inter-worker communication and coordination.

Core Features & Use Cases

  • Event Pushing: Add new events to the queue with specified types and payloads.
  • Event Watching: Monitor the queue for new events and stream them in real-time.
  • Cursor Management: Track and manage worker positions within the event stream for reliable delivery.
  • Event Listing & Filtering: Retrieve historical events with flexible filtering by worker, type, and ID.
  • Event Claiming: Coordinate which worker processes a specific event to avoid duplication.

Quick Start

Use the events skill to push a new task.created event for agent-1 with a payload containing the name 'foo'.

Frequently Asked Questions about events

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage a SQLite event queue for inter-agent communication?

You can manage a SQLite event queue for inter-agent communication using a command-line interface that supports pushing, watching, listing, and claiming events to facilitate asynchronous task distribution. It enables seamless multi-agent coordination.

How do I push a new event to a SQLite-backed event queue via CLI?

To push a new event via CLI, you use the event pushing feature to add entries to the SQLite queue with specified event types and JSON payloads. This allows agents to inject tasks like 'task.created' for other workers to process.

Can I track worker positions in an event stream to ensure reliable delivery?

Yes, you can track worker positions in an event stream using cursor management features. This functionality monitors and updates worker positions within the SQLite event queue to guarantee reliable event delivery and processing.

Does this event queue CLI support filtering historical events by worker or type?

Yes, the event queue CLI supports retrieving historical events with flexible filtering options. You can filter the historical event records retrieved from the SQLite queue by specific worker, event type, and event ID.

What is the best way to coordinate which worker processes a specific event?

The best way to coordinate which worker processes a specific event is by using the event claiming feature. This mechanism coordinates worker assignments to ensure only one agent processes a claimed event, avoiding task duplication.