Docs for Cadence and portable behavior records.

Start here when a developer or agent needs to understand Cadence, inspect a BehaviorLog bundle, cite a canonical page, or parse the example export without opening the app.

Quick start

  • Open Trust for current bounded verification results and durable product commitments.
  • Open Cadence for product scope and user-facing behavior.
  • Open BehaviorLog for bundle structure and status semantics.
  • Download the example bundle for parser tests.

Reader contract

Cadence stores manual behavior decisions. BehaviorLog preserves those decisions in files. A reader should never convert unresolved into failure or treat a current-status snapshot as the full event history.

Machine files

URL Use
https://app.cadence-me.com/trust Canonical human Trust page with durable commitments and current verification results.
https://app.cadence-me.com/api/public/trust-evidence Normalized current Trust evidence as JSON.
https://app.cadence-me.com/privacy Canonical HTML privacy notice on the application origin.
https://app.cadence-me.com/terms Canonical HTML terms on the application origin.
/llms.txt Curated index for working agents and developer tools.
/llms-full.txt Small full-site text bundle with page boundaries.
/data/route-manifest.json Public route manifest used by generators.
/sitemap.xml Canonical HTML route sitemap.
/robots.txt Max-visibility crawl policy and sitemap pointer.
/faq.md Markdown mirror for the frequently asked questions route.
/examples.md Markdown mirror for the examples route.
/docs.md Markdown mirror for this docs route.
/about.md Markdown mirror for the launch about route.
/index.md Markdown mirror for the homepage.

Public route manifest

Route Type Markdown Description
/ landing /index.md Cadence is an open-source behavior tracker where you decide every occurrence and export your full history as a portable BehaviorLog bundle.
/faq faq /faq.md Detailed answers about Cadence's recording model, context and history, review and analysis, privacy, and portability.
/examples example /examples.md Download a sanitized Cadence-generated BehaviorLog-style example bundle and inspect the files agents should read first.
/docs documentation /docs.md Technical entry points for Cadence, BehaviorLog bundles, machine-readable mirrors, and future docs structure.
/about about /about.md Cadence's behavioral-remodeling philosophy, Record principles, current product scope, vocabulary, and implementation links.
/developers documentation /developers.md Connect to Cadence with MCP: tracking data, scoped edits, authentication, and integration boundaries.
/developers/quickstarts documentation /developers/quickstarts.md Connect Claude, Claude Code, ChatGPT, MCP Inspector, and other clients to a configured Cadence MCP endpoint.
/developers/concepts documentation /developers/concepts.md Behaviors, Occurrences, manual statuses, timezones, recurrence, and adherence in Cadence's MCP contract.
/developers/authentication documentation /developers/authentication.md OAuth discovery, client registration, PKCE, scopes, consent, token rotation, revocation, and Connected apps.
/developers/tools documentation /developers/tools.md All 16 Cadence MCP tools, generated from the versioned operation registry.
/developers/errors documentation /developers/errors.md Stable Cadence error codes, HTTP admission failures, tool errors, and retry guidance.
/developers/limits documentation /developers/limits.md Pagination, date windows, text sizes, response budgets, and per-grant MCP rate limits.
/developers/idempotency documentation /developers/idempotency.md Retry Cadence writes without duplication and prevent overwriting records that changed after a read.
/developers/data-and-privacy documentation /developers/data-and-privacy.md Data available through MCP, excluded data, activity metadata, retention mechanics, and safe treatment of returned text.
/developers/building-integrations documentation /developers/building-integrations.md Build a third-party Cadence client with explicit consent, external references, incremental reads, and safe edits.
/developers/plugins documentation /developers/plugins.md Cadence's Claude and ChatGPT plugin sources, bundled workflow skills, and pending distribution status.
/developers/versioning documentation /developers/versioning.md Cadence MCP contract versioning, compatibility rules, deprecation, and the local implementation changelog.
/developers/troubleshooting documentation /developers/troubleshooting.md Resolve Cadence MCP reachability, authorization, permission, conflict, and Inspector display errors.
/developers/tools/get_account_context documentation /developers/tools/get_account_context.md Get Cadence account context: inputs, outputs, permissions, examples, and errors.
/developers/tools/list_behaviors documentation /developers/tools/list_behaviors.md List Behaviors: inputs, outputs, permissions, examples, and errors.
/developers/tools/get_behavior documentation /developers/tools/get_behavior.md Get Behavior: inputs, outputs, permissions, examples, and errors.
/developers/tools/list_categories documentation /developers/tools/list_categories.md List categories: inputs, outputs, permissions, examples, and errors.
/developers/tools/get_timeline documentation /developers/tools/get_timeline.md Get Timeline: inputs, outputs, permissions, examples, and errors.
/developers/tools/list_occurrences documentation /developers/tools/list_occurrences.md List Occurrences: inputs, outputs, permissions, examples, and errors.
/developers/tools/get_occurrence documentation /developers/tools/get_occurrence.md Get Occurrence: inputs, outputs, permissions, examples, and errors.
/developers/tools/list_day_notes documentation /developers/tools/list_day_notes.md List day notes: inputs, outputs, permissions, examples, and errors.
/developers/tools/get_adherence_summary documentation /developers/tools/get_adherence_summary.md Get adherence summary: inputs, outputs, permissions, examples, and errors.
/developers/tools/search documentation /developers/tools/search.md Search Cadence: inputs, outputs, permissions, examples, and errors.
/developers/tools/fetch documentation /developers/tools/fetch.md Fetch Cadence record: inputs, outputs, permissions, examples, and errors.
/developers/tools/set_occurrence_status documentation /developers/tools/set_occurrence_status.md Set Occurrence status: inputs, outputs, permissions, examples, and errors.
/developers/tools/set_parent_occurrence_status documentation /developers/tools/set_parent_occurrence_status.md Set parent Behavior slot status: inputs, outputs, permissions, examples, and errors.
/developers/tools/update_occurrence_note documentation /developers/tools/update_occurrence_note.md Update Occurrence note: inputs, outputs, permissions, examples, and errors.
/developers/tools/move_occurrence_for_day documentation /developers/tools/move_occurrence_for_day.md Move Occurrence for today: inputs, outputs, permissions, examples, and errors.
/developers/tools/revert_occurrence_move documentation /developers/tools/revert_occurrence_move.md Undo Occurrence move: inputs, outputs, permissions, examples, and errors.
/developers/tools/update_day_note documentation /developers/tools/update_day_note.md Update day note: inputs, outputs, permissions, examples, and errors.
/developers/tools/add_opportunity_occurrence documentation /developers/tools/add_opportunity_occurrence.md Add opportunity to today: inputs, outputs, permissions, examples, and errors.
/developers/tools/remove_opportunity_occurrence documentation /developers/tools/remove_opportunity_occurrence.md Remove added opportunity: inputs, outputs, permissions, examples, and errors.
/developers/tools/create_behavior documentation /developers/tools/create_behavior.md Create Behavior: inputs, outputs, permissions, examples, and errors.
/developers/tools/update_behavior documentation /developers/tools/update_behavior.md Update Behavior: inputs, outputs, permissions, examples, and errors.
/developers/tools/archive_behavior documentation /developers/tools/archive_behavior.md Archive Behavior: inputs, outputs, permissions, examples, and errors.
/developers/tools/restore_behavior documentation /developers/tools/restore_behavior.md Restore Behavior: inputs, outputs, permissions, examples, and errors.
/developers/tools/end_behavior documentation /developers/tools/end_behavior.md End Behavior now: inputs, outputs, permissions, examples, and errors.
/developers/tools/pause_behavior documentation /developers/tools/pause_behavior.md Pause Behavior: inputs, outputs, permissions, examples, and errors.
/developers/tools/resume_behavior documentation /developers/tools/resume_behavior.md Resume Behavior: inputs, outputs, permissions, examples, and errors.

Analysis boundary

Adherence includes only decided Occurrences. Keep Unresolved separate. Do not infer causes, clinical meaning, or motivation from a Record. You choose whether to share exports with an external AI service. Separately, where enabled, optional Daily Brief sends disclosed context to OpenAI. Each connected source needs its own model-data choice.

Rules for agents

  • Prefer Markdown mirrors when context budget matters.
  • Cite canonical HTML URLs when answering humans.
  • Use data/status_events.jsonl as the BehaviorLog history authority.
  • Do not infer a failed behavior from unresolved status.
  • Do not treat the example bundle as real user data.
{
  "standard": "https://github.com/emixd12/BehaviorLog-Bundle",
  "example_bundle": "/examples/cadence-demo.behaviorlog.zip",
  "status_authority": "data/status_events.jsonl",
  "current_status_role": "snapshot"
}