lobster

# Lobster — Workflow Shell Typed, local-first pipeline engine. Deterministic execution, approval gates, persistent state. Saves tokens by replacing multi-step LLM re-planning with one-shot pipeline calls. ## CLI ```bash lobster '<pipeline>' # inline pipeline lobster run path/to/workflow.lobster # YAML workflow file lobster run --file wf.lobster --args-json '{"key":"val"}' lobster resume --token <token> --approve yes|no lobster doctor # health check lobster help <command> # per-command help ``` ## Pipeline Commands ### Data flow | Command | Purpose | Example | |---------|---------|---------| | `exec` | Run OS command | `exec --json --shell 'echo [1,2]'` | | `where` | Filter | `where 'status=OPEN'` | | `pick` | Project fields | `pick 'title,author,url'` | | `head` | First N items | `head --n 5` | | `sort` | Stable sort | `sort --key updatedAt --desc` | | `groupBy` | Group by key | `groupBy --key category` | | `dedupe` | Remove dupes | `dedupe --key id` | | `map` | Transform | `map --wrap items` / `map status=done` | | `template` | Render text | `template --text '{{title}} by {{author}}'` | ### Output | Command | Purpose | |---------|---------| | `json` | JSON output | | `table` | Table output | ### Control flow | Command | Purpose | |---------|---------| | `approve` | Halt for approval (`--emit` for non-TTY/tool mode) | | `state.get` | Read persistent state | | `state.set` | Write persistent state | | `diff....