Skip to content

docs: point the Go runner references at v0.5.0, Go 1.27.3 and 9lives.run #36

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Desperado merged 1 commit into from
Oct 23, 2026
Merged

docs: point the Go runner references at v0.5.0, Go 1.27.3 and 9lives.run #36

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# 🐾 9lives

[Go runner website](https://quality-max.github.io/9lives-runner/) · [Migration guide](docs/MIGRATING_TO_GO.md) · [Standalone tools](https://docs.qualitymax.io/free-and-open-source/)
[Go runner website](https://9lives.run/) · [Migration guide](docs/MIGRATING_TO_GO.md) · [Standalone tools](https://docs.qualitymax.io/free-and-open-source/)

**Status: Python CLI in maintenance mode.** New Playwright projects should use the [9lives Go runner](https://github.com/Quality-Max/9lives-runner). New CLI features belong there; this package continues to receive security, correctness, and compatibility fixes for existing workflows. There is no Python removal date yet.

Expand All @@ -14,7 +14,7 @@ Read the [migration guide](docs/MIGRATING_TO_GO.md) for installation, command di

[Small UI change. Big test drama. Explore the developer memes on 9lives.run →](https://9lives.run/#memes)

**Linux. macOS. Windows. One local workflow.** The [Go runner v0.4.0](https://github.com/Quality-Max/9lives-runner/releases/tag/v0.4.0) has native binaries for all three, on x64 and ARM64. Keep your Playwright project, configuration, and assertions across your team’s machines. Windows users: follow the [ZIP download and checksum guide](https://github.com/Quality-Max/9lives-runner/blob/main/docs/install.md). Project dependencies and Chromium are separate; Windows provider CLI shell integrations remain unqualified.
**Linux. macOS. Windows. One local workflow.** The [Go runner v0.5.0](https://github.com/Quality-Max/9lives-runner/releases/tag/v0.5.0) has native binaries for all three, on x64 and ARM64. Keep your Playwright project, configuration, and assertions across your team’s machines. Windows users: follow the [ZIP download and checksum guide](https://github.com/Quality-Max/9lives-runner/blob/main/docs/install.md). Project dependencies and Chromium are separate; Windows provider CLI shell integrations remain unqualified.

## Recommended: Go runner for Playwright

Expand All @@ -30,10 +30,10 @@ export PATH="$HOME/.local/share/9lives-runner/bin:$PATH"

The installer uses a pinned, checksum-verified release and installs into a separate Go directory. `curl -fsSL https://9lives.run | sh` selects the same installer. Override the release or destination explicitly with `NINELIVES_VERSION` or `NINELIVES_INSTALL_DIR`; see the [migration guide](docs/MIGRATING_TO_GO.md). It does not install the SDK, project dependencies, or browsers. The installer and the 9lives.run site live in the [runner repository](https://github.com/Quality-Max/9lives-runner/blob/main/docs/website.md).

Alternatively, download a [prebuilt release](https://github.com/Quality-Max/9lives-runner/releases), or with Go 1.25.13 or newer:
Alternatively, download a [prebuilt release](https://github.com/Quality-Max/9lives-runner/releases), or with Go 1.27.3 or newer:

```bash
go install github.com/Quality-Max/9lives-runner/cmd/9l@v0.4.0
go install github.com/Quality-Max/9lives-runner/cmd/9l@v0.5.0
# Add your Go binary directory to PATH, then confirm which CLI you selected:
9l --version
9l plan tests/
Expand Down
6 changes: 3 additions & 3 deletions docs/MIGRATING_TO_GO.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Migrating from the Python CLI to the Go runner

The [9lives Go runner](https://quality-max.github.io/9lives-runner/) is the primary CLI for new Playwright projects. The Python `9lives` package is in maintenance mode: security, correctness, compatibility, and migration fixes continue; new CLI features belong in the [runner repository](https://github.com/Quality-Max/9lives-runner). Python remains available for existing workflows. There is no removal date yet.
The [9lives Go runner](https://9lives.run/) is the primary CLI for new Playwright projects. The Python `9lives` package is in maintenance mode: security, correctness, compatibility, and migration fixes continue; new CLI features belong in the [runner repository](https://github.com/Quality-Max/9lives-runner). Python remains available for existing workflows. There is no removal date yet.

## Install and select the right executable

Expand All @@ -21,10 +21,10 @@ curl -fsSL https://9lives.run/install.sh | \

The installer prints the PATH command and does not edit shell profiles. Its separate default directory leaves Python's entry points available. If a custom destination already contains a symlink or another CLI called `9l`, installation stops rather than overwriting it. Update any scripts that relied on the old Python installer to use `pip install 9lives` or `uv tool install 9lives` explicitly.

Alternatively, download a pinned [release and verify its checksum](https://github.com/Quality-Max/9lives-runner/blob/main/docs/install.md), or with Go 1.25.13 or newer:
Alternatively, download a pinned [release and verify its checksum](https://github.com/Quality-Max/9lives-runner/blob/main/docs/install.md), or with Go 1.27.3 or newer:

```sh
go install github.com/Quality-Max/9lives-runner/cmd/9l@v0.4.0
go install github.com/Quality-Max/9lives-runner/cmd/9l@v0.5.0
"$(go env GOPATH)/bin/9l" --version
```

Expand Down
Loading