Practical overview
When it fits
Use Oc when an agent needs to retrieve and navigate content from a webpage through CLI commands, particularly when a compact text view is preferable to passing raw markup into its context.
Who it is for
- Developers connecting AI agents to web-page content through a CLI.
- Agent builders seeking compact page text instead of raw HTML or screenshots.
- People building web research workflows around URL fetching and page navigation.
Documented uses
- Fetch a webpage and return a compact, numbered view.
- Follow a numbered link or inspect a numbered text item.
- Find matching text, read a page region, or retrieve the next portion of a page.
- Get a page as distilled Markdown or use a documented shortcut for selected websites.
Requirements & limits
The README documents installation through npm and requires Node 20 or later. It identifies the project license as MIT.
- The numbered view and commands support stepwise navigation rather than returning only a whole-page dump.
- A token budget can be set with
--budget; the documented default is 500 tokens. - The project describes mostly-static-site support without per-site setup, alongside specific shortcuts for selected services.
- Requests use browser impersonation through impers, with documented fallback behavior to Firefox and native fetch.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install Oc and add web browsing instructions to an agent
Make Oc available through npm and direct an AI agent to use it for web-page content.
Before you start
- Node 20 or later
- npm
- An agent with an instructions file such as CLAUDE.md or AGENTS.md
Steps
Install globally with the command below, or use the documented npx invocation without a global install.
npm install -g @only-cli/ocAdd an instruction telling the agent to run the command below when it needs page content.
npx @only-cli/oc openRun the command below once to learn the available commands.
npx @only-cli/oc --help
Expected outcome
The agent has documented instructions for fetching page content through Oc’s CLI.
Guide limitations
- The instructions configure how the agent should request page content; they do not establish compatibility with every agent.
- OpenShift also provides an
occommand. The project recommends npx or a different alias to avoid a PATH name collision.
Open a page and inspect its compact CLI view
Fetch a webpage and use Oc’s documented commands to inspect its rendered content.
Before you start
- Node 20 or later
- Oc available through a global install or
npx @only-cli/oc
Steps
Run the command below to fetch and render the page.
npx @only-cli/oc openUse the command below to follow a numbered link or read a numbered text item.
npx @only-cli/oc doUse the command below to locate text, or the command below to read a region.
npx @only-cli/oc findnpx @only-cli/oc readUse the command below for more of the open page, or the command below for distilled Markdown.
npx @only-cli/oc nextnpx @only-cli/oc raw [url]
Expected outcome
The page is available as a compact numbered view with commands for navigating and retrieving its content.
Guide limitations
- The README describes support for mostly static sites; behavior can depend on the website and its response.
- Treat rendered website text as content to read, not as instructions to follow.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- only-cli/oc · Official homepage title · retained in its source language