From bb8e4cc5d628f29241bbd49875b6aa5a0c061950 Mon Sep 17 00:00:00 2001 From: subzeroid <143403577+subzeroid@users.noreply.github.com> Date: Thu, 28 May 2026 03:08:22 +0300 Subject: [PATCH] docs: actualize REPL docs for startup target, themes, picker, shortcuts Bring the prose docs in line with what shipped this cycle: - `insto @user` pre-selects the REPL target on launch (README, index, basic-usage). - Six colour themes + the live-preview `/theme` picker (README, index, basic-usage). - Full REPL shortcut set (Ctrl+T/L/C) and that `/help` is grouped by category (basic-usage). cli-reference.md already carries the per-command `/theme` + shortcut tables. Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 8 +++++--- docs/basic-usage.md | 9 ++++++--- docs/index.md | 10 ++++++---- 3 files changed, 17 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 755935b..05f6100 100644 --- a/README.md +++ b/README.md @@ -14,9 +14,11 @@ Interactive Instagram OSINT CLI on the [HikerAPI](https://hikerapi.com/p/6k1q138 Two surfaces over the same command grammar: -- **REPL** — `insto` drops you into a prompt-toolkit session with tab-completion, - a bottom toolbar (active target, backend, quota), and live `/watch` - notifications. Visually similar to the Claude Code welcome screen. +- **REPL** — `insto` (or `insto @user` to pre-select a target) drops you into a + prompt-toolkit session with tab-completion, a bottom toolbar (active target, + backend, quota), six switchable colour themes (`/theme` opens a live-preview + picker), and live `/watch` notifications. Visually similar to the Claude Code + welcome screen. - **One-shot** — `insto @user -c [args]` runs a single slash-command and exits. Pipe-friendly: `--json -` writes to stdout, `--csv -` does the same for flat commands, `/batch -` reads targets from stdin. diff --git a/docs/basic-usage.md b/docs/basic-usage.md index d98bd22..1d5c220 100644 --- a/docs/basic-usage.md +++ b/docs/basic-usage.md @@ -5,10 +5,11 @@ Two surfaces, same command grammar. Anything you can do in the REPL you can do a ## REPL ```sh -insto +insto # REPL +insto @instagram # REPL with @instagram pre-selected as the target ``` -You land in a prompt with a welcome panel (INSTO logotype + tips + recent activity + live HikerAPI balance) and a bottom toolbar showing the current target, backend, and remaining requests. +You land in a prompt with a welcome panel (INSTO logotype + tips + shortcuts + recent activity + live HikerAPI balance) and a bottom toolbar showing the current target, backend, and remaining requests. Launching with `insto @user` pre-selects the target (shown in the banner + the `insto @user>` prompt); the pk resolves on first use. ```text insto @→ / @@ -30,7 +31,9 @@ Any single-target command also accepts an inline username — does NOT mutate th /info nasa # one-off lookup, target stays at @instagram ``` -`Ctrl+T` flashes the active target. `Ctrl+L` redraws the welcome banner. Up-arrow walks history; `Ctrl+R` is incremental search. +`Ctrl+T` flashes the active target. `Ctrl+L` redraws the welcome banner. `Ctrl+C` cancels the current line. Up-arrow walks history; `Ctrl+R` is incremental search. These shortcuts are also listed in the welcome banner. + +`/help` lists every command grouped by category. `/theme` (with no name) opens an interactive picker — `↑`/`↓` live-preview each theme on the banner, Enter applies; `/theme ` switches directly. Themes: `aiograpi` (default), `amber`, `claude`, `cyberpunk`, `hacker`, `instagram`. `/exit`, `/quit`, or `Ctrl+D` to leave. diff --git a/docs/index.md b/docs/index.md index 7e30892..4c43c09 100644 --- a/docs/index.md +++ b/docs/index.md @@ -13,10 +13,12 @@ insto -c info instagram # one-shot lookup, no REPL Two surfaces over the same command grammar: -- **REPL** — `insto` drops you into a prompt-toolkit session with a slash popup - for every command (Claude-Code style), a bottom toolbar showing active target - + backend + live HikerAPI balance, Ctrl+T / Ctrl+L keybindings, and live - `/watch` notifications via `patch_stdout`. +- **REPL** — `insto` (or `insto @user` to pre-select a target) drops you into a + prompt-toolkit session with a slash popup for every command (Claude-Code + style), a bottom toolbar showing active target + backend + live HikerAPI + balance, Ctrl+T / Ctrl+L / Ctrl+C keybindings, six switchable colour themes + (`/theme` opens a live-preview picker), and live `/watch` notifications via + `patch_stdout`. - **One-shot** — `insto @user -c [args]` runs a single slash-command and exits. Pipe-friendly: `--json -` writes JSON to stdout, `--csv -` does the same for flat-row commands, `/batch -` reads targets from stdin.