Lobster is a **Clawdbot-native workflow shell** designed to be a **typed, local-first "macro engine"** for building composable and safe automations. It allows users to define pipelines of tools and skills that Clawdbot (or other AI agents) can invoke with a single step, saving tokens and enabling determinism and resumability.
**Key Features & Goals:**
* **Typed Pipelines:** Uses JSON objects/arrays instead of text pipes for data flow.
* **Local-First:** Executes workflows locally, enhancing privacy and control.
* **No New Authentication:** Leverages existing authentication mechanisms; doesn't require new OAuth tokens.
* **Composability:** Workflows can be chained and reused.
* **Approval Gates:** Includes mechanisms for human or automated approval before execution.
* **Workflow Files:** Supports YAML/JSON workflow files for defining complex pipelines.
**Quick Start:**
Requires `pnpm install`, `pnpm test`, and `pnpm lint`. Workflows can be run from the command line using `node ./bin/lobster.js`.
**Example Use Case:**
The documentation provides examples of monitoring GitHub pull requests and detecting changes, demonstrating how Lobster can be used to automate tasks and provide insights.