Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ilyama.golain.io/llms.txt

Use this file to discover all available pages before exploring further.

Requires Go 1.25+ and the ilyama repository. 
git clone https://github.com/golain-io/ilyama.git
cd ilyama

# Build binary → tools/platform-tui/dist/platform-tui
make platform-tui-build

# Add to PATH (optional)
sudo ln -sf "$(pwd)/tools/platform-tui/dist/platform-tui" /usr/local/bin/platform-tui

​
Run without installing

cd ilyama
make platform-tui-login   # authenticate
make platform-tui           # launch TUI
Or directly: 
cd ilyama/tools/platform-tui
GOWORK=off go run ./cmd/platform-tui [command]
GOWORK=off avoids the repo workspace replace for the MQTT fork when running from source on machines without third_party/mochi-server/.

​
Verify

platform-tui version
platform-tui whoami

​
Shell completions

# bash
source <(platform-tui completions bash)

# zsh
platform-tui completions zsh | source

# fish
platform-tui completions fish | source

​
CI and version stamping

Production builds inject version via ldflags: 
go build -ldflags "-X golain.io/tools/platform-tui/internal/cli.Version=v1.2.3" \
  -o dist/platform-tui ./cmd/platform-tui
The Makefile platform-tui-build target uses git tags in CI.

​
Regenerate API types

If the OpenAPI spec changes: 
make platform-tui-gen
make platform-tui-build
Requires oapi-codegen v2 and Python 3.

​
Next step

→ Login and authentication