LobsterHub

A community marketplace for Lobster workflows. Browse, share, and install automation pipelines for Clawdbot.

What is Lobster?

Lobster is Clawdbot's workflow shell that chains skills into powerful automation pipelines. Think of it as "Shortcuts for your terminal" - composable automations that connect multiple tools together.

Features

• Browse - Grid of workflow cards with name, description, author, and required skills
• Search - Filter by name, skill dependencies, or category
• Detail Pages - Full YAML preview with syntax highlighting, install command, and skill links
• Submit - Form to add new workflows to the community hub
• Install - One-liner: npx lobsterhub install <workflow-slug>

Tech Stack

• Frontend: TanStack Start (React meta-framework)
• Backend: Supabase (PostgreSQL database, REST API)
• Styling: Tailwind CSS
• Deploy: Vercel / Cloudflare Pages

Getting Started

Prerequisites

• Node.js 18+
• npm or bun
• Supabase account (free tier)

Installation

# Clone the repository
git clone https://github.com/clawdbot/lobsterhub.git
cd lobsterhub

# Install dependencies
npm install

# Copy environment variables
cp .env.local.example .env.local
# Edit .env.local with your Supabase project URL and anon key

Database Setup

1. Create a new Supabase project at supabase.com
2. Go to the SQL Editor in your Supabase dashboard
3. Run the schema from supabase/schema.sql - this creates the tables and seeds example data

Running Locally

npm run dev

CLI Usage

Install workflows directly from the command line:

# Install a workflow
npx lobsterhub install morning-briefing

# List installed workflows
npx lobsterhub list

# Search for workflows
npx lobsterhub search "email automation"

Workflows are installed to ~/.clawdbot/lobster/workflows/ by default.

Workflow Format

Lobster workflows are YAML files that define a pipeline of steps:

name: morning-briefing
description: Daily summary of calendar, emails, and tasks
args:
  channel:
    default: "telegram"
    description: "Where to send the briefing"

steps:
  - id: calendar
    command: gog.gcal.today --json
    description: Fetch today's calendar events

  - id: email
    command: gog.gmail.search --query 'newer_than:1d' --json
    description: Get emails from the last 24 hours

  - id: summarize
    command: llm-task --prompt "Create a morning briefing summary"
    stdin: $calendar.stdout, $email.stdout
    description: AI summarizes all inputs

  - id: send
    command: clawd.invoke --tool message --action send --channel $args.channel
    stdin: $summarize.stdout
    description: Send briefing to user

Project Structure

lobsterhub/
├── src/
│   ├── routes/           # TanStack Start file-based routing
│   │   ├── __root.tsx    # Root layout
│   │   ├── index.tsx     # Homepage
│   │   ├── workflow.$slug.tsx  # Workflow detail page
│   │   ├── submit.tsx    # Submit form
│   │   └── category.$category.tsx  # Category filter
│   ├── lib/
│   │   ├── supabase.ts   # Supabase client
│   │   ├── api.ts        # API functions
│   │   └── database.types.ts  # TypeScript types
│   └── styles.css        # Global styles (Tailwind)
├── supabase/
│   └── schema.sql        # Database schema + seed data
├── packages/
│   └── lobsterhub/       # CLI package
│       └── src/
│           ├── cli.ts
│           ├── api.ts
│           └── commands/
└── package.json

API

The app uses Supabase's REST API directly. The CLI can be configured with environment variables:

export LOBSTERHUB_SUPABASE_URL=https://your-project.supabase.co
export LOBSTERHUB_SUPABASE_ANON_KEY=your-anon-key

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Related Projects

• ClawdHub - Skills marketplace for Clawdbot
• Clawdbot - The AI-powered automation platform
• Lobster Docs - Workflow shell documentation

License

MIT