Get started
v0.0.4
Quickstart
Open Plous, find a Pod, and read its logs from your terminal.
Install and launch
Use Homebrew on macOS or Linux with a working kubeconfig. See Installation and updates for other install methods.
Shell command
brew install simjay/tap/plous plous
Use a terminal at least 80 columns wide and 16 rows tall.
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.

Local Kubernetes test fixture
Learn the basic controls
Use Alt+Right to move to the next visible panel and Alt+Left to move back.
Choose a workspace or resource type.
Browse resources and open details.
Chat with the selected agent.
Key
Action
Up / Down, Enter
Select and open an item
/
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.
On this page