Back to docs

Tools Site Knowledge

CBrowser maintains a persistent knowledge graph per site, enabling smarter navigation and contextual awareness across sessions.

Tools

Tool Description
page_understand Analyze page type, affordances, structure, and navigation
site_model_status Check what CBrowser knows about a site
site_model_query Query the site's navigation graph and element data
site_profile_list List saved site profiles (encrypted session state)
site_profile_delete Delete a saved site profile
site_profile_status Check profile details and data freshness

How It Works

The Site Knowledge System accumulates four types of data:

  1. Navigation Maps β€” Graph of how pages connect within a site
  2. Element Reliability β€” How stable each interactive element is across visits
  3. Goal Paths β€” Known successful action sequences for specific tasks
  4. Failure Patterns β€” Recorded errors from previous visits

This data feeds the siteFamiliarity cognitive trait, which auto-scales based on available knowledge. A power-user persona visiting an unfamiliar site is automatically downgraded to first-timer behavior because no navigation data exists.

Storage

Site profiles are encrypted with AES-256-GCM and stored locally in ~/.cbrowser/site-models/.

Related

From the Blog