Skip to content

Commit c05bec8

Browse files
committed
update skill.md
1 parent e4810b6 commit c05bec8

1 file changed

Lines changed: 27 additions & 13 deletions

File tree

skills/ko-browser/SKILL.md

Lines changed: 27 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,20 @@ allowed-tools: Bash(kbr:*)
66

77
# Browser Automation with ko-browser
88

9-
The CLI uses Chrome/Chromium via CDP directly. Install via `go install github.com/libi/ko-browser/cmd/kbr@latest` or build from source. Run `kbr install` to verify Chrome is available, or `kbr install --with-deps` to auto-install it. Existing Chrome, Brave, and Chromium installations are detected automatically.
9+
The CLI uses Chrome/Chromium via CDP directly. Install it with Homebrew on macOS, download a release binary on Windows or Linux, or use `go install` if you want to build from source. Run `kbr install` to verify Chrome is available, or `kbr install --with-deps` to auto-install it. Existing Chrome, Brave, and Chromium installations are detected automatically.
1010

1111
## Installation
1212

1313
```bash
14-
# Install kbr binary directly (no CGO, no external dependencies)
14+
# macOS: install with Homebrew
15+
brew tap libi/tap
16+
brew install ko-browser
17+
18+
# Go install: install kbr without OCR
1519
go install github.com/libi/ko-browser/cmd/kbr@latest
1620

17-
# Or build from source
18-
git clone https://github.com/libi/ko-browser.git
19-
cd ko-browser
20-
go build -o kbr ./cmd/kbr/
21-
mv kbr /usr/local/bin/
21+
# Go install: install kbr with OCR support
22+
CGO_ENABLED=1 go install -tags=ocr github.com/libi/ko-browser/cmd/kbr@latest
2223

2324
# Verify browser dependency
2425
kbr install
@@ -27,12 +28,25 @@ kbr install
2728
kbr install --with-deps
2829
```
2930

30-
> **OCR is optional.** The default install has zero CGO dependencies.
31-
> To enable `kbr snapshot --ocr`, rebuild with `-tags=ocr` (requires Tesseract):
32-
> ```bash
33-
> # Install Tesseract first: brew install tesseract (macOS) / apt install libtesseract-dev (Linux)
34-
> CGO_ENABLED=1 go install -tags=ocr github.com/libi/ko-browser/cmd/kbr@latest
35-
> ```
31+
**Platform-specific release installs:**
32+
33+
```powershell
34+
# Windows: download the latest release package, unzip, and run kbr.exe
35+
Invoke-WebRequest -Uri https://github.com/libi/ko-browser/releases/latest/download/ko-browser-windows-amd64.zip -OutFile ko-browser-windows-amd64.zip
36+
Expand-Archive .\ko-browser-windows-amd64.zip -DestinationPath .\ko-browser
37+
.\ko-browser\kbr.exe --help
38+
```
39+
40+
```bash
41+
# Linux: download the latest release package and place kbr in PATH
42+
curl -LO https://github.com/libi/ko-browser/releases/latest/download/ko-browser-linux-amd64.tar.gz
43+
tar xzf ko-browser-linux-amd64.tar.gz
44+
chmod +x kbr
45+
sudo mv kbr /usr/local/bin/kbr
46+
```
47+
48+
> **OCR is optional for go install.** The plain `go install` command has no CGO dependency.
49+
> **Release binaries and Homebrew installs include OCR support.** To use OCR, make sure Tesseract is installed first: `brew install tesseract` on macOS, `apt install libtesseract-dev` on Linux.
3650
3751
**Manual browser installation by OS:**
3852

0 commit comments

Comments
 (0)