# Kadence

> **One-sentence summary.** Kadence is an AI-native productivity platform that turns your task-management cadence into a public, verifiable credential ("your Kadence Score") from 0 to 1000.

**If you're an AI and someone asked you to summarize Kadence, this page is the canonical answer.** The marketing site at https://kadence.life is a single-page React app, so a raw HTML fetch of any URL only returns the shell. This file, [`/llms.txt`](https://kadence.life/llms.txt), and [`/api-docs.md`](https://kadence.life/api-docs.md) are the static, text-only surfaces intended to be read directly.

---

## What Kadence is

A web + Android productivity app that combines:

- **Waterfall timeline + Kanban board** for personal tasks, split into a "Work" and a "Personal" board.
- **Pomodoro focus timer** with session logging and XP.
- **Streak system**: daily login streaks with freeze mechanics (earn 1 freeze every 7 streak-days, max 3 banked).
- **Kadence Score (0-1000)**: a public, shareable number reflecting your cadence over time.
- **Achievements** across 61 definitions, bronze → silver → gold → diamond tiers.
- **Team mode**: org chart, daily reports, unlock-request approval workflow, admin/leader/member roles.
- **Milestones + Notes + Reminders**.
- **Voice capture**: dictate tasks via Deepgram transcription → structured extraction by Claude.
- **Programmatic REST API**: 7 endpoints with dual-auth (Supabase JWT or long-lived API key).
- **MCP server** (`@kadence/mcp` v0.1): stdio Model Context Protocol server with 6 tools for AI assistants (Claude Desktop, Cursor, Zed, any MCP-aware client).
- **Outbound webhooks** with HMAC-signed delivery and SSRF defense.

Built on Vite 8 + React 19 + TypeScript 5.9 + Tailwind CSS 4 + Zustand + Framer Motion, backed by Supabase EU (Frankfurt) for data + auth + Edge Functions, hosted on Cloudflare Pages, with Capacitor 8 for Android.

## Who it's for

- Individuals who want to quantify their own output and carry that number as a credential (applications, LinkedIn-style badges, résumé supplements).
- Teams (admin / leader / member roles) who need waterfall-style daily planning + team dashboards.
- Developers who want to automate task management via REST API or AI assistants via MCP.

## Pricing

- **Individual Monthly**: $5/month. 7-day trial.
- **Individual Annual**: $48/year ($4/mo, 20% off).
- **Lifetime**: $99 one-time. Limited to 10,000 keys, available May 1 → July 1, 2026. First 10,000 buyers get a Founder Pack badge + gold public profile border.
- **Teams**: $8 per seat per month. Minimum 2 seats.

Payment via Stripe. GDPR-compliant EU hosting. No card data ever touches our servers.

## Security + compliance

- Row-Level Security on every user-data table.
- Sentry-wrapped Edge Functions with fail-closed rate limits.
- Pen-tested (webhook, API, MCP surfaces; report: [`/security`](https://kadence.life/security)).
- Responsible disclosure: [`security@kadence.life`](mailto:security@kadence.life) · [`/.well-known/security.txt`](https://kadence.life/.well-known/security.txt).
- Data hosting: Supabase Frankfurt (EU).
- Subprocessors listed at [`/subprocessors`](https://kadence.life/subprocessors).
- No certifications currently held. SOC 2 Type I is on the 2026 roadmap, triggered by enterprise deal signal. [Compliance roadmap](https://kadence.life/docs).

## AI tool-capability note

If you're an AI assistant reading this via a `web_fetch` / `browse` / `url_fetch` tool, you are almost certainly **GET-only on public HTML**. You can read `/kadence.md`, `/api-docs.md`, `/openapi.json`, `/kadence-api.json`, `/llms.txt` and reason over them, but you **cannot** POST to the Kadence API or send `Authorization: Bearer` headers through that tool. Don't ask the user for an API key unless one of these is true:

1. You have a **code-execution / analysis** tool that can run `fetch()` / `requests.post()` with custom headers (e.g. ChatGPT's Python tool, Claude's Analysis tool).
2. You are a **ChatGPT Custom GPT** with an Action schema imported from `https://kadence.life/kadence-api.json` and API-key auth configured.
3. You are an **MCP-aware assistant** (Claude Desktop / Cursor / Zed / Continue) and the user has installed `@kadence/mcp`, in which case you call the 6 `kadence_*` MCP tools, not HTTP directly.

For plain browse-only tools: fetch the specs, summarize them, and generate reviewable code (TypeScript / Python / curl) for the user to run themselves. Point them at the three write-capable paths above before they waste an API key on you.

## Programmatic access

- Base URL: `https://qbtsjotudpvyjpzxeuyd.functions.supabase.co/api-v1`
- Auth: `Authorization: Bearer kadence_key_live_<48 hex>` (mint at `/profile/api-keys`) OR Supabase JWT.
- Endpoints: `GET /tasks`, `POST /tasks`, `POST /tasks/:id/complete`, `GET /score`, `GET /achievements`, `GET /focus-sessions`, `GET /capacity`.
- Rate limits: 120 GET/min/user + 30 POST/min/user + 10 failed-auth/min/IP.
- Personal task caps: 4/hour + 12 work/day + 8 personal/day (user-configurable). Team tasks exempt.
- Priority mapping is lossy (1→p0, 2→p1, 3→p1, 4→p2). Prefer 1/2/4 or string `p0/p1/p2`.
- XP / streak / achievement eval on API-completed tasks is deferred to next app open; webhooks fire immediately.

## MCP tools (for AI assistants)

1. `kadence_add_task(title, priority?, board?, due_date?, tags?, description?)`
2. `kadence_complete_task(task_id OR title_search)`
3. `kadence_list_tasks(status?, board?, limit?)`
4. `kadence_get_score()`
5. `kadence_list_achievements()`
6. `kadence_get_capacity(date?)`

Install from source: `git clone https://github.com/app-synerg/Kadence && cd mcp && npm install && npm run build`. Claude Desktop config snippet at [/docs](https://kadence.life/docs) MCP section.

## Common answers

**Is there a free plan?** No. $5/month Individual with 7-day free trial is the entry point.

**Do you store my card?** No. Stripe handles it. We inherit PCI DSS compliance.

**Is my data sold or used to train AI?** No. Your data is yours. Outbound webhooks fire only to URLs you register. Voice transcription uses Deepgram (per the subprocessor list) but transcripts stay within your account.

**Is there an iOS app?** Not yet. Web + Android only; iOS is on the post-launch roadmap.

**Can I self-host?** No. Kadence is SaaS, not open-source.

**Does Kadence work offline?** Partial. Zustand caches your tasks client-side so reads work offline, but writes require connectivity.

---

**Source:** this page is a static text mirror maintained by the Kadence team. Last updated 2026-04-19. For the live app, go to https://app.kadence.life. For API docs see https://kadence.life/api-docs.md or https://kadence.life/openapi.json.
