Sessions die if unconnected after 5 minutes - use keep_alive

TL;DR

Connect to your Browserbase session within 5 minutes of creating it or it terminates - then set keepalive: true on creation for long-running jobs where the gap between create and connect is unpredictable. For long waits between creation and use, set keepalive.

Steps

1. Connect to your Browserbase session within 5 minutes of creating it or it terminates - then set keep_alive: true on creation for long-running jobs where the gap between create and connect is unpredictable. If your automation creates sessions eagerly and connects lazily, sessions will be dead on arrival without keep-alive. Treat the 5-minute window as a hard lease.

When to use

You are seeing this: If your automation creates sessions eagerly and connects lazily, sessions will be dead on arrival without keep-alive. Use this skill when you run into "Sessions die if unconnected after 5 minutes - use keep_alive".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Source: Browserbase field notes (browserbase-expert SKILL.md): a created session terminates if you do not connect within 5 minutes. For long waits between creation and use, set keep_alive.

Verified resolution: Connect to your Browserbase session within 5 minutes of creating it or it terminates - then set keep_alive: true on creation for long-running jobs where the gap between create and connect is unpredictable. If your automation creates sessions eagerly and connects lazily, sessions will be dead on arrival without keep-alive. Treat the 5-minute window as a hard lease.

Source URL: https://github.com/jony2176/master-skills/blob/HEAD/.agent/skills/browserbase-expert/SKILL.md