# bix

> Browser automation, from building blocks. Snap together recipes for screenshots, scraping, monitoring, and extraction. Schedule them as jobs. Pipe results anywhere.

## Getting Started

- [Skill File](https://bix.app/skill.md): Complete reference — CLI commands, API endpoints, recipes, jobs, and pricing.
- [Recipe Gallery](https://bix.app/recipes): 15+ pre-built browser automations you can run or schedule.
- [CLI](https://www.npmjs.com/package/@bixapp/cli): Install with `npx @bixapp/cli signup`. Binary: `bix`.
- [Dashboard](https://bix.app/dashboard): Web UI for recipes, jobs, results, and billing.

## What bix does

- **Capture**: Screenshot, PDF, or GIF of any page. 40+ options (device, viewport, selectors, dark mode, ad blocking).
- **Extract**: Page to markdown, structured JSON, links, or raw text. AI-powered extraction built in.
- **Run**: Execute custom browser scripts in sandboxed environments. Navigate, click, type, fill forms, scrape data.
- **Jobs**: Schedule any script to run on a cron. Daily, weekly, or interval. Retries, logs, screenshots, and reports stored automatically.
- **Billing**: Check usage, buy credits, manage auto-recharge — via CLI or dashboard.

## CLI (first-class interface)

```
bix signup                          # OAuth signup
bix capture <url>                   # Screenshot
bix extract <url>                   # Content extraction
bix run <script>                    # Run browser script
bix jobs create --name <n> ...      # Schedule a job
bix jobs list                       # List jobs
bix jobs run <id>                   # Trigger manually
bix jobs attempts <id>              # View run history
bix status                          # Credits + usage
bix topup                           # Buy credits
```

## API Endpoints

- `GET/POST /v1/capture` — Screenshot, PDF, or GIF (1 credit)
- `POST /v1/markdown` — Page to markdown (1 credit)
- `POST /v1/json` — AI-powered structured extraction (3 credits)
- `POST /v1/scrape` — Extract by CSS selectors (1 credit)
- `POST /v1/run` — Run browser script (2+ credits)
- `GET/POST /v1/jobs` — Scheduled job CRUD
- `POST /v1/jobs/:id/run` — Trigger job
- `GET /v1/attempts/:id` — Attempt detail + artifacts

## Pricing

- Free: 100 credits on signup, no credit card
- Starter: $5 / 500 credits
- Builder: $20 / 2,200 credits
- Pro: $50 / 6,000 credits
- Scale: $100 / 13,000 credits