Skip to content

docs(skill): add preflight guidance for parallel tasks #152

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

Open
xiyanjun wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(skill): add preflight guidance for parallel tasks #152

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
2 changes: 2 additions & 0 deletions crates/bsk-cli/skill/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,8 @@ Drive the user's **real Chromium browser** (with their logins and cookies) throu

Every automation task **must** follow this lifecycle. Do **not** rely on idle timeouts (default session idle is 5 minutes).

**Preflight before parallel tasks.** All sessions in a browser share one cookie jar, so two tasks hitting the same logged-in site overwrite each other's login state silently. Before running tasks in parallel, run `bsk session list` and `bsk tab list --session <id> --scope all --json` to check for domain overlap. If the target domain overlaps an active session's agent tab, run the tasks SERIALLY, or use a separate browser profile (install the extension there, then `bsk session start --browser <instance-id>`), since different profiles have isolated cookie jars. If you expect N parallel tasks, ensure ≥ N active sessions.

```
1. bsk session start → capture the 4-letter session id printed on stdout
2. … every tool command … → always pass --session <id>
Expand Down
2 changes: 2 additions & 0 deletions skill/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,8 @@ Drive the user's **real Chromium browser** (with their logins and cookies) throu

Every automation task **must** follow this lifecycle. Do **not** rely on idle timeouts (default session idle is 5 minutes).

**Preflight before parallel tasks.** All sessions in a browser share one cookie jar, so two tasks hitting the same logged-in site overwrite each other's login state silently. Before running tasks in parallel, run `bsk session list` and `bsk tab list --session <id> --scope all --json` to check for domain overlap. If the target domain overlaps an active session's agent tab, run the tasks SERIALLY, or use a separate browser profile (install the extension there, then `bsk session start --browser <instance-id>`), since different profiles have isolated cookie jars. If you expect N parallel tasks, ensure ≥ N active sessions.

```
1. bsk session start → capture the 4-letter session id printed on stdout
2. … every tool command … → always pass --session <id>
Expand Down