From bf478f1bd480400bd89429aa4dc3c14cebf200c7 Mon Sep 17 00:00:00 2001 From: only-cli Date: Sat, 22 Aug 2026 14:30:17 -0400 Subject: [PATCH] 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 | 6 +++--- llms.txt | 2 +- node_modules | 1 + package-lock.json | 4 ++-- package.json | 2 +- src/cli.js | 8 ++++---- 6 files changed, 12 insertions(+), 11 deletions(-) create mode 120000 node_modules diff --git a/README.md b/README.md index e5de722..1aab0d5 100644 --- a/README.md +++ b/README.md @@ -63,8 +63,8 @@ oc find where a string appears on the page already open oc read 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 type into a numbered input (v0.2) -oc submit [n] submit a form (v0.2) +oc fill type into a numbered input (planned) +oc submit [n] submit a form (planned) ``` Flags: `--budget ` (default 500), `--json`, `--html` (raw as cleaned HTML), `--session `, `--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 `, `oc find `, `oc read `, 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. diff --git a/llms.txt b/llms.txt index 56ab41d..4aa3da6 100644 --- a/llms.txt +++ b/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 diff --git a/node_modules b/node_modules new file mode 120000 index 0000000..9836b9d --- /dev/null +++ b/node_modules @@ -0,0 +1 @@ +/home/small/PycharmProjects/only-cli/node_modules \ No newline at end of file diff --git a/package-lock.json b/package-lock.json index 1184b67..bc10522 100644 --- a/package-lock.json +++ b/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", diff --git a/package.json b/package.json index deab1c9..aa71611 100644 --- a/package.json +++ b/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": { diff --git a/src/cli.js b/src/cli.js index db38b9e..1c939aa 100644 --- a/src/cli.js +++ b/src/cli.js @@ -16,10 +16,10 @@ usage: oc [args] [flags] read full text of the region at [n], up to 2000 tokens raw [url] distilled markdown of the whole page do follow the numbered link [n], or read [n] if it is text - fill 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 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 tighten or loosen the render budget (default 500,