From cd4cf5eb106c1e5bdb942edf8e2513010d536855 Mon Sep 17 00:00:00 2001 From: rajashidattapy Date: Tue, 4 Aug 2026 16:16:18 +0530 Subject: [PATCH] docs: add 'plain' output format for hackernews command --- docs/cli-reference.mdx | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/cli-reference.mdx b/docs/cli-reference.mdx index 4073a61d..5ab4409a 100644 --- a/docs/cli-reference.mdx +++ b/docs/cli-reference.mdx @@ -77,12 +77,15 @@ The old `web read` command has been renamed to `web fetch-browser`. ```bash webcmd hackernews top -f table +webcmd hackernews top -f plain webcmd hackernews top -f json webcmd hackernews top -f yaml webcmd hackernews top -f md webcmd hackernews top -f csv ``` +`plain` prints `key: value` lines instead of a table, and prints the bare value when a command returns a single field named `response`, `content`, `markdown`, `text`, or `value`. It suits chat-style commands. `yml` and `markdown` are accepted aliases for `yaml` and `md`. + Agents should use JSON unless they are presenting output to a human. ## Global Flags