Frequently asked questions

Detailed answers about Cadence's recording model, context, review, privacy, and portability.

Last updated

Recording model

What is Cadence?

Cadence is an open-source tracker for recurring behaviors. You define a Behavior and its Schedule, and Cadence creates each Occurrence on a today-first timeline. Completed means the user declared the occurrence completed. Not Completed means the user declared the occurrence not completed. Unresolved means the user has not made a decision.

What happens if I do not make a decision?

Unresolved means the user has not made a decision. Prior-day Unresolved Occurrences collect in Needs decision until you decide them. Cadence never converts silence into failure.

Why are there no streaks, badges, or points?

Cadence keeps the Record focused on explicit Decisions. It shows Adherence over 7, 30, or 90 days without turning a streak or score into the goal.

Context and history

Can I track how long a behavior takes?

Yes. An Occurrence scheduled for today, or one still in Needs decision, can carry elapsed time. Start, stop, and reset the timer. Reviews show totals and averages alongside Adherence.

What happens when I rename or redefine a Behavior?

Cadence preserves title and description revision history in JSON and BehaviorLog exports. The current app does not provide a full revision browser.

What Context can I add?

You can add an optional note and elapsed time to an Occurrence. Context does not decide whether the Occurrence is Completed or Not Completed.

Review and analysis

How does Adherence work?

Cadence shows Adherence across 7, 30, or 90 days. Adherence is the share of decided Occurrences marked Completed. Unresolved Occurrences remain separate from final calculations.

Can I analyze my Record with an AI service?

Cadence provides exports and prepared prompts for services you choose. When enabled, Daily Brief separately sends selected tracking information to OpenAI; Calendar timing and other optional sources require separate choices. MCP lets a connected AI client read tracking records and make permitted changes you direct and confirm. Calendar data is never shared through MCP. Hosted MCP launch remains pending.

Google Calendar

Is Google Calendar required?

No. Cadence tracking works without Calendar. Where enabled, Google Calendar requires separate read-only consent. Provider approval and acceptance of a particular deployment or desktop build are separate evidence.

What can Cadence read from Google Calendar?

After separate consent with the same Google identity used for Cadence sign-in, Google grants read-only access to your subscribed calendar list and events on calendars you can access. Cadence reads the list so you can choose calendars, then fetches events only from selected calendars for the days displayed in Timeline. Depending on Google permissions and event data, details can include titles, descriptions, times, locations, organizers, attendees, conference details, attachment links, and Google event links.

Can Cadence change my Google Calendar events?

No. Cadence requests read-only Calendar access. It cannot create, change, or delete Google events, and it does not download attachments automatically.

How do I disconnect Google Calendar?

Choose Disconnect Google Calendar in Settings. This removes the live server credential and requests global revocation of the Calendar grant. Web sign-out ends only that Cadence session and leaves the account-level Calendar connection active. Disconnecting a Cadence account on desktop clears that Mac's Calendar cache but does not revoke the global grant. An offline device may retain stale cached event details until it reconnects or its Cadence account is disconnected.

Outlook, iCloud, and Hevy

Are Outlook, iCloud and Hevy available?

The web and linked-desktop implementations have local source and synthetic verification. Live Microsoft, Apple and Hevy access, installed desktop behavior and deployment remain unverified. Local checks do not establish public availability.

What can Cadence read from Outlook Calendar?

Microsoft asks you to allow Cadence to read your calendars. That permission covers event details such as descriptions and attachments, because Microsoft rejects the narrower permission for personal Outlook.com, Hotmail and Live accounts. Cadence requests only event titles, times, timezone, availability, your response and calendar names. It never requests descriptions, attachments or extensions, discards any other field Microsoft returns, and never edits events.

What does the Hevy connector use?

Hevy requires Pro. Cadence displays recorded workout timing and duration. API responses can include exercises, sets, weights, titles, routines and notes; Cadence discards these details. Location is unsupported. Workouts never automatically complete a Behavior or prove free time. Even today-only requests scan global history, bounded at 500 workouts. Larger accounts return incomplete without workout page reads. Count and page checks mean no detected change, not an atomic snapshot; concurrent changes can escape detection.

Where do connector credentials and records go?

Cadence seals credentials in its hosted private schema. Desktop posts key/password intake once and never persists it. An Apple app-specific password can also reach Mail, Contacts and other iCloud data; Cadence restricts its use to Calendar reads. Web snapshots stay in memory. Desktop can keep a disposable source cache outside tracking exports, account synchronization and user-created backups. Cadence does not persist source records in its hosted database. Deleted ciphertext can remain in infrastructure backups for the existing seven-day window.

Does connecting a source let Daily Brief use it?

No. Google Calendar, Outlook Calendar, iCloud Calendar and Hevy each need a separate default-off Daily Brief choice. Calendar context includes today's timing and availability without event titles or details; Hevy contributes only today's past workout timing and duration. Credentials and raw records stay out. Reconnect or calendar reselection requires renewed permission. Turning Daily Brief off or saving from an older client revokes the new source choices. Cadence keeps no production prompt or briefing history; OpenAI retention can still apply.

Does disconnect revoke provider access?

For Outlook, iCloud and Hevy, disconnect removes Cadence's live credential and clears the local source cache, but does not revoke provider access. Remove Cadence in Microsoft account app permissions or work/school My Apps, revoke the app-specific password at account.apple.com, or remove or regenerate the Hevy API key. Account deletion also needs these manual steps. Other devices clear source data on their next connection check; offline devices can retain stale context. Desktop sign-out and account switch clear local caches.

Privacy and portability

Who can see my data?

Cadence is single-player by design. There is no social feed or collaboration layer. Read the Privacy page for the current data practices and the Trust page for bounded operational evidence.

Can I leave and take my Record with me?

Yes. Export your history as JSONL, JSON, CSV, Markdown, BehaviorLog bundle. These files can be inspected without Cadence.

Is tracked time included in my exports?

Only when you choose to include it. Exports omit timing data by default because exact session timestamps can reveal activity patterns.

What is BehaviorLog?

BehaviorLog is the open portability standard used by Cadence. A bundle contains plain JSONL files, a manifest, schemas, and SHA-256 checksums. The standard lives at https://github.com/emixd12/BehaviorLog-Bundle.

What does Cadence cost?

Cadence is currently available without charge.

Start with one Behavior and let each Occurrence wait for your Decision.

Begin a record →