xlflow session

Keep Excel and the configured workbook open across repeated commands.

Usage

bash

xlflow session start
xlflow session status
xlflow session stop

Option / argument	Description	Default
`start`	Open and register the managed workbook session.	-
`status`	Show whether the session is running and dirty.	-
`stop`	Close or detach the managed session.	-
`--json`	Return machine-readable session state.	false

bash

xlflow session start --json
xlflow session status --json
xlflow session stop --json

TIP

Use sessions for fast AI-agent loops: push --session --no-save, run --session, inspect results, then save --session.

WARNING

A dirty session may report save_required. That warning means disk does not yet contain the live workbook changes.

Successful --json output uses the xlflow envelope plus command-specific fields.

json

{
  "status": "ok",
  "command": "session status",
  "session": { "name": "default", "running": true, "dirty": false }
}