Get started
Quickstart
Open Plous and read a Pod's logs. You do not need to configure an AI provider.
Before you begin
You need macOS or Linux, Homebrew, and a working kubeconfig. Use a terminal at least 80 columns wide and 16 rows tall.
Install and launch
sh
brew install simjay/tap/plous plous
Already installed? Run plous . For other installation methods, see Installation and updates.
Start with Current Workspace
Plous opens your current Kubernetes context. Check the context name in the header before continuing.
To choose another context, type :K and press Enter. This changes the selection in Plous without editing your kubeconfig.
If Plous cannot connect, open Settings → Choose Kubeconfig or follow connection troubleshooting.
Inspect your first workload
Press 22 to open Explore.
Type :pods and press Enter.
Press n to choose a namespace.
Select a Pod and press Enter.
Press l to open its logs. Press o to choose another container.
Press Esc to return to the Pod.
Learn the basic controls
Key
Action
Up / Down, Enter
Select and open an item
Alt+Left / Alt+Right
Move between panels
/
Search the current panel
Esc
Close the current search, input, or detail view
hh
Open Help while navigating
ff
Expand or restore the main panel
Use 11 for Overview, 22 for Explore, and 33 for Activity. See the keymap for all controls.
Leave and return
Type :quit and press Enter. Plous saves your settings and conversations.
Next steps
Investigate a restarting Pod in a disposable cluster.
Save a workspace for clusters you use often.
Set up an AI assistant, connect an MCP client, or install plous-debug.