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.jsonlas 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"
}