list-connectors

agentgraph list-connectors is the operator view of installed connectors, credential state where applicable, URL ownership, and sync behavior.

#Synopsis

agentgraph list-connectors [--verify] [--json]
agentgraph connector <source> <command> [args...] [--json]
agentgraph connector <source> --help

#Example

agentgraph list-connectors
agentgraph list-connectors --json
agentgraph list-connectors --verify
agentgraph connector rss add https://simonwillison.net/atom/everything/
agentgraph connector rss remove https://simonwillison.net/atom/everything/
agentgraph connector rss --help
agentgraph connector rss import-opml feeds.opml --all
agentgraph connector rss import-opml feeds.opml --select 1,3-5
agentgraph connector web observe http://localhost:3000/*
agentgraph connector web observe http://localhost:3000/content/research.md
agentgraph connector web list
agentgraph connector web observe http://localhost:3000/* --remove
agentgraph connector web fetch https://www.thecgo.org/research/energy-superabundance/ --compact

RSS add validates each supplied URL as an RSS or Atom feed before saving, then queues an RSS poll. Invalid feeds and HTML pages are rejected without changing the connector configuration.

RSS remove removes exact configured feed URLs without fetching or validating them.

For RSS OPML imports, omit --all and --select in an interactive terminal to choose feeds with a checkbox prompt.

The web connector stores browser observation rules with observe; add --remove to remove a rule. A URL without a trailing /* observes that exact URL; a URL ending in /* observes every URL under that literal prefix. Rules are stored in ~/.agentgraph/config.toml, or in config.yaml when that file exists. The browser extension refreshes the rules from the running server periodically.

Web fetches preserve the original response by default. Use --compact for a one-off fetch when a page exceeds the size limit because of inline styles, scripts, or comments:

agentgraph connector web fetch https://example.com/large-page --compact

This removes those non-content blocks while the response is streamed, before the size limit is applied. Compaction affects only that command; bookmarks, observations, RSS article hydration, and background fetches retain the original HTML behavior.

Connectors that do not use credentials, such as RSS and generic web, omit auth status in the human output and report null auth fields in JSON.

Use --verify only when credential validity is uncertain; it performs live provider API checks before reporting connector status.