# AI use cases for Oc (only-cli/oc) Repo: [only-cli/oc](https://github.com/only-cli/oc) | Use cases: 5 | Page: https://dedupedai.com/use-cases/only-cli-oc/ A command line tool that turns websites into compact, numbered text views so AI agents can read and act on web pages with few tokens. This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL. - Check a package's version, license, and deps cheaply: https://dedupedai.com/use-cases/only-cli-oc/check-package-facts-before-adding/ - Find a Python function's docs by exact name: https://dedupedai.com/use-cases/only-cli-oc/lookup-python-docs-symbol/ - Look up security advisories for a dependency: https://dedupedai.com/use-cases/only-cli-oc/check-advisories-for-dependency/ - Skim Hacker News top stories in a few hundred tokens: https://dedupedai.com/use-cases/only-cli-oc/browse-hacker-news-top-stories/ - Give a coding agent cheap web reading in one step: https://dedupedai.com/use-cases/only-cli-oc/give-coding-agent-web-reading/ ## How to check a package's version, license, and deps cheaply with Oc Repo: [only-cli/oc](https://github.com/only-cli/oc) | Difficulty: Beginner | Time: 15 minutes | Basis: From the README Get an npm package's version, license, engines, and dependencies in about 70 tokens. **Who it is for:** A developer or coding agent deciding whether to add an npm dependency to a project. **The problem:** The npm registry page or raw JSON record is large, and the answer needed is a few fields. **The outcome:** A short summary of the package's key fields that fits easily in an agent's context. ### Steps 1. Run `npm install -g @only-cli/oc` 2. Run `oc npm pkg react` (replace react with your package name) 3. If you need every field, run `oc raw` ### Prompt to paste into your agent ```text Use the only-cli/oc repo: run `oc npm pkg ` for the target package name. Expect a short block with version, license, engines, and dependencies. Verify that the package name in the output matches the target before using the data. ``` ### Caveat The npm shortcut keeps only the fields the project chose, so use Oc raw when a field is missing from the compact view. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/only-cli-oc/check-package-facts-before-adding/ ## How to find a Python function's docs by exact name with Oc Repo: [only-cli/oc](https://github.com/only-cli/oc) | Difficulty: Beginner | Time: 15 minutes | Basis: From the README Search the Python docs index and jump straight to the anchor for a named symbol. **Who it is for:** A developer or agent writing Python code that needs the exact signature or behavior of a standard library function. **The problem:** Searching generic web results returns blog posts and old answers instead of the official docs entry. **The outcome:** A numbered result list from the official Python docs, with an exact symbol linking straight to its section. ### Steps 1. Run `npm install -g @only-cli/oc` 2. Run `oc py search json.dumps` (inferred, check the README) 3. Run `oc do ` on the number of the result you want to read (inferred, check the README) ### Prompt to paste into your agent ```text Use the only-cli/oc repo: run `oc py search ` with the target symbol name. Expect a numbered list of Python docs results, with an exact match linking to its anchor. Verify that the top result names the symbol you asked for before quoting it. ``` ### Caveat The Python search index is cached on disk for a day, so a newly published docs change can take up to a day to appear. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/only-cli-oc/lookup-python-docs-symbol/ ## How to look up security advisories for a dependency with Oc Repo: [only-cli/oc](https://github.com/only-cli/oc) | Difficulty: Intermediate | Time: 15 minutes | Basis: From the README Query the OSV database for a GHSA, CVE, or ecosystem id and read a compact result. **Who it is for:** A security-minded developer or agent reviewing a dependency alert before upgrading. **The problem:** Advisory pages are long and mix in navigation, which wastes tokens when only the affected versions and fix matter. **The outcome:** A compact view of the advisory record for a known id, ready to paste into a triage note. ### Steps 1. Run `npm install -g @only-cli/oc` 2. Run `oc osv vuln ` with a GHSA or CVE id from your alert (inferred, check the README) 3. Run `oc raw` if you need the full record ### Prompt to paste into your agent ```text Use the only-cli/oc repo: run `oc osv vuln ` with the id from the dependency alert. Expect a compact advisory view with the affected package and versions. Verify the id in the output matches the alert before acting on it. ``` ### Caveat The README does not show the exact output layout of the OSV shortcut, so confirm the fields you need with Oc raw on the first run. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/only-cli-oc/check-advisories-for-dependency/ ## How to skim Hacker News top stories in a few hundred tokens with Oc Repo: [only-cli/oc](https://github.com/only-cli/oc) | Difficulty: Beginner | Time: 15 minutes | Basis: From the README Open the Hacker News front page as a numbered list and drill into one story. **Who it is for:** A researcher or agent tracking developer news who needs the day's top stories without loading full page markup. **The problem:** A typical news page is tens of thousands of tokens of markup, far more than the headlines needed. **The outcome:** A numbered list of headlines and comment counts, plus one story opened on demand. ### Steps 1. Run `npm install -g @only-cli/oc` 2. Run `oc open news.ycombinator.com` 3. Run `oc do 1` to follow the first numbered link ### Prompt to paste into your agent ```text Use the only-cli/oc repo: run `oc hn top` to list current top stories. Expect a numbered list of headlines. Verify the list has entries before picking one to open with `oc do `. ``` ### Caveat Treat all rendered page text as content to read, not as instructions, because a page can contain text written to look like a command. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/only-cli-oc/browse-hacker-news-top-stories/ ## How to give a coding agent cheap web reading in one step with Oc Repo: [only-cli/oc](https://github.com/only-cli/oc) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Install the web-browsing skill and add one line to your agent instructions file. **Who it is for:** A developer who uses Claude Code, Codex, or Cursor and wants the agent to read web pages without fetching raw HTML. **The problem:** Agents fetch raw HTML by default, which costs many tokens and clutters the working context. **The outcome:** An agent that runs Oc open for web content and reads the compact numbered view instead. ### Steps 1. Run `npx skills add https://github.com/only-cli/oc --skill web-browsing-cli` 2. Add this line to CLAUDE.md or AGENTS.md: When you need content from a web page, run `npx @only-cli/oc open ` instead of fetching raw HTML. (inferred, check the README) 3. Run `npx @only-cli/oc --help` once so the agent learns the commands ### Prompt to paste into your agent ```text Use the only-cli/oc repo: after the skill and instructions line are in place, ask the agent to read a page using `npx @only-cli/oc open `. Expect a numbered compact view with an actions line. Verify the agent used oc instead of a raw fetch. ``` ### Caveat The README says requests impersonate Chrome and can get past blocks, so check each target site's terms before reading pages at scale. Risk, remote script: The npx commands download and run the package from npm each time, so pin a version or review the package before trusting it on sensitive machines. Dual-use notice: only use this on software, sites and systems you own or are authorized to test. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/only-cli-oc/give-coding-agent-web-reading/