# AgStatus Privacy Policy

_Last updated: July 9, 2026_

AgStatus is an open-source status board for coding agents (such as Claude
Code). This policy covers the AgStatus iOS app and the hosted AgStatus
server operated by the project maintainer.

## The short version

- **No accounts.** There is no sign-up, no email, no password. A board is
  identified only by an unguessable random token.
- **Minimal data.** The server stores only what your own machine sends it:
  a session id, a project folder name, a status word, and a short status
  message. Nothing else is collected.
- **Short retention.** On the hosted server, sessions are deleted
  automatically 24 hours after their last update. Boards untouched for 60
  days are deleted entirely.
- **No tracking.** No analytics, no advertising identifiers, no third-party
  SDKs. The app talks only to the status-board server you configure.
- **You can delete everything at any time.**

## What the server stores

When you wire up the hooks (`npx agstatus init`), your machine sends the
server small status updates as you work:

| Field | Example | Notes |
| --- | --- | --- |
| Session id | `9f3c…` | Generated by your coding tool |
| Project | `my-repo` | The folder name of the project |
| Status | `coding` | One of six fixed words |
| Message | `npm test` | A short activity description, truncated |

By default the message can include a **truncated command line** (up to 120
characters) so the board is informative. If you prefer not to send command
text, run `npx agstatus init --minimal` — messages then contain only tool
names (e.g. "Bash").

Data is stored under your board's token and is visible to anyone who has
your board URL. Treat the URL like a secret.

## Push notifications

If you enable push notifications in the app, notifications are delivered
through Apple's push service (APNs). A notification payload contains only the
session name and its short status message — the same text the hook already
sent to your board. Your device's push token is stored under your board and
is deleted when you turn notifications off, when the token expires, or when
the board is deleted.

## What the app stores on your phone

The AgStatus iOS app stores your board's URL and token in the iOS Keychain
on your device. It sends network requests only to your board's server. The
demo mode is entirely local and sends nothing anywhere.

## Retention and deletion

On the hosted server:

- Sessions expire **24 hours** after their last update.
- Boards idle for **60 days** are deleted with all their data.
- You can delete a board and all its data immediately, at any time, from the
  app (Settings → "Delete board") or with one request:
  `curl -X DELETE https://<server>/w/<token>`

## Self-hosting

AgStatus is open source. You can run the entire server yourself, in which
case no data ever reaches the hosted instance. See the
[self-hosting guide](self-hosting.md).

## Contact

Questions or concerns: open an issue at
[github.com/KardanovIR/claude-status-dashboard](https://github.com/KardanovIR/claude-status-dashboard/issues).