# FitKiku

Descriptor: Let the AI you choose use recent Steps and Sleep from your iPhone

Canonical URL: https://kikuai.dev/fitkiku/

App Store: https://apps.apple.com/app/id6801516904

Brand: KikuAI

Category: Steps and Sleep for the AI you choose.

Last updated: 2026-08-30

## What It Does

FitKiku is a separate iPhone product that lets a compatible personal AI use
recent read-only Steps and Sleep after explicit approval on the iPhone. It does
not include an AI coach, expose all Apple Health data, or promise real-time
delivery.

The current public surface is narrow:

- daily read-only Apple Health Steps summaries;
- daily read-only Apple Health Sleep summaries;
- visible freshness, coverage, and missing-data status;
- a setup prompt for compatible agent runtimes;
- explicit review and approval of the agent's one-time Pair Link;
- revocation of future device delivery and agent reads;
- in-app deletion for an anonymous FitKiku account and its synced server data.

## Next Release Candidate

The 1.1 source candidate moves ordinary ChatGPT setup into the iPhone app. It
creates one private, revocable HTTPS URL and a prepared message containing that
URL, while keeping Pair Links under Advanced settings. This is not in the
current App Store 1.0 binary. Production ingress, exact physical-device
acceptance, archive, upload, Apple review, and public release remain separate
gates.

## First User / Job

Useful for someone who already asks ChatGPT or another compatible AI about
activity, sleep, recovery, or routine and is tired of manually typing Steps and
Sleep into it.

The first job is:

> Let the AI I already use take recent Steps and Sleep into account without
> making me run a server; show when the data was last observed and let me revoke
> access later.

## Input To Output

Input:

- user-approved Apple Health read access for Steps and Sleep;
- one approved FitKiku connection created by a compatible agent and accepted
  on the iPhone.

Action:

- copy FitKiku's setup prompt into a compatible agent;
- open the one-time Pair Link returned by that agent;
- review the destination and read-only disclosure on the iPhone;
- let FitKiku read daily Apple Health aggregates and send bounded summaries to
  the approved destination;
- let the approved agent fetch bounded summaries with explicit freshness and
  missing-data handling.

Output:

- bounded read-only access for the approved agent;
- freshness, coverage, local-date, and missing-data status;
- an authenticated deletion path for an anonymous FitKiku account.

## Release 1.0 Setup

Release 1.0 requires an agent runtime that implements the FitKiku pairing
protocol. A generic ChatGPT chat may not support it. The honest flow is:

1. Install and open FitKiku on the iPhone.
2. Copy FitKiku's setup prompt into the chosen agent.
3. If it supports FitKiku, open the one-time Pair Link it returns on the iPhone.
4. Review the claimed agent, HTTPS destination, and read-only Steps/Sleep scope.
5. Approve the connection, then grant Apple Health read access separately.

If the agent cannot create a FitKiku Pair Link, release 1.0 cannot connect it.
Do not invent a link or ask the person for passwords, API tokens, or a manual
Apple Health export.

## Advanced Agent Setup Protocol

This optional protocol is for a capable personal agent that can make HTTPS JSON
requests and keep one bearer credential in its private credential store. If
the agent cannot do both, it must say that it cannot connect yet. It must not
ask the person for a server URL, password, API token, Pair Link token, or
manual Apple Health export.

Gateway origin:

`https://fitkiku-origin.kikuai.dev`

1. Create one pending connection with `POST
   /healthkit/public/agent-grants` and JSON
   `{"agent_name":"<short name the person will recognize>"}`.
2. Validate the JSON response fields `pair_link`, `agent_credential`,
   `expires_at`, and `scopes`. Store `agent_credential` privately. Show the
   person only `pair_link`; never paste, log, or display the credential.
3. Ask the person to open the Pair Link on the iPhone with FitKiku installed,
   review the named destination and Steps/Sleep scope, approve the connection,
   and separately allow Apple Health read access. Opening a Pair Link alone
   transfers no Health data.
4. Poll `GET /healthkit/agent/status` with `Authorization: Bearer
   <agent_credential>` no more than once every ten seconds until `state` is
   `active` or `expires_at` passes.
5. Do not claim a current connection merely because `state` is `active`. Wait
   for `last_server_received_at` and `latest_local_date`, and require
   `data_freshness` to be `current` before giving a current-data answer. Use
   `latest_local_date` as the end of a bounded request and fetch no more than
   seven inclusive dates with `GET
   /healthkit/agent/daily?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD` using the
   same bearer. Treat missing dates, null metrics, `unknown`, `partial`, or
   `stale` status as missing or stale evidence, never as zero or current data.
6. To stop agent access, call `POST /healthkit/agent/revoke` with the same
   bearer and require the server-confirmed `revoked` response. Then make one
   bounded daily request with the old bearer internally and require `401`;
   never display the bearer while checking. If the read succeeds, report that
   revocation failed. Remove the stored bearer only after the denial check.
   The person can also revoke in FitKiku. An anonymous FitKiku account and its
   synced data can be deleted separately from iPhone Settings.

All gateway responses in this flow are JSON and use `Cache-Control: no-store`.
The bearer is returned once. Do not put it in chat, a URL, analytics, telemetry,
or general logs. Do not follow redirects for authenticated requests. A `401`
means the connection is not active or is no longer valid; a `429` means wait
and retry only after the response's `Retry-After` interval.

## Supported Cases

- The person uses a compatible agent that can follow the pairing
  protocol and store a bearer credential privately.
- The goal is daily read-only Steps and Sleep context, not a general health
  dashboard.
- The person wants visible freshness, explicit approval, and revocation.
- The person does not paste server URLs, passwords, recovery codes,
  credentials, or MCP plumbing into FitKiku.

## Unsupported / Not For

- Agent runtimes that cannot implement the FitKiku pairing protocol.
- Every AI agent, runtime, chat surface, or MCP setup.
- Medical diagnosis, treatment, clearance, or emergency decisions.
- Write access to Apple Health.
- Meal logging, calorie budgeting, or broader health-data export categories.
- App Store storefronts outside the developer's currently configured non-EU set.
- Buying a hosted gateway today.
- A built-in or unlimited AI coach.
- An AI that knows everything about the person.
- Continuous real-time delivery.

## Privacy Boundary

FitKiku requests read-only Apple Health access for Steps and Sleep only. The
user approves the claimed agent, exact HTTPS destination, and scope before
transfer. The Pair Link is one-time setup metadata; the agent credential must
stay in the compatible agent's private credential store and never enter chat.
Sleep interval timestamps stay on the iPhone in the current contract. An
anonymous FitKiku guest can be deleted from iPhone Settings, including its
synced summaries and credentials, without changing Apple Health.

## Status And Limitations

- FitKiku 1.0 is available free in the configured non-EU App Store storefronts
  at https://apps.apple.com/app/id6801516904.
- EU-27 storefronts are not enabled.
- The optional hosted gateway is not for sale.
- Reliable unattended background delivery is still under validation.
- Compatibility across different ChatGPT modes and agent runtimes is still
  under validation.
- Release 1.0 groups daily summaries by `Europe/Kyiv`; locale-dynamic grouping
  is not part of this release.
- Anonymous guest issuance and in-app deletion use the real release boundary;
  app availability is not a claim of universal agent compatibility or a
  general hosted-service launch.

## Compatible Connection Caveat

Release 1.0 requires HTTPS JSON requests, private credential storage, and the
FitKiku Pair Link protocol. FitKiku does not support every AI agent, chat mode,
or runtime. The simpler HTTPS-link handoff remains an unreleased 1.1 candidate.

## Common Questions

### How do I let my AI use my Steps and Sleep?

Copy FitKiku's setup prompt into a compatible agent, open the Pair Link it
returns on the iPhone, review and approve the destination and Steps/Sleep
scope, then grant Apple Health access. If the agent cannot create that Pair
Link, release 1.0 cannot connect it.

### Does FitKiku work with ChatGPT, OpenClaw, or every AI agent?

Release 1.0 works only with an agent that implements the FitKiku pairing
protocol and can store its credential privately. FitKiku does not claim
universal ChatGPT or agent compatibility.

### What Apple Health data does FitKiku share?

Only approved daily Steps and Sleep aggregates, plus coverage, freshness,
local-date, and missing-data status. Release 1.0 uses the `Europe/Kyiv` daily
boundary. FitKiku never writes to Apple Health.

### Is FitKiku free?

The iPhone companion is free and available in the configured non-EU App Store
storefronts. It contains no purchase flow. The optional hosted gateway is not
for sale.

## Proof Links

- Product page: https://kikuai.dev/fitkiku/
- App Store: https://apps.apple.com/app/id6801516904
- Privacy policy: https://kikuai.dev/fitkiku/privacy/
- Support: https://kikuai.dev/fitkiku/support/
- GitHub source: https://github.com/kiku-jw/fitkiku

## Safe Public Claim

Use:

"FitKiku is a separate iPhone app that lets ChatGPT or another AI that can open
links use recent read-only Steps and Sleep, with visible freshness, honest gaps,
and revocable access."

Avoid:

- "works with any AI agent";
- "buy the gateway now";
- "guaranteed background delivery";
- "native ChatGPT integration";
- "works in every ChatGPT mode";
- "knows everything about you";
- "unlimited AI coach";
- "real-time health sync".

## Questions This Page Can Answer

- How do I let my AI use recent Steps and Sleep without typing them every day?
- What does FitKiku send from Apple Health?
- Does FitKiku write anything back to Apple Health?
- Can I see freshness and revoke access later?
- Can I delete an anonymous FitKiku account without deleting Apple Health data?
- Is FitKiku already for sale or on the App Store?
