refactor(cli): ignore --session and enforce default runtime session

This commit is contained in:
leeguooooo
2026-03-04 18:19:33 +09:00
parent 7b454e14ed
commit d320e1df47
8 changed files with 72 additions and 161 deletions
-6
View File
@@ -131,12 +131,6 @@ This enables control of:
</tr>
</thead>
<tbody>
<tr>
<td>
<code>--session &lt;name&gt;</code>
</td>
<td>Use isolated session</td>
</tr>
<tr>
<td>
<code>-p &lt;provider&gt;</code>
+1 -2
View File
@@ -293,8 +293,7 @@ agent-browser reload # Reload page
## Global options
```bash
--session <name> # Isolated browser session
--session-name <name> # Auto-save/restore session state (defaults to --session when omitted)
--session-name <name> # Auto-save/restore session state (defaults to "default" when omitted)
--state <path> # Load storage state from JSON file
--headers <json> # HTTP headers scoped to URL's origin
--executable-path <path> # Custom browser executable
+2 -12
View File
@@ -119,15 +119,6 @@ Every CLI flag can be set in the config file using its camelCase equivalent:
</td>
<td>boolean</td>
</tr>
<tr>
<td>
<code>session</code>
</td>
<td>
<code>--session</code>
</td>
<td>string</td>
</tr>
<tr>
<td>
<code>sessionName</code>
@@ -474,11 +465,10 @@ These environment variables configure additional daemon and runtime behavior:
<code>AGENT_BROWSER_SESSION_NAME</code>
</td>
<td>
Auto-save/load state persistence name (defaults to <code>AGENT_BROWSER_SESSION</code> when
unset).
Auto-save/load state persistence name (defaults to <code>default</code> when unset).
</td>
<td>
(same as <code>AGENT_BROWSER_SESSION</code>)
<code>default</code>
</td>
</tr>
<tr>
+34 -28
View File
@@ -1,38 +1,27 @@
import { pageMetadata } from "@/lib/page-metadata"
import { pageMetadata } from '@/lib/page-metadata';
export const metadata = pageMetadata("sessions")
export const metadata = pageMetadata('sessions');
# Sessions
Run multiple isolated browser instances:
Use one default runtime session and optional named persistence:
```bash
# Different sessions
agent-browser --session agent1 open site-a.com
agent-browser --session agent2 open site-b.com
# Or via environment variable
AGENT_BROWSER_SESSION=agent1 agent-browser click "#btn"
# List active sessions
agent-browser session list
# Output:
# Active sessions:
# -> default
# agent1
# Show current session
# Show current runtime session
agent-browser session
# Output: default
# Show active daemon sessions
agent-browser session list
```
## Session isolation
Each session has its own:
The runtime session is fixed to `default`. Use `--session-name` to isolate persisted state files per workflow.
- Browser instance
- Cookies and storage
- Navigation history
- Cookies and storage snapshots
- Authentication state
- Saved state lifecycle
## Session persistence
@@ -50,7 +39,7 @@ export AGENT_BROWSER_SESSION_NAME=twitter
agent-browser open twitter.com
```
If `--session-name` is omitted, it defaults to `--session` (or `default`).
If `--session-name` is omitted, it defaults to `default`.
State files are stored in `~/.agent-browser/sessions/` and automatically loaded on daemon start.
@@ -164,12 +153,29 @@ agent-browser set headers '{"X-Custom-Header": "value"}'
<table>
<thead>
<tr><th>Variable</th><th>Description</th></tr>
<tr>
<th>Variable</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr><td><code>AGENT_BROWSER_SESSION</code></td><td>Browser session ID (default: "default")</td></tr>
<tr><td><code>AGENT_BROWSER_SESSION_NAME</code></td><td>Auto-save/load state persistence name</td></tr>
<tr><td><code>AGENT_BROWSER_ENCRYPTION_KEY</code></td><td>64-char hex key for AES-256-GCM encryption</td></tr>
<tr><td><code>AGENT_BROWSER_STATE_EXPIRE_DAYS</code></td><td>Auto-delete states older than N days (default: 30)</td></tr>
<tr>
<td>
<code>AGENT_BROWSER_SESSION_NAME</code>
</td>
<td>Auto-save/load state persistence name</td>
</tr>
<tr>
<td>
<code>AGENT_BROWSER_ENCRYPTION_KEY</code>
</td>
<td>64-char hex key for AES-256-GCM encryption</td>
</tr>
<tr>
<td>
<code>AGENT_BROWSER_STATE_EXPIRE_DAYS</code>
</td>
<td>Auto-delete states older than N days (default: 30)</td>
</tr>
</tbody>
</table>