bun-agentic-starter

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

BDD-first testing with bun:test in this repository — scenario-oriented examples, describe/it layout rules, library-integration testing, and no Cucumber. Use when writing or changing tests, adding fixtures, mocking libraries, or when the user mentions BDD, TDD, bun:test, or Vitest.

Use when working in a repository that uses bd or Beads for durable project task tracking, issue dependencies, blocker management, multi-session handoff, or shared work memory. Trigger when the user asks to find ready work, claim or close tasks, create follow-up work, inspect blockers, recover project context, sync beads data, recover from an empty local database, or choose between local planning and persistent project tracking.

How to check a web page or Storybook story in a real browser in this repository, using only agent-browser. Use when verifying UI changes, looking at a page or component, taking screenshots, comparing against a baseline, testing a viewport or dark mode, or serving a production build over HTTPS to try it.

Repository conventions for this Bun starter — Bun-only tooling, workspace layout, quality gates, Lefthook hooks, Conventional Commits, Tailwind CSS, Storybook, type checking with `bun check`, and reference repositories in repos/. Use when starting work in this repository, choosing tools, running checks, committing, or when AGENTS.md / CLAUDE.md point here.

Run and troubleshoot Bead Me Up, Scotty, the local web UI for Beads, in Docker or rootless Podman. Use when starting or stopping the Beads UI, changing compose.yaml or docker/scotty/Dockerfile, fixing "permission denied" on .beads, SCOTTY_USER, podman-docker or docker compose problems, a Scotty board that shows 0 beads, the scotty-config volume, or bumping the Scotty or bd version.