OBSERVE. ANALYZE. ACT.
Support Login

CLI ยท Version 26.2

Display Controls

Control CLI output with paging, screen width, grep filtering, table rendering, and command help.

UI Path: CLI ID: cli-display-controls
Workflow
  1. Use config cli paging or config cli no-paging to control session paging.
  2. Use config cli screen-width to set table width.
  3. Use | more for paged output.
  4. Use | grep to display matching output lines.

Purpose

Use display controls to keep CLI output readable on serial consoles, SSH sessions, and automation logs.

Session Paging

Paging is enabled by default in interactive sessions. Use:

config cli paging
config cli no-paging

to enable or disable paging for the current session.

These settings do not change persistent appliance configuration.

Screen Width

Use:

config cli screen-width <columns>

to set the CLI rendering width for the current session. The accepted range is 40 to 240 columns.

Example:

config cli screen-width 120

This affects table and two-column output rendering.

Post Commands

Post commands are appended after a pipe character. 01sh currently supports one post command per line.

Post command Purpose
` more`
` grep `

Examples:

show system status | more
show interface | grep P29
diag vfabric dump health | grep error

Post commands are supported only on executable commands. They are not supported on help queries, history, clear, logout, or CLI session-setting commands.

Tables And Two-Column Output

01sh formats structured output as tables or two-column field lists. Examples:

System Status
State   : ready
Up time : 1m 08s
Access  : CON, SSH(unknown), HTTP(disabled-until-services-ready), HTTPS(disabled-until-services-ready)

Tables use headers and separator rows:

Name            State  PID    Up time  Restarts  Last Error
--------------  -----  -----  -------  --------  ----------
l01_authsrvd    ready  69074  1m 08s   0         -

Use a wider screen width when table columns wrap or truncate too aggressively.

Help Output

Inline help uses a two-column display:

config                   - Configuration mode
show                     - Show mode
exec                     - Execution mode
diag                     - Diagnostic mode

Use help detail <command-path> for parameter-level documentation.

Error Output

Errors are printed with the error: prefix:

error: server_reason: bcm command failed rc=-2 cmd="fp entry" output="..."

Backend shell passthrough commands such as exec vfabric cmd print returned command text as normal output when the backend classifies it as informational. If a command returns a true error, 01sh includes the backend reason and status.

Command-Line Flags That Affect Display

Flag Purpose
-paging Enable CLI paging at startup. Default is enabled.
-display-cmd-tree Display the resolved command tree and exit.
-brief With -display-cmd-tree, render a brief tree instead of full JSON.
-welcome-message <text> Override the interactive welcome banner.
-debug-workflow Print workflow API request and response data to stderr. Use for troubleshooting only.