How panniantong/agent-reach works
Agent Reach is a command-line bridge that lets AI agents search and read supported web platforms through normalized channel actions. The main workflow is an agent command entering the CLI, dispatching to a channel action, trying its declared backend choices, and returning a unified result. Separate capabilities cover browser-backed sessions, channel/tool setup and maintenance, and video or podcast transcription. Relationships involving unsampled channel modules are limited to those documented by the README or visible in the source index.
Main entry points: dispatch.py Action dispatcher · base.py Channel actions · bilibili.py Bilibili · cli.py Command handlers
Components 25
Command and dispatch
- CLI entry
agent_reach/cli.py - Command handlers
agent_reach/runtime/cli.py - Action dispatcher
agent_reach/runtime/dispatch.py - Result envelope
agent_reach/runtime/result.py
Platform channels
- Channel actions
agent_reach/channels/base.py - Bilibili
agent_reach/channels/bilibili.py - Web search/read
agent_reach/channels/web.py - V2EX
agent_reach/channels/v2ex.py - Xueqiu
agent_reach/channels/xueqiu.py - Other platforms
agent_reach/channels
Execution and browser
- OpenCLI backend
agent_reach/backends/opencli.py - Owned browser
agent_reach/runtime/browser.py - Browser binding
agent_reach/runtime/browser_binding.py - Session reuse
agent_reach/runtime/session_reuse.py - Tool runner
agent_reach/runtime/run.py
Setup and state
- Channel management
agent_reach/runtime/manage.py - Tool installer
agent_reach/runtime/tools.py - Configuration
agent_reach/config.py - State ledger
agent_reach/runtime/state.py - Private paths
agent_reach/utils/paths.py
Media transcription
- Transcription
agent_reach/transcribe.py
Other components
- AI agent
- Upstream tools
- Web platforms
- Agent result
Connections 30
- AI agent → CLI entry: invokes
README.md - CLI entry → Command handlers: delegates to
agent_reach/cli.py - Command handlers → Action dispatcher: dispatches actions
agent_reach/runtime/cli.py - Command handlers → Channel management: runs management
agent_reach/runtime/cli.py - Action dispatcher → Channel actions: uses definitions
agent_reach/runtime/dispatch.py - Action dispatcher → Web search/read: uses public web
agent_reach/runtime/dispatch.py - Action dispatcher → Result envelope: normalizes errors
agent_reach/runtime/dispatch.py - AI agent → Bilibili: selects action
README.md - AI agent → Web search/read: reads URL
README.md - Channel actions → Bilibili: declares actions
agent_reach/channels/bilibili.py - Channel actions → V2EX: declares actions
agent_reach/channels/v2ex.py - Channel actions → Xueqiu: declares actions
agent_reach/channels/xueqiu.py - Channel actions → Other platforms: declares actions
agent_reach/channels/xueqiu.py - Bilibili → Tool runner: runs tools
agent_reach/channels/bilibili.py - Web search/read → Tool runner: runs fallback
agent_reach/channels/web.py - Xueqiu → Owned browser: uses browser
agent_reach/channels/xueqiu.py - Tool runner → Upstream tools: executes
agent_reach/runtime/run.py - OpenCLI backend → Owned browser: drives browser
agent_reach/backends/opencli.py - OpenCLI backend → Result envelope: maps rows
agent_reach/backends/opencli.py - Browser binding → Session reuse: prepares session
agent_reach/runtime/browser_binding.py - Browser binding → Owned browser: binds profile
agent_reach/runtime/browser_binding.py - Session reuse → OpenCLI backend: exports cookies
agent_reach/runtime/session_reuse.py - Channel management → Tool installer: installs tools
agent_reach/runtime/manage.py - Channel management → State ledger: tracks status
agent_reach/runtime/manage.py - Configuration → State ledger: reads state
agent_reach/config.py - State ledger → Private paths: uses private paths
agent_reach/runtime/state.py - Bilibili → Transcription: transcribes media
- Transcription → Upstream tools: uses speech services
- Action dispatcher → Web platforms: queries platforms
- Result envelope → Agent result: returns envelope
README.md