Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <command> [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.
Expand Down
9 changes: 6 additions & 3 deletions docs/basic-usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 @→ /
Expand All @@ -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 <name>` switches directly. Themes: `aiograpi` (default), `amber`, `claude`, `cyberpunk`, `hacker`, `instagram`.

`/exit`, `/quit`, or `Ctrl+D` to leave.

Expand Down
10 changes: 6 additions & 4 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <command> [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.
Expand Down
Loading