Elements
bl keyboard
Control text and held keys at the current focus (no selector)
Control text and held keys at the current focus (no selector)
Usage
bl keyboard [OPTIONS]
bl keyboard <command>Options
| Option | Description |
|---|---|
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
bl keyboard type
Type text at the current focus, generating key events
Usage
bl keyboard type <text> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<text> | Text to type |
Options
| Option | Description |
|---|---|
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
Examples
bl keyboard type "hello world"
# Type into the focused elementbl keyboard inserttext
Insert text at the current focus WITHOUT key events (IME/paste-like)
Usage
bl keyboard inserttext <text> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<text> | Text to insert |
Options
| Option | Description |
|---|---|
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
Examples
bl keyboard inserttext "héllo"
# Insert without keydown/keyup eventsbl keyboard down
Press and hold a key (no release; pair with keyboard up)
Usage
bl keyboard down <key> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<key> | Key to hold down (e.g., Shift, Control, a) |
Options
| Option | Description |
|---|---|
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
Examples
bl keyboard down Shift
# Hold Shift down (then type or press, then run keyboard up Shift)bl keyboard up
Release a held key (pair with keyboard down)
Usage
bl keyboard up <key> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<key> | Key to release (e.g., Shift, Control, a) |
Options
| Option | Description |
|---|---|
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
Examples
bl keyboard up Shift
# Release a held Shift