From 570439369e3a7e0fa5c82777e4ea28afbe0cac71 Mon Sep 17 00:00:00 2001
From: hermes <hermes@rasyidanaf.com>
Date: Fri, 23 Oct 2026 07:15:24 +0000
Subject: [PATCH] docs(web): Stockbit intraday on the quickstart, landing page
 and agent notes

---
 web/astro.config.mjs                     | 2 +-
 web/src/content/docs/agents/index.md     | 6 +++++-
 web/src/content/docs/start/quickstart.md | 1 +
 web/src/pages/index.astro                | 4 ++--
 4 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/web/astro.config.mjs b/web/astro.config.mjs
index c745c23..5a07446 100644
--- a/web/astro.config.mjs
+++ b/web/astro.config.mjs
@@ -56,7 +56,7 @@ export default defineConfig({
 					projectName: 'idx-cli',
 					details: [
 						'- `idx` is a CLI; `idx-mcp` is an MCP server over the same library. Both read the same config, cache and ownership database.',
-						'- Output is JSON whenever stdout is not a terminal. Errors are one JSON object on stderr; exit codes: 2 invalid input, 3 not found, 4 upstream unavailable, 5 unsupported, 1 other.',
+						'- Output is JSON whenever stdout is not a terminal. Errors are one JSON object on stderr; exit codes: 2 invalid input, 3 not found, 4 upstream unavailable or blocked, 5 unsupported, 1 other.',
 						'- Every page is also available as Markdown by appending `.md` to its path, for example `/agents/install.md`.',
 					].join('\n'),
 				}),
diff --git a/web/src/content/docs/agents/index.md b/web/src/content/docs/agents/index.md
index 6e4a460..78f4470 100644
--- a/web/src/content/docs/agents/index.md
+++ b/web/src/content/docs/agents/index.md
@@ -19,10 +19,14 @@ What an agent needs to know:
 - On failure stdout is empty and stderr holds one JSON object,
   `{"error": true, "code": "...", "message": "..."}`.
 - Exit codes say what to do next: `2` fix the input, `3` not found (or no
-  cached data offline), `4` provider unavailable, retry later, `5`
+  cached data offline), `4` provider unavailable or blocked, retry later, `5`
   unsupported, `1` other.
 - Tickers are IDX codes (`BBCA`); `.JK` is optional. Several tickers can be
   passed at once to `stocks quote` and `stocks compare`.
+- `stocks intraday` and `--provider stockbit` read Stockbit's public page,
+  paced to one request a second across idx processes. Ask for the symbols
+  you need rather than looping over the market; on `UPSTREAMBLOCKED`, stop
+  instead of retrying.
 - Ownership queries need `idx ownership sync` once; after that they run
   offline. `idx -o json ownership releases` shows which months exist.
 
diff --git a/web/src/content/docs/start/quickstart.md b/web/src/content/docs/start/quickstart.md
index 6a85719..33ebefe 100644
--- a/web/src/content/docs/start/quickstart.md
+++ b/web/src/content/docs/start/quickstart.md
@@ -11,6 +11,7 @@ Tickers are IDX codes; the `.JK` suffix is optional.
 idx stocks quote BBCA                 # one quote
 idx stocks quote BBCA BBRI BMRI       # several (spaces or commas)
 idx stocks history BBCA --period 1y   # daily OHLCV
+idx stocks intraday BBCA              # today by the minute (Stockbit)
 idx stocks technical BBCA             # trend, RSI, MACD, moving averages
 idx stocks fundamental BBCA           # growth, valuation and risk together
 idx stocks compare BBCA BBRI BMRI     # fundamentals side by side
diff --git a/web/src/pages/index.astro b/web/src/pages/index.astro
index 2d07090..63e55f9 100644
--- a/web/src/pages/index.astro
+++ b/web/src/pages/index.astro
@@ -127,7 +127,7 @@ TLKM.JK   2,250   <span class="up">+0.45%</span>   87,159,900
 					<div>
 						<svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" aria-hidden="true"><path d="M3 17l6-6 4 4 8-8"></path><path d="M15 7h6v6"></path></svg>
 						<h2>Stocks</h2>
-						<p>Quotes, OHLC history, financial statements and a screener. Technical, growth, valuation and risk analysis, and side-by-side compare.</p>
+						<p>Quotes, today's session by the minute, OHLC history, financial statements and a screener. Technical, growth, valuation and risk analysis, and side-by-side compare.</p>
 						<code>idx stocks fundamental BBRI</code>
 					</div>
 					<div>
@@ -219,7 +219,7 @@ TLKM.JK   2,250   <span class="up">+0.45%</span>   87,159,900
 					<dl class="codes">
 						<dt>2</dt><dd>invalid input or config</dd>
 						<dt>3</dt><dd>not found, or no cached data offline</dd>
-						<dt>4</dt><dd>upstream unavailable, retry later</dd>
+						<dt>4</dt><dd>upstream unavailable or blocked, retry later</dd>
 						<dt>5</dt><dd>unsupported</dd>
 					</dl>
 				</div>