Skip to content

v0.4.0

Choose a tag to compare

View all tags
@only-cli only-cli released this 24 Aug 03:25
· 49 commits to main since this release
v0.4.0
1acf41a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Site shortcuts actually work now, Wikipedia is one of them, and a page oc cannot read says so instead of returning empty.

Added

  • Site shortcuts are dispatched, not just documented. oc <site> <verb> [args] resolves to a URL and then takes the same path oc open does, so it costs the same and reads the same. Name a site by short name, bare name, or domain (oc hn, oc ycombinator, oc news.ycombinator.com), the last argument absorbs every word after it so a query needs no quoting, and oc sites lists every site with its verbs. Shortcuts live in clis/*.json, so adding a site is a JSON file and no code. (#19)
  • Wikipedia: oc wiki article <title>, oc wiki search <query>, and oc wiki lang <code> <title> for the other language editions. Articles come through action=render, which serves the article body without the chrome, navigation, and edit controls that surround /wiki/<Title>. (#22)
  • Proxy support. Outbound fetches honor HTTP_PROXY, HTTPS_PROXY, and NO_PROXY, including the lowercase forms, so oc works in a sandbox whose only route out is a proxy. HTTP and HTTPS proxies both work, and credentials in the proxy URL are sent as Proxy-Authorization. (#17)
  • The MIT LICENSE file that the badge and package.json were already claiming. (#18)

Changed

  • A page that distills to no readable text fails loud. It used to print an empty render and exit 0. It now writes one line to stderr and exits 2, which is distinct from the exit 1 every other failure uses, so a caller can tell "this page is empty" from "oc could not read this page" and reach for a browser only when that is worth doing. --json carries the same verdict as an empty field. (#20)
  • The SSRF guard runs before a proxy is chosen, so a proxied request cannot reach an address the direct path would have refused. (#17)

Fixed

  • GitHub and Reddit shortcut URL templates now reach the pages their verbs name. (#19)

Docs

  • New CHANGELOG.md.
  • The bundled agent skill gained a site shortcuts section. 0.3.0 shipped the shortcuts but the skill never mentioned them, so an agent reading only the skill could not use the feature. It also documents the exit 2 contract and the proxy variables, and its npx pins point at 0.4.0.
  • The README gained an end to end benchmark alongside the existing per-page one: five Wikipedia lookups run as whole tasks in Claude Code, one tool per run. All three tools answered every task correctly, so it is a cost comparison and not an accuracy one.
tool answered correctly input tokens cost turns avg time
oc wiki 5/5 5,535 $0.27 22 11s
built-in WebFetch 5/5 128,792 $0.37 25 14s
built-in WebSearch 5/5 160,431 $0.52 27 22s

Full changelog: v0.3.0...v0.4.0

Assets 2
Loading