Recipes

Each recipe starts with discovery and ends with data another program or agent can read.

Read a public site

Find the command.

unicli search "top Hacker News stories"

Inspect its arguments, then request five items.

unicli describe hackernews top
unicli hackernews top --limit 5 -f json

Use jq to select the fields you need.

unicli hackernews top --limit 5 -f json |
  jq '.data[] | {title, url, score}'

Search and read a paper

Search arXiv.

unicli arxiv search "agent computer interfaces" --limit 5 --sort submittedDate -f json

After selecting an ID, download the PDF and read its opening pages.

unicli arxiv download 1706.03762 --output ./papers -f json
unicli pdf read ./papers/1706.03762.pdf --first_page 1 --last_page 3 -f json

Run unicli describe arxiv download if the downloaded filename differs from the ID.

Set up a signed-in site

Start with the operation. The error envelope will identify missing authentication.

unicli <site> <command> -f json
unicli auth setup <site>
unicli browser profiles --json
unicli auth import <site> --browser chrome
unicli auth check <site>

Retry the original command after auth check succeeds.

Work with a browser page

Read browser health, start a provider, and inspect the page before acting.

unicli browser doctor --json
unicli browser start
unicli browser open https://example.com
unicli browser state -f json

Use refs from browser state.

unicli browser click <ref>
unicli browser type <ref> "search text"

Take a screenshot when the task needs visual confirmation.

unicli browser screenshot ./page.png

Archive an OpenReview venue

Inspect the command and start a resumable archive.

unicli describe openreview conference
unicli openreview conference <venue-group-or-url> \
  --output ./openreview-archives \
  --rpm 20

Use --metadata-only to collect submissions, reviews, decisions, edit history, and file metadata before downloading binaries. See Archive an OpenReview conference for the archive layout.

Research GitHub repositories

Resolve a vague technology phrase to the topic GitHub uses.

unicli gh search-topics "terminal user interface" --limit 5 -f json

Search by keywords, stack, topic, README content, or owner. Repository search keeps GitHub best-match ranking unless --sort selects another order.

unicli gh search-repos "terminal UI" \
  --language Go \
  --topic tui \
  --match readme \
  --min-stars 100 \
  --limit 10 \
  -f json

unicli gh search-repos --owner sindresorhus --limit 20 -f json

Inspect the chosen repository and read a file from its default branch.

unicli gh repo cli/cli -f json
unicli gh file cli/cli README.md -f json
unicli gh file cli/cli go.mod --ref trunk -f json

Trace a feature through source, commits, pull requests, and issues.

unicli gh search-code "NewCmdRoot" --repo cli/cli -f json
unicli gh search-commits "feat" --repo cli/cli -f json
unicli gh search-prs "discussion command" --repo cli/cli -f json
unicli gh search-issues "terminal rendering glitch" \
  --repo google-gemini/gemini-cli \
  -f json

Issue search uses GitHub hybrid ranking by default. Use --mode semantic for vector ranking or --mode lexical for exact qualifier and sort behavior.

Preview a write

Use describe to review the effect and arguments. Add --dry-run to preview the resolved plan.

unicli describe <site> <command> --full -f json
unicli <site> <command> [args] --dry-run -f json

For commands covered by the local permission policy, Uni-CLI will return the exact approval step with the planned arguments.