agent-reach read: 'invalid choice: read' error — how to actually read a URL?
I installed the latest agent-reach from pip on macOS and followed the SKILL.md docs, which say to read a web page with
agent-reach read <url>. Running it fails withError: invalid choice: 'read', and help lists only setup, install, configure, doctor, uninstall, check-update, watch, version. Is the command missing, or is the documentation wrong?Originally asked on GitHub: https://github.com/Panniantong/Agent-Reach/issues/58
2 answers
Fixed — the
readcommand never existed; PR #59 clarified the SKILL.md wording and removed a dead placeholder comment in the CLI source, and the maintainer confirmed the fix on 2026-03-04.Agent Reach is an installer/config tool, not a wrapper. It sets up upstream tools (xreach, yt-dlp, Jina Reader, etc.) but doesn't expose their functionality through its own CLI. After running
agent-reach install, you call the upstream tools directly. The only available commands aresetup, install, configure, doctor, uninstall, check-update, watch, version.The SKILL.md line at L79 says "No need for
agent-reach readoragent-reach search." That was meant to tell users not to use those commands — they don't exist — but the wording could be misread as "these exist but you don't need them." PR #59 fixed the wording.To read a web page, the maintainer confirmed the reporter's workaround is correct — call Jina Reader directly:
bashcurl -s "https://r.jina.ai/<URL>"For Twitter/X posts specifically, use the xreach tool that
agent-reach installsets up:bashxreach tweet https://x.com/i/status/2028389125594993010 --jsonDid this work for you?What a GitHub user tried on GitHub (Didn't work)
The reporter ran
agent-reach read https://x.com/i/status/2028389125594993010on macOS with the latest pip-installed agent-reach, exactly as SKILL.md documented, and gotError: invalid choice: 'read'. The help output lists only setup, install, configure, doctor, uninstall, check-update, watch, version.Source: https://github.com/Panniantong/Agent-Reach/issues/58 (opens external site)
Did this work for you?
Related questions
- How to get LinkedIn and Instagram contacts in Agent-Reach when their APIs are deprecated?
- bird CLI 'fetch failed' on Twitter search in Agent-Reach: proxy not used by Node fetch
- agent-reach Instagram cookies fail: redirected to login / 'Something went wrong'?
- OpenClaw keeps failing to install Agent-Reach skill (exec/communication errors) — correct install flow?
- Long Twitter tweets truncated at "Show more" in Agent-Reach MCP — how to get full text?