Device SSH CLI overview

golain-cli is a focused CLI for operators who need quick device list and SSH access through Golain’s MQTT bridge. It lives in golain-io/golain-cli.

This is not the same tool as golain (platform CLI/TUI from ilyama). For fleet management, Omega deploy, and edge sync governance, use golain.

When to use it

Use golain-cli (this tool)	Use golain instead
SSH into a named device	Full fleet CRUD, OTA, integrations
Quick device status check	JSON/CI automation
Field technician laptop	TUI data explorer, edge sync, Omega scaffold

Typical session

golain login
golain set --org-id=YOUR_ORG --project-id=YOUR_PROJECT --fleet-id=YOUR_FLEET
golain devices
golain ssh "sensor-01"

Commands at a glance

Command	Purpose
`golain login`	OAuth2 browser login (Zitadel)
`golain set`	Default org, project, fleet IDs
`golain devices`	List fleet devices with status
`golain device <name>`	Device detail and monitoring
`golain ssh <name>`	Interactive shell via MQTT bridge
`golain config`	Show saved configuration

Global flag: -c, --config for alternate config file path.

Requirements on device

SSH requires Omega (or compatible edge client) with:

RPC and SSH modules enabled
security.capabilities allowing remote shell
Device online and authenticated to MQTT

Configure edge capabilities in Omega configure.

Install

Build and install golain-cli.

Commands

Full command reference.

Install Golain CLIBuild golain-cli from source.

​When to use it

​Typical session

​Commands at a glance

​Requirements on device

Install

Commands

When to use it

Typical session

Commands at a glance

Requirements on device