@formaggio-software/rhtop 0.0.6 → 1.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.txt +23 -10
- package/README.md +264 -39
- package/package.json +6 -6
package/LICENSE.txt
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
rhtop Binary-Use License
|
|
2
|
-
Version 1.
|
|
2
|
+
Version 1.1 — November 21, 2026
|
|
3
3
|
Copyright (c) 2026 Formaggio LLC. All rights reserved.
|
|
4
4
|
|
|
5
5
|
1. Agreement and scope
|
|
@@ -8,14 +8,17 @@ rhtop ("you"). By installing or using the proprietary rhtop executable, you
|
|
|
8
8
|
accept these terms. If you do not agree, do not use it and delete your copies.
|
|
9
9
|
This license covers executable distributions and accompanying proprietary
|
|
10
10
|
materials, not the application source code. Downloading a release does
|
|
11
|
-
not purchase a subscription or grant
|
|
11
|
+
not purchase a subscription or grant unpaid access to paid features.
|
|
12
12
|
|
|
13
13
|
2. License grant
|
|
14
|
-
While you have an active, paid rhtop subscription
|
|
14
|
+
While you have an active, paid rhtop subscription or access through an active,
|
|
15
|
+
paid rhtop organization plan, Formaggio grants you a limited,
|
|
15
16
|
nonexclusive, nontransferable license to install and run the official executable
|
|
16
17
|
on devices you own or control, solely for your own personal or internal business
|
|
17
18
|
use. There is no device-count limit, but each individual user needs their own
|
|
18
|
-
subscription
|
|
19
|
+
subscription or access through that organization's plan. You may also install
|
|
20
|
+
and run the offline demo without a paid subscription; demo access does not grant
|
|
21
|
+
live brokerage features. You may keep reasonable backup copies. You remain responsible for
|
|
19
22
|
securing your devices, subscription account, and broker credentials. Separate
|
|
20
23
|
written terms signed by Formaggio may expressly grant additional rights.
|
|
21
24
|
|
|
@@ -35,9 +38,10 @@ checkout apply to your order. A recurring subscription renews as disclosed at
|
|
|
35
38
|
checkout until canceled. Manage cancellation in your signed-in account's billing
|
|
36
39
|
settings or contact contact@formaggio.software for help. Cancellation stops future
|
|
37
40
|
renewals; you may use rhtop through the end of the paid subscription period.
|
|
38
|
-
After
|
|
39
|
-
|
|
40
|
-
|
|
41
|
+
After paid access ends, stop using paid features unless you have another
|
|
42
|
+
qualifying personal subscription or organization plan. You may retain copies
|
|
43
|
+
for offline demo use and retain exported data without an active subscription.
|
|
44
|
+
Refund requests are considered individually
|
|
41
45
|
through contact@formaggio.software; no refund is promised beyond rights required
|
|
42
46
|
by law or an express offer made at purchase. These terms do not limit mandatory
|
|
43
47
|
withdrawal, refund, or other consumer rights.
|
|
@@ -52,8 +56,15 @@ no access rights to those services. Formaggio is independent of, and is not
|
|
|
52
56
|
endorsed by, Robinhood Markets, Inc.
|
|
53
57
|
|
|
54
58
|
6. Functionality, updates, and financial information
|
|
55
|
-
rhtop is a
|
|
56
|
-
|
|
59
|
+
rhtop is a dashboard with trading and order-cancellation features where supported
|
|
60
|
+
by your plan, account, and broker permissions. User actions can submit equity,
|
|
61
|
+
crypto, and single-leg option orders or request cancellation of open orders
|
|
62
|
+
through Robinhood. A trade button can authorize submission without a separate
|
|
63
|
+
confirmation unless broker alerts require acknowledgement; Robinhood may also
|
|
64
|
+
require approval in its app. Submission does not guarantee execution, a fill
|
|
65
|
+
price, or successful cancellation; an order may fill before cancellation.
|
|
66
|
+
Information may be incomplete, delayed, or inaccurate; verify it and order
|
|
67
|
+
status with your broker before acting.
|
|
57
68
|
rhtop is not investment, tax, or financial advice. No particular return or
|
|
58
69
|
financial outcome is promised. An active subscription permits use of updates
|
|
59
70
|
made available for your plan, but does not guarantee future features, continuous
|
|
@@ -77,7 +88,9 @@ do not apply to fraud, willful misconduct, or liabilities that law does not allo
|
|
|
77
88
|
to be excluded or limited, and do not reduce mandatory consumer remedies.
|
|
78
89
|
|
|
79
90
|
9. Termination
|
|
80
|
-
|
|
91
|
+
Paid-feature rights end when you no longer have qualifying personal or
|
|
92
|
+
organization access; the offline demo grant continues unless terminated.
|
|
93
|
+
Formaggio may terminate this license
|
|
81
94
|
for a material breach that remains uncorrected thirty days after notice to your
|
|
82
95
|
subscription email address; it may suspend use immediately where necessary to
|
|
83
96
|
address unlawful activity or a security threat. On termination, stop using the
|
package/README.md
CHANGED
|
@@ -1,24 +1,58 @@
|
|
|
1
1
|
# rhtop
|
|
2
2
|
|
|
3
|
-
A
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
A minimal Robinhood MCP terminal dashboard for macOS, Linux, and
|
|
4
|
+
Windows, inspired by [btop](https://github.com/aristocratos/btop),
|
|
5
|
+
[htop](https://htop.dev/), and [lazygit](https://github.com/jesseduffield/lazygit).
|
|
6
|
+
View accounts, positions, orders, assets, and watchlists. Supported versions
|
|
7
|
+
support one-click market Buy, Sell, and Close controls on MCP-enabled accounts.
|
|
8
|
+
Use the Orders panel’s Cancel action to request cancellation of an open equity,
|
|
9
|
+
option, or crypto order after confirmation.
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
┌─ Overview ────┐ ┌─ Positions ─────────────────┐ ┌─ Assets & Watchlists─┐
|
|
13
|
+
│ │ │ Symbol Asset Qty Value │ │ Crypto ▾ │
|
|
14
|
+
│ Account *** │ │ AAPL equity *** *** │ │ Search / filter │
|
|
15
|
+
│ Portfolio *** │ │ BTC crypto *** *** │ │ BTC-USD · Bitcoin │
|
|
16
|
+
│ Cash *** │ └─────────────────────────────┘ │ ETH-USD · Ethereum │
|
|
17
|
+
│ Buying power │ ┌─ Orders ────────────────────┐ │ DEMO-USD … 🚫 ALL │
|
|
18
|
+
│ *** │ │ Symbol Side State Qty │ │ │
|
|
19
|
+
│ │ │ AAPL buy queued *** │ │ Recent selections │
|
|
20
|
+
└───────────────┘ └─────────────────────────────┘ └──────────────────────┘
|
|
21
|
+
q Quit m Mask r Refresh p Pause a Account / Filter l Layout ? Help
|
|
22
|
+
```
|
|
6
23
|
|
|
7
24
|
This repository contains documentation and binary downloads for rhtop,
|
|
8
25
|
proprietary, paid software owned by Formaggio LLC.
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
and third-party notices supplied with your download.
|
|
26
|
+
Keep the proprietary and third-party notices supplied with your download. See
|
|
27
|
+
[rhtop.dev](https://rhtop.dev) for product, subscription, and account information.
|
|
12
28
|
|
|
13
29
|
## Installation
|
|
14
30
|
|
|
15
31
|
Find versioned downloads, checksums, and platform support in
|
|
16
32
|
[Releases](https://github.com/formaggio-software/rhtop/releases).
|
|
17
33
|
|
|
34
|
+
```sh
|
|
35
|
+
pipx install rhtop
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
sudo apt install rhtop
|
|
40
|
+
```
|
|
41
|
+
|
|
18
42
|
```sh
|
|
19
43
|
brew install formaggio-software/tap/rhtop
|
|
20
44
|
```
|
|
21
45
|
|
|
46
|
+
```sh
|
|
47
|
+
choco install rhtop
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
```sh
|
|
51
|
+
npm install -g @formaggio-software/rhtop
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
More info: [INSTALLERS.md](INSTALLERS.md)
|
|
55
|
+
|
|
22
56
|
For Debian/Ubuntu, follow [signed APT setup](https://github.com/formaggio-software/apt-repo#install).
|
|
23
57
|
PyPI, npm, and Chocolatey install commands are documented in
|
|
24
58
|
[INSTALLERS.md](INSTALLERS.md). Windows assets use a native Windows build.
|
|
@@ -27,7 +61,7 @@ is unsupported. Windows amd64 builds target a modern Windows console;
|
|
|
27
61
|
supported minimum Windows and macOS versions are recorded per release.
|
|
28
62
|
Python is bundled; no Python installation is needed.
|
|
29
63
|
|
|
30
|
-
For manual installation, choose the matching asset from Releases
|
|
64
|
+
For manual installation, choose the matching asset from Releases.
|
|
31
65
|
|
|
32
66
|
| System | Archive name (example version) |
|
|
33
67
|
| --- | --- |
|
|
@@ -36,12 +70,10 @@ For manual installation, choose the matching asset from Releases:
|
|
|
36
70
|
| Linux ARM64 | `rhtop-v0.1.0-linux-arm64.tar.gz` |
|
|
37
71
|
| Windows x86-64 | `rhtop-v0.1.0-windows-amd64.zip` |
|
|
38
72
|
|
|
39
|
-
Download
|
|
40
|
-
`
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
`shasum -a 256 --check SHA256SUMS-darwin-universal2` on macOS.
|
|
44
|
-
Then extract into a new directory and install, substituting your asset name:
|
|
73
|
+
Download `SHA256SUMS` from the same release and verify the downloaded archive
|
|
74
|
+
reports `OK` using `sha256sum --ignore-missing --check SHA256SUMS` on Linux or
|
|
75
|
+
`shasum -a 256 --check SHA256SUMS` on macOS (which may also report missing assets).
|
|
76
|
+
Then extract into a new directory and install. Substitute your asset name in the command below.
|
|
45
77
|
|
|
46
78
|
```sh
|
|
47
79
|
mkdir rhtop-download
|
|
@@ -58,39 +90,224 @@ Linux releases also include `rhtop_0.1.0_amd64.deb` and
|
|
|
58
90
|
`sudo apt install ./rhtop_0.1.0_amd64.deb`.
|
|
59
91
|
|
|
60
92
|
On Windows, verify the ZIP checksum in PowerShell with `Get-FileHash -Algorithm
|
|
61
|
-
SHA256 .\rhtop-v0.1.0-windows-amd64.zip`, compare it with
|
|
62
|
-
`SHA256SUMS-windows-amd64`, and extract
|
|
93
|
+
SHA256 .\rhtop-v0.1.0-windows-amd64.zip`, compare it with `SHA256SUMS`, and extract
|
|
63
94
|
using `Expand-Archive`. Run `rhtop.exe --demo` from the extracted directory, or
|
|
64
95
|
use Chocolatey. Keep the notices with the binary.
|
|
65
96
|
|
|
66
|
-
##
|
|
97
|
+
## Connect your own MCP account
|
|
67
98
|
|
|
68
99
|
```sh
|
|
69
|
-
rhtop --demo #
|
|
70
|
-
rhtop login #
|
|
71
|
-
rhtop #
|
|
100
|
+
rhtop --demo # try sample data offline
|
|
101
|
+
rhtop login # sign in, then authorize Robinhood before launching the dashboard
|
|
102
|
+
rhtop # sign in to begin with a qualifying paid plan
|
|
72
103
|
rhtop --help
|
|
73
104
|
```
|
|
74
105
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
106
|
+
Run `rhtop` to begin. Sign in to rhtop with the verification code sent to your
|
|
107
|
+
account email and any required second factor. Official binaries include the
|
|
108
|
+
sign-in configuration; no environment variables or local env files are needed.
|
|
109
|
+
Sign-in is encrypted and remembered securely on this device. `rhtop --demo`
|
|
110
|
+
stays offline and requires no sign-in.
|
|
111
|
+
|
|
112
|
+
Your plan determines access:
|
|
113
|
+
|
|
114
|
+
| Plan | Access |
|
|
115
|
+
| --- | --- |
|
|
116
|
+
| Free or no paid plan | Sign-in/plan screen; run `rhtop --demo` for offline preview |
|
|
117
|
+
| Pro | Live dashboard without charts, scanners, or trading/cancellation controls |
|
|
118
|
+
| Ultra | All live features |
|
|
119
|
+
| Team or Commercial organization | All live features for every member |
|
|
120
|
+
|
|
121
|
+
The highest qualifying personal or organization plan applies. Plans are checked
|
|
122
|
+
on launch and periodically during use. Free plans never open brokerage credentials
|
|
123
|
+
or connect to Robinhood. Paid access becoming free closes the live dashboard;
|
|
124
|
+
run `rhtop` again to return to the sign-in/plan screen. Choose **Check plan**
|
|
125
|
+
after upgrading. Offline demo starts only with `--demo`. The orange
|
|
126
|
+
`rhtop --demo` command on the first screen copies to the clipboard when clicked.
|
|
127
|
+
|
|
128
|
+
To sign out, press **Ctrl+o** in the dashboard or run `rhtop logout`. This removes
|
|
129
|
+
the saved app sign-in on this device and closes any running dashboard. Your
|
|
130
|
+
browser sign-in and Robinhood authorization remain separate; brokerage
|
|
131
|
+
credentials, account selection, and recent assets are retained.
|
|
132
|
+
|
|
133
|
+
With a qualifying paid plan, authorize your own Robinhood MCP connection. The sole active **MCP / Agentic**
|
|
134
|
+
account is selected automatically. Use `a` to explicitly choose among the active
|
|
135
|
+
accounts the connection can read. If the MCP default is ambiguous or missing,
|
|
136
|
+
rhtop asks you to choose an account. rhtop encrypts your selection and restores
|
|
137
|
+
it on restart.
|
|
138
|
+
|
|
139
|
+
**Robinhood OAuth uses a loopback callback.** Open the displayed authorization URL
|
|
140
|
+
manually on the same machine, authorize, and return to the terminal. By default
|
|
141
|
+
the callback listens on `127.0.0.1:8766`. Use `--oauth-port PORT` consistently
|
|
142
|
+
if you need a different port. rhtop leaves browser launch to you.
|
|
143
|
+
|
|
144
|
+
In the authorization dialog, click **Copy URL** or press **Ctrl+y** to copy the
|
|
145
|
+
entire URL. If your terminal cannot paste it, click **Show in terminal** or press
|
|
146
|
+
**Ctrl+t** to temporarily leave
|
|
147
|
+
the dashboard and copy the plain URL with your terminal's normal controls.
|
|
148
|
+
Press Enter to return. The OAuth callback continues listening while you copy.
|
|
149
|
+
Alternatively, run `rhtop login`; after signing in to rhtop, Robinhood authorization
|
|
150
|
+
uses ordinary terminal output. App sign-in does not need a callback port.
|
|
151
|
+
|
|
152
|
+
On a desktop with a secure native keyring, the vault encryption key lives there.
|
|
153
|
+
On headless Linux without a usable keyring, enter a vault passphrase of at least
|
|
154
|
+
12 characters before the UI starts. For unattended startup, supply
|
|
155
|
+
`RHTOP_PASSPHRASE` through your secret manager. rhtop does not load `.env` files or
|
|
156
|
+
accept broker passwords or access tokens as command-line arguments.
|
|
157
|
+
|
|
158
|
+
## Dashboard controls
|
|
80
159
|
|
|
81
160
|
| Key | Action |
|
|
82
161
|
| --- | --- |
|
|
83
|
-
| `
|
|
84
|
-
| `
|
|
85
|
-
| `
|
|
86
|
-
| `
|
|
87
|
-
|
|
|
88
|
-
| `
|
|
89
|
-
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
162
|
+
| `Tab` / `Shift+Tab` | Move focus between panels and controls |
|
|
163
|
+
| Arrows / `j`, `k` | Navigate table rows (arrows also work in asset lists) |
|
|
164
|
+
| `Enter` | Inspect a row or select an asset |
|
|
165
|
+
| `c` / Click Close | Submit a full-position close in Positions |
|
|
166
|
+
| `QTY` / `USD` / `%` in header | Select the global trade sizing mode |
|
|
167
|
+
| Click header amounts / `Ctrl+g` | Edit global Qty, USD, and balance percentage sizes |
|
|
168
|
+
| `m` / `Ctrl+h` | Toggle `***` for personal financial values and identifiers |
|
|
169
|
+
| `/` / `Esc` | Filter account tables / clear filter or close a dialog |
|
|
170
|
+
| `s` / `S` | Cycle sort column / reverse sort direction |
|
|
171
|
+
| Click table header | Sort that column |
|
|
172
|
+
| `a` | Select an active account (MCP / Agentic is the initial default) |
|
|
173
|
+
| `r` | Refresh / retry a failed connection |
|
|
174
|
+
| `p` | Pause / resume automatic account polling and crypto catalog refresh |
|
|
175
|
+
| `1`, `2`, `3`, `4`, `5` | Toggle Overview, Positions, Orders, Assets, Watchlists panels |
|
|
176
|
+
| `l` | Cycle classic, mirrored, and stacked layouts |
|
|
177
|
+
| `?` | Show keyboard help |
|
|
178
|
+
| `q` / `Ctrl+c` / `Ctrl+q` | Quit (`Ctrl+c` and `Ctrl+q` also work inside inputs and dialogs) |
|
|
179
|
+
| `Ctrl+o` | Sign out of rhtop on this device and quit |
|
|
180
|
+
|
|
181
|
+
Text inputs consume normal character keys while you type. Use Tab to leave an
|
|
182
|
+
input before using the single-character dashboard shortcuts. `Ctrl+h` toggles
|
|
183
|
+
privacy while an input has focus. At least one panel stays visible.
|
|
184
|
+
Click the `ACCOUNT` label in Overview to open the same account selector as `a`.
|
|
185
|
+
Click the green Account ID value to copy the full ID to the clipboard, including
|
|
186
|
+
when it is displayed as `***`.
|
|
187
|
+
|
|
188
|
+
Privacy starts **on at every launch**. Revealing values is session-only. Masking
|
|
189
|
+
covers balances, account numbers, quantities, cost basis, position value/P&L,
|
|
190
|
+
order prices and IDs, and IDs in asset detail dialogs. Public market symbols,
|
|
191
|
+
option contract descriptions (including strikes), names, sides, order states,
|
|
192
|
+
timestamps, row counts, and saved asset titles remain visible.
|
|
193
|
+
|
|
194
|
+
The classic layout puts the Overview column on the left, positions/orders in the
|
|
195
|
+
middle, and assets on the right. Press `l` once for the mirrored layout, with
|
|
196
|
+
Overview above Assets on the right and Positions above Orders on the left.
|
|
197
|
+
Press `l` again for the stacked layout, and again to return to classic.
|
|
198
|
+
Narrow terminals adapt the layout and allow scrolling. A terminal of at least
|
|
199
|
+
140×32 is recommended for the full five-panel view. Watchlists appears to the
|
|
200
|
+
right of Assets on wide terminals and below the other panels on narrow ones.
|
|
201
|
+
Press `5` to toggle it. Choose a watchlist to read its symbols and asset types.
|
|
202
|
+
`r` refreshes it along with the dashboard. Custom and followed curated lists are
|
|
203
|
+
supported. Options lists show single-leg contracts through the dedicated MCP
|
|
204
|
+
options watchlist reader. Watchlists cannot be edited in rhtop.
|
|
205
|
+
|
|
206
|
+
Hover over the connection status in the header for the last successful update
|
|
207
|
+
time and full notices.
|
|
208
|
+
A live clock with the machine's local timezone sits at the far right and continues
|
|
209
|
+
ticking while account polling is paused or disconnected.
|
|
210
|
+
On supported Unix terminals, rhtop uses the standard arrow pointer and restores
|
|
211
|
+
the previous pointer when you exit or show the authorization URL in the terminal.
|
|
212
|
+
|
|
213
|
+
## Quick market trades
|
|
214
|
+
|
|
215
|
+
Positions, Scanners, Assets, and Watchlists offer **Buy**, **Sell**, and **Close**
|
|
216
|
+
row controls. The Asset Chart repeats them to the right of its session-price
|
|
217
|
+
row. All use the selected account and the global **QTY|USD|%** control in the top
|
|
218
|
+
header. Click a mode to select it. Click **Qty MIN** or **USD MIN**, or press
|
|
219
|
+
**Ctrl+g**, to edit Qty, USD, and balance percentage together; Apply saves them, and Cancel keeps
|
|
220
|
+
the previous values. Use **MIN** for asset-specific minimums or enter a positive
|
|
221
|
+
exact amount. Mode, both amounts, and the percentage are saved independently. Custom amounts
|
|
222
|
+
that violate an asset's minimum, increment, fractional-share eligibility, or
|
|
223
|
+
whole-contract requirement disable Buy/Sell rather than being silently resized.
|
|
224
|
+
Close always uses the full position. Buttons show the amount they will submit.
|
|
225
|
+
On narrow terminals, sizing occupies a second header row.
|
|
226
|
+
|
|
227
|
+
**%** mode uses **0.1%–20.0% of the selected account’s total value**, in **0.1% steps**
|
|
228
|
+
(default 0.1%). Use the −/+ buttons in the size editor or type the percentage.
|
|
229
|
+
The derived USD amount is rounded down to cents and shown on Buy/Sell. It uses
|
|
230
|
+
total portfolio value, including invested holdings, rather than cash or buying
|
|
231
|
+
power. The displayed amount is locked when clicked; a balance decrease that
|
|
232
|
+
would exceed the selected percentage stops submission. Normal asset minimums,
|
|
233
|
+
available holdings, buying power checks, and broker approvals still apply.
|
|
234
|
+
Options do not support USD orders, so their percentage Buy/Sell actions are
|
|
235
|
+
disabled. Close always uses the full position, regardless of percentage sizing.
|
|
236
|
+
|
|
237
|
+
Assets and recent-asset rows always put trade buttons on a second line, including
|
|
238
|
+
when Watchlists is hidden.
|
|
239
|
+
|
|
240
|
+
With MIN selected, Qty mode uses one equity share or option contract; crypto uses the pair's live
|
|
241
|
+
minimum size/increment, rounded up if needed to meet its minimum notional.
|
|
242
|
+
With MIN selected, USD mode uses $1 for fractionally tradable equities and the pair's minimum USD
|
|
243
|
+
amount for crypto. Options do not accept USD market orders. Missing constraints,
|
|
244
|
+
unsupported instruments, halted assets, masked/stale data, insufficient unreserved
|
|
245
|
+
holdings, or unavailable MCP permissions disable the corresponding action.
|
|
246
|
+
Sell reduces an existing position; new short positions are not opened. Buy covers
|
|
247
|
+
short option holdings; Close uses the full unreserved position independently of
|
|
248
|
+
Qty/USD/% mode. Discovery rows match held options by contract ID, never ticker alone.
|
|
249
|
+
|
|
250
|
+
One click authorizes the displayed market order. rhtop refreshes permissions and
|
|
251
|
+
holdings and obtains a broker review before submitting. Broker alerts require
|
|
252
|
+
acknowledgement; Robinhood may separately require approval in its app. Equity and
|
|
253
|
+
option market orders use regular hours and good-for-day duration, and can queue
|
|
254
|
+
outside regular hours. Crypto orders use good-till-cancelled duration. Prices are
|
|
255
|
+
not guaranteed, and submission does not mean a fill. Default broker cost basis
|
|
256
|
+
applies. Uncertain submissions lock that instrument for the session: inspect
|
|
257
|
+
Robinhood orders and pending approvals before restarting trading. Orders are never
|
|
258
|
+
automatically retried.
|
|
259
|
+
|
|
260
|
+
## Asset browser
|
|
261
|
+
|
|
262
|
+
The right-hand picker **defaults to Crypto on every launch**. To change the
|
|
263
|
+
category with the keyboard, focus the dropdown, press Enter, choose with the
|
|
264
|
+
arrow keys, then press Enter again. Select an asset row to see its full details.
|
|
265
|
+
|
|
266
|
+
* **Crypto** shows supported pairs from all catalog pages. Halted pairs are
|
|
267
|
+
retained and their titles end in
|
|
268
|
+
`🚫` followed by space-separated regions, such as `🚫 NY TX` (`🚫 ALL` for a
|
|
269
|
+
global halt, or just `🚫` when regions are unavailable). A regional halt can be one-sided.
|
|
270
|
+
Enter a name or symbol in the search field to filter the catalog. The catalog
|
|
271
|
+
refreshes alongside automatic polling and on `r`.
|
|
272
|
+
* For **equities**, enter a company name or ticker and press Enter. Select a result
|
|
273
|
+
to inspect it and save it to recent selections.
|
|
274
|
+
* For **options**, search for a company or ticker, select an underlying, then
|
|
275
|
+
select a contract to inspect and save it. To narrow a large chain, search
|
|
276
|
+
directly using `AAPL 2026-12-18 call 250` (expiry, right, and strike are optional).
|
|
277
|
+
rhtop displays up to 500 contracts per lookup and tells you when results are
|
|
278
|
+
truncated.
|
|
279
|
+
|
|
280
|
+
The most recent **30 equities and 30 option contracts** are deduplicated and
|
|
281
|
+
restored on restart. Search again to refresh a saved contract's status. Live
|
|
282
|
+
recents are encrypted in the same vault as the saved account selection. Offline
|
|
283
|
+
demo recents use a private `demo-recents.json` file.
|
|
284
|
+
|
|
285
|
+
## Settings and data
|
|
286
|
+
|
|
287
|
+
`rhtop paths` prints the local paths. On Linux the defaults are
|
|
288
|
+
`~/.config/rhtop/settings.json` and `~/.local/share/rhtop/` for the vault.
|
|
289
|
+
The standard XDG directory variables are respected.
|
|
290
|
+
|
|
291
|
+
Non-secret settings (layout, panels, poll interval, sort direction) are saved
|
|
292
|
+
atomically. On Unix, settings use mode `0600` and new app directories use
|
|
293
|
+
`0700`. Polling defaults to 30 seconds, configurable with
|
|
294
|
+
`rhtop --poll-seconds 60` (10–3600).
|
|
295
|
+
The local vault encrypts credentials, your selected account, and recent assets
|
|
296
|
+
from live sessions.
|
|
297
|
+
No account snapshots, response bodies, or portfolio history are written to disk.
|
|
298
|
+
|
|
299
|
+
`rhtop auth-reset` removes the local vault for the selected callback port,
|
|
300
|
+
including its saved account and asset recents. It does not revoke Robinhood-side
|
|
301
|
+
authorization. Use Robinhood's connection controls for revocation.
|
|
302
|
+
|
|
303
|
+
Unknown values show `—`. Values and P&L are displayed only when supplied by the
|
|
304
|
+
broker. The status bar reports failures in optional sections. Paginated account positions
|
|
305
|
+
or orders are marked **partial (first page)**. A failed core refresh keeps the
|
|
306
|
+
last successful snapshot with a **STALE** notice. Retries back off to 60 seconds.
|
|
307
|
+
Crypto catalogs are never silently presented as complete after truncation or a
|
|
308
|
+
pagination failure.
|
|
309
|
+
|
|
310
|
+
## Support
|
|
94
311
|
|
|
95
312
|
Report installation issues with version, OS, architecture, and sanitized error
|
|
96
313
|
text. Never attach tokens, authorization URLs, vault files, or unmasked account
|
|
@@ -99,12 +316,20 @@ For private support, purchase questions, or security reports, email
|
|
|
99
316
|
[contact@formaggio.software](mailto:contact@formaggio.software).
|
|
100
317
|
rhtop is independent of and not endorsed by Robinhood.
|
|
101
318
|
|
|
102
|
-
|
|
319
|
+
Live binary use requires a qualifying paid personal subscription or organization
|
|
320
|
+
plan under [LICENSE.txt](LICENSE.txt). The offline demo requires no paid subscription.
|
|
103
321
|
Read the same agreement at https://rhtop.dev/terms/ before subscribing.
|
|
104
322
|
|
|
105
323
|
## Binary-use license
|
|
106
324
|
|
|
107
325
|
Read [LICENSE.txt](LICENSE.txt) or the [published terms](https://rhtop.dev/terms/)
|
|
108
|
-
before subscribing or using rhtop.
|
|
109
|
-
on their devices for the paid period,
|
|
110
|
-
|
|
326
|
+
before subscribing or using rhtop. Paid access covers a personal subscriber or
|
|
327
|
+
users covered by a paid organization plan on their devices for the paid period,
|
|
328
|
+
including the remainder after cancellation. Public downloads permit offline demo
|
|
329
|
+
use under the license; live access requires a qualifying paid plan.
|
|
330
|
+
Redistribution requires written permission.
|
|
331
|
+
|
|
332
|
+
Positions include a sortable **Asset Price** column: the latest regular or
|
|
333
|
+
extended-hours equity trade, or the mark price for options and crypto. Quotes
|
|
334
|
+
refresh with account polling; unavailable prices show `—`. Prices follow the
|
|
335
|
+
financial-value masking control.
|
package/package.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "
|
|
2
|
+
"version": "1.1.2",
|
|
3
3
|
"license": "UNLICENSED",
|
|
4
4
|
"repository": "https://github.com/formaggio-software/rhtop",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
7
7
|
},
|
|
8
8
|
"name": "@formaggio-software/rhtop",
|
|
9
|
-
"description": "
|
|
9
|
+
"description": "Robinhood MCP dashboard",
|
|
10
10
|
"bin": {
|
|
11
11
|
"rhtop": "bin/rhtop.js"
|
|
12
12
|
},
|
|
@@ -28,9 +28,9 @@
|
|
|
28
28
|
"arm64"
|
|
29
29
|
],
|
|
30
30
|
"optionalDependencies": {
|
|
31
|
-
"@formaggio-software/rhtop-darwin-universal2": "
|
|
32
|
-
"@formaggio-software/rhtop-linux-arm64": "
|
|
33
|
-
"@formaggio-software/rhtop-linux-amd64": "
|
|
34
|
-
"@formaggio-software/rhtop-windows-amd64": "
|
|
31
|
+
"@formaggio-software/rhtop-darwin-universal2": "1.1.2",
|
|
32
|
+
"@formaggio-software/rhtop-linux-arm64": "1.1.2",
|
|
33
|
+
"@formaggio-software/rhtop-linux-amd64": "1.1.2",
|
|
34
|
+
"@formaggio-software/rhtop-windows-amd64": "1.1.2"
|
|
35
35
|
}
|
|
36
36
|
}
|