release: 0.3.0-beta.1

Ships JSON API rendering (#3) and the AWS, Google Cloud, and Microsoft Learn
documentation shortcuts (#11) to the beta channel.

Documentation caught up with what the code actually does while it was open:

- Status said the remaining actions land in v0.2, which shipped without them.
  fill, submit, and back are now marked planned in the help and the README,
  a label that cannot go stale the way a version number does.
- llms.txt names the cloud documentation shortcuts and the JSON rendering.

The skill keeps its npx pin on 0.2.0. A pin is what agents actually execute,
so it moves when a release is stable, not when it enters beta.

README.md

@@ -63,8 +63,8 @@ oc find <query>        where a string appears on the page already open
 oc read <n>            full text of the region at [n], up to 2000 tokens
 oc next                the next budget worth of the page already open
 oc raw [url]           distilled markdown of the whole page
-oc fill <n> <text>     type into a numbered input               (v0.2)
-oc submit [n]          submit a form                            (v0.2)
+oc fill <n> <text>     type into a numbered input               (planned)
+oc submit [n]          submit a form                            (planned)
 ```
 
 Flags: `--budget <tokens>` (default 500), `--json`, `--html` (raw as cleaned HTML), `--session <name>`, `--verbose`/`-v` (metrics on stderr, or export `OC_VERBOSE=1`).
@@ -107,7 +107,7 @@ Full methodology, per-task numbers, and other agents/models live in [only-cli/be
 
 ## Status
 
-Early. v0.1 covers static pages, budget-aware rendering, and offline tests. Sessions, `oc do <n>`, `oc find <query>`, `oc read <n>`, and `oc next` are in, the rest of the actions (`fill`, `submit`, `back`) land in v0.2, and a lazy headless fallback for script-heavy pages in v0.3.
+Early. Reading works and is covered by offline tests: static pages, XML feeds, JSON APIs, budget-aware rendering, sessions, and the numbered actions `do`, `find`, `read`, `next`, and `raw`. Writing does not: `fill`, `submit`, and `back` report that they are not implemented rather than pretending, and a lazy headless fallback for script-heavy pages comes after them.
 
 Known limits, honestly: no JavaScript rendering yet, no sites behind logins yet, and pages behind hard bot challenges may still refuse the tool.
 

llms.txt

@@ -10,7 +10,7 @@ Key facts:
 - The budget is a target rather than a hard cap: a page that would finish within about four times it is printed whole, because a second command costs the agent far more than the lines the cut would have saved
 - The render leads with the page's main content and puts navigation, sidebar, and footer after it, so the budget is spent on what was asked for rather than on menus
 - Benchmarked at roughly 45x fewer tokens than reading raw HTML, with per-task numbers at https://github.com/only-cli/benchmarks
-- Works on any mostly-static website; tuned shortcuts ship for Hacker News, Reddit, GitHub, X, LinkedIn (public guest views), DuckDuckGo, Bing, Stack Overflow (via its Atom feeds and the Stack Exchange API), and Yahoo Finance (quotes, history, markets)
+- Works on any mostly-static website; tuned shortcuts ship for Hacker News, Reddit, GitHub, X, LinkedIn (public guest views), DuckDuckGo, Bing, Stack Overflow (via its Atom feeds and the Stack Exchange API), Yahoo Finance (quotes, history, markets), and the AWS, Google Cloud, and Microsoft Learn documentation sites (guides, CLI reference, and search)
 - JSON APIs render like pages: an endpoint that answers with JSON becomes one numbered item per record, with the fields that differ between items kept and the ones every item shares stated once, so a search endpoint reads like a results page for a few hundred tokens
 - X profiles and individual posts read without a login (about 390 and 260 tokens); X search, explore, and hashtag pages do not, and oc reports the block instead of guessing
 - Requests impersonate Chrome, so pages that block plain scripts often still work

node_modules

@@ -0,0 +1 @@
+/home/small/PycharmProjects/only-cli/node_modules

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "only-cli",
-  "version": "0.2.0-beta.1",
+  "version": "0.3.0-beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "only-cli",
-      "version": "0.2.0-beta.1",
+      "version": "0.3.0-beta.1",
       "license": "MIT",
       "dependencies": {
         "linkedom": "^0.18.12",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@only-cli/oc",
-  "version": "0.2.0",
+  "version": "0.3.0-beta.1",
   "description": "Turn websites into a compact CLI so AI agents can browse without burning tokens.",
   "type": "module",
   "bin": {

src/cli.js

@@ -16,10 +16,10 @@ usage: oc <command> [args] [flags]
   read <n>            full text of the region at [n], up to 2000 tokens
   raw [url]           distilled markdown of the whole page
   do <n>              follow the numbered link [n], or read [n] if it is text
-  fill <n> <text>     type into a numbered input               (v0.2)
-  submit [n]          submit a form                            (v0.2)
-  back                return to the previous page              (v0.2)
-  session ls|rm       manage saved sessions                    (v0.2)
+  fill <n> <text>     type into a numbered input               (planned)
+  submit [n]          submit a form                            (planned)
+  back                return to the previous page              (planned)
+  session ls|rm       manage saved sessions                    (planned)
 
 flags:
   --budget <tokens>   tighten or loosen the render budget (default 500,