@hyperlogue/r3 2.2.1 → 2.3.1
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/README.md +37 -30
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -14,6 +14,7 @@
|
|
|
14
14
|
</p>
|
|
15
15
|
|
|
16
16
|
r3 is a tool for reading, using, and discussing agent output.
|
|
17
|
+
|
|
17
18
|
Open an interactive page, read a document, or inspect code changes. Select an
|
|
18
19
|
element or passage to leave comments and continue the conversation with your agent.
|
|
19
20
|
|
|
@@ -30,15 +31,17 @@ can run the CLI.
|
|
|
30
31
|
Markdown, and code discussion with a scripted agent. It uses bundled examples;
|
|
31
32
|
production preview protection is not simulated.
|
|
32
33
|
|
|
34
|
+
r3 serves you, a single user, and your agents. Supporting multiple human users is a nongoal.
|
|
35
|
+
|
|
33
36
|
[](https://github.com/user-attachments/assets/26506cba-3d1a-493c-9c7a-e6ae2227718c)
|
|
34
37
|
|
|
35
38
|
## Screenshots
|
|
36
39
|
|
|
37
|
-
| Screenshot
|
|
38
|
-
|
|
|
39
|
-
| [](https://github.com/user-attachments/assets/2dec1368-6679-47cb-aa19-bfeb6228a7d6)
|
|
40
|
-
| [](https://github.com/user-attachments/assets/396df7ca-661e-414d-952b-0a6325638c62) | Learn how a library works internally through an interactive demo.
|
|
41
|
-
| [](https://github.com/user-attachments/assets/8e85f3d9-d03b-45ec-b478-fe7fe109ef19)
|
|
40
|
+
| Screenshot | What it shows |
|
|
41
|
+
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
|
|
42
|
+
| [](https://github.com/user-attachments/assets/2dec1368-6679-47cb-aa19-bfeb6228a7d6) | Review a UI improvement proposal and leave comments directly on HTML elements. |
|
|
43
|
+
| [](https://github.com/user-attachments/assets/396df7ca-661e-414d-952b-0a6325638c62) | Learn how a library works internally through an interactive demo. |
|
|
44
|
+
| [](https://github.com/user-attachments/assets/8e85f3d9-d03b-45ec-b478-fe7fe109ef19) | Codex receives a direct message from r3 when you ping the agent from the web page. |
|
|
42
45
|
|
|
43
46
|
Search your library by project, content, or conversation. Results open the matching
|
|
44
47
|
publication or message, and **Include history** searches older versions. Agents can
|
|
@@ -71,11 +74,11 @@ npx --yes @hyperlogue/r3@latest guide
|
|
|
71
74
|
|
|
72
75
|
r3 supports three kinds of artifacts:
|
|
73
76
|
|
|
74
|
-
| Artifact
|
|
75
|
-
|
|
|
76
|
-
| HTML pages
|
|
77
|
+
| Artifact | What you can do | Examples |
|
|
78
|
+
| ------------------- | ------------------------------------------------------------------------------------ | ----------------------------------------------------------- |
|
|
79
|
+
| HTML pages | Interact with a page and leave comments on specific elements or text | Prototypes, dashboards, interactive tutorials |
|
|
77
80
|
| Documents and files | Read rendered Markdown, browse related files, and discuss specific passages or lines | Design proposals, research reports, generated project files |
|
|
78
|
-
| Code changes
|
|
81
|
+
| Code changes | See what changed and discuss it beside the affected lines | Bug fixes, refactors, feature reviews |
|
|
79
82
|
|
|
80
83
|
HTML artifacts open as pages; files artifacts have a file browser; diff artifacts
|
|
81
84
|
show captured code changes.
|
|
@@ -102,14 +105,24 @@ on the home page to archive or permanently delete them together.
|
|
|
102
105
|
|
|
103
106
|
## Local and remote access
|
|
104
107
|
|
|
105
|
-
|
|
108
|
+
### Local access
|
|
109
|
+
|
|
110
|
+
r3 starts automatically on localhost with no login required. To require local
|
|
111
|
+
authentication:
|
|
112
|
+
|
|
113
|
+
```sh
|
|
114
|
+
r3 config set requireLogin true
|
|
115
|
+
r3 server restart
|
|
116
|
+
r3 auth create-token --label browser
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
Sign in with the printed token. Run `r3 config unset requireLogin` to revert.
|
|
106
120
|
|
|
107
|
-
###
|
|
121
|
+
### Exposing a server
|
|
108
122
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
the **server**, replacing `https://reviews.example` with its Tailscale HTTPS address:
|
|
123
|
+
Remote access always requires authentication and should use HTTPS. To expose via
|
|
124
|
+
[Tailscale Serve](https://tailscale.com/docs/reference/tailscale-cli/serve), run
|
|
125
|
+
on the server:
|
|
113
126
|
|
|
114
127
|
```sh
|
|
115
128
|
r3 config set publicUrl https://reviews.example
|
|
@@ -119,27 +132,21 @@ tailscale serve --bg http://127.0.0.1:8791
|
|
|
119
132
|
r3 auth create-token --label browser
|
|
120
133
|
```
|
|
121
134
|
|
|
122
|
-
Open the
|
|
135
|
+
Open the URL in your browser and sign in with the token. For other reverse
|
|
136
|
+
proxies, forward traffic to `http://127.0.0.1:8791/` with
|
|
137
|
+
`X-Forwarded-Proto: https`.
|
|
123
138
|
|
|
124
|
-
|
|
125
|
-
and set `X-Forwarded-Proto: https`. Set `trustedProxies` to its connection IP only
|
|
126
|
-
if it overwrites `X-Forwarded-For`.
|
|
139
|
+
### Connecting a remote CLI
|
|
127
140
|
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
On your **local machine**, set `backendUrl` to the remote r3 server's HTTPS address:
|
|
141
|
+
To publish to a remote r3 server from your local machine:
|
|
131
142
|
|
|
132
143
|
```sh
|
|
133
144
|
r3 config set backendUrl https://reviews.example
|
|
134
145
|
r3 login
|
|
135
|
-
```
|
|
136
|
-
|
|
137
|
-
Open the printed address, sign in to r3 if needed, confirm that the code matches
|
|
138
|
-
your terminal, and approve CLI access. Then check the connection:
|
|
139
|
-
|
|
140
|
-
```sh
|
|
141
146
|
r3 list
|
|
142
147
|
```
|
|
143
148
|
|
|
144
|
-
|
|
145
|
-
|
|
149
|
+
Approve browser access when prompted. Then ask your agent to run `r3 guide` and
|
|
150
|
+
publish as usual. See the
|
|
151
|
+
[remote backend reference](docs/artifacts/remote-protocol.md) for advanced setup
|
|
152
|
+
and options.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@hyperlogue/r3",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.3.1",
|
|
4
4
|
"description": "Render. Review. Refine. — publish artifacts and discuss them with any coding agent. Runs the matching prebuilt native r3 binary (shipped as a per-platform optional dependency); works with `bunx @hyperlogue/r3` and `npx @hyperlogue/r3`.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -17,10 +17,10 @@
|
|
|
17
17
|
"launch.mjs"
|
|
18
18
|
],
|
|
19
19
|
"optionalDependencies": {
|
|
20
|
-
"@hyperlogue/r3-darwin-arm64": "2.
|
|
21
|
-
"@hyperlogue/r3-darwin-x64": "2.
|
|
22
|
-
"@hyperlogue/r3-linux-x64": "2.
|
|
23
|
-
"@hyperlogue/r3-linux-arm64": "2.
|
|
20
|
+
"@hyperlogue/r3-darwin-arm64": "2.3.1",
|
|
21
|
+
"@hyperlogue/r3-darwin-x64": "2.3.1",
|
|
22
|
+
"@hyperlogue/r3-linux-x64": "2.3.1",
|
|
23
|
+
"@hyperlogue/r3-linux-arm64": "2.3.1"
|
|
24
24
|
},
|
|
25
25
|
"engines": {
|
|
26
26
|
"node": ">=18"
|