<identity> session
Manage sessions.
<identity> session [options] [command]| Subcommand | Description |
|---|---|
start |
Start a session with Barry configuration. Harness flags come from installed adapters (barry adapter list) |
resume |
Resume a previous session. |
prompt |
Run a prompt using the Claude Agent SDK (non-interactive) |
adopt |
Move a TUI’s session to hosted, optionally with its next message (close the TUI first) |
list |
List active sessions. |
archive |
Archive a session (hide from resume picker) |
<identity> session start
Section titled “<identity> session start”Start a session with Barry configuration. Harness flags come from installed adapters (barry adapter list)
<identity> session start [options] [args...]| Argument | Required | Description |
|---|---|---|
args... |
Optional | Arguments to pass to the agent. |
| Option | Description |
|---|---|
--traits <traits> |
Comma-separated trait names to enable (e.g. web,communication) |
--bound <bounds> |
Named bound restricting the session (see barry bound list) |
--all |
Grant every packed bag’s tools (skips trait selection) |
--show-builtin |
Show builtin bags in the overview and capability picker (hidden by default — they are always granted) |
-r, --read |
Read-only: –all under the readonly bound. |
--relax |
Allow user-level MCP servers to merge in (default: strict, only Barry-configured MCPs) |
-d, --directive [directive] |
Set or prompt for a session directive. |
-n, --none |
Skip trait/directive selection (identity bags still grant their tools) |
-t, --transport <mode> |
Transport mode: http (default, instant) or stdio (debugging) Default http. |
--health-check |
Check MCP server health during startup (adds delay) |
--zai |
Use z.ai (GLM) as the model provider. |
--ollama |
Use a local Ollama model as the model provider. |
--llamacpp |
Use a local llama.cpp model as the model provider. |
--model-provider <key> |
Select a model endpoint explicitly (for example, ollama) |
--mode <mode> |
How Barry attaches: hosted, instrumented (was guest-plus), or guest. Defaults to the identity’s adapters.<harness>.mode, then the adapter’s own default. |
--prompt <prompt> |
Initial prompt to send when the session starts. |
-m, --model <model> |
Model to use (overrides the identity’s adapters.<harness>.model) |
-N, --session-name <name> |
Name the session (skips the name prompt at exit) |
--ui <renderer> |
UI renderer to launch for the session (btui, web, app, raw, none) |
--no-ui |
Start session in background without launching a UI. |
--adapter <name> |
Use an installed session adapter by id or alias. |
--opencode |
Use OpenCode. |
--codex |
Use Codex. |
--claude-code |
Use Claude Code. |
--claude |
Use Claude Code. |
--cursor |
Use Cursor. |
--antigravity |
Use Antigravity (experimental) |
--agy |
Use Antigravity (experimental) |
<identity> session resume
Section titled “<identity> session resume”Resume a previous session.
<identity> session resume [options] [sessionId]| Argument | Required | Description |
|---|---|---|
sessionId |
Optional | Barry session ID to resume (resolves to the agent’s session) |
| Option | Description |
|---|---|
--last |
Resume the most recent session for the current directory. |
-N, --session-name <name> |
Rename the resumed session. |
--ui <renderer> |
UI renderer to launch for the session (btui, web, app, raw, none) |
--no-ui |
Start session in background without launching a UI. |
--zai |
Use z.ai (GLM) as the model provider. |
--ollama |
Use a local Ollama model as the model provider. |
--llamacpp |
Use a local llama.cpp model as the model provider. |
--model-provider <key> |
Select a model endpoint explicitly (for example, ollama) |
--traits <traits> |
Comma-separated trait names to enable (skips the picker) |
--all |
Grant every packed bag’s tools (skips the picker) |
--show-builtin |
Show builtin bags in the overview and capability picker (hidden by default — they are always granted) |
-r, --read |
Read-only: –all under the readonly bound (skips the picker) |
--none |
Clear selected traits (skips the picker; identity bags still grant their tools) |
-p, --prompt <prompt> |
Send an initial prompt instead of starting interactively. |
--adapter <name> |
Use an installed session adapter by id or alias. |
--opencode |
Use OpenCode. |
--codex |
Use Codex. |
--claude-code |
Use Claude Code. |
--claude |
Use Claude Code. |
--cursor |
Use Cursor. |
--antigravity |
Use Antigravity (experimental) |
--agy |
Use Antigravity (experimental) |
<identity> session prompt
Section titled “<identity> session prompt”Run a prompt using the Claude Agent SDK (non-interactive)
<identity> session prompt [options]| Option | Description |
|---|---|
-p, --prompt <prompt> |
The prompt to send to Claude. Required. |
--max-turns <turns> |
Maximum number of turns. Default 15. |
-c, --cwd <directory> |
Working directory for the query. |
--traits <traits> |
Comma-separated trait names granting tools and skills. |
-m, --model <model> |
Model to use (overrides the identity’s default) |
<identity> session adopt
Section titled “<identity> session adopt”Move a TUI’s session to hosted, optionally with its next message (close the TUI first)
<identity> session adopt [options] <id> [message...]| Argument | Required |
|---|---|
id |
Required |
message... |
Optional |
<identity> session list
Section titled “<identity> session list”List active sessions.
<identity> session list [options]Alias: <identity> session ls.
<identity> session archive
Section titled “<identity> session archive”Archive a session (hide from resume picker)
<identity> session archive [options] [id]| Argument | Required |
|---|---|
id |
Optional |
| Option | Description |
|---|---|
--all-closed |
Archive all closed sessions. |
Every command also accepts -h, --help. All identity commands.