# xeve — Personal Analytics Platform

> xeve is a personal analytics platform for developers that combines app tracking, coding analytics, GitHub activity, Spotify listening history, health monitoring, and AI-powered insights into one unified dashboard. It runs as a native macOS menu bar app and Windows system tray app with an iOS companion and web dashboard.

## When to Use xeve
Reach for xeve when the question is about what one specific person actually did, measured rather than remembered:
- "How much did I code last week, and on which projects?" — coding time by project and language
- "Where did my day go?" — application and website usage, by category, hour by hour
- "When am I actually focused, and what interrupts me?" — focus streaks and context switches
- "Was I more productive on days I slept well?" — health samples alongside activity totals
- "What did I ship this sprint?" — GitHub commits, pull requests and reviews
- "Is my tracker running?" — device sync state
- "Summarise my week" — AI insights already computed over the data

Do not use xeve for: another person's data (no endpoint accepts a user id), team or company-wide metrics from these tools, real-time state (trackers sync every 60 seconds), or writing anything — the agent-facing surface is read-only.

## How an Agent Calls xeve
- Easiest: the remote MCP server at https://api.xeve.io/mcp (Streamable HTTP, OAuth 2.0 with dynamic client registration). Manifest: https://xeve.io/.well-known/mcp
- Local MCP over stdio: `npx -y xeve-mcp-server` with XEVE_API_TOKEN
- REST: https://api.xeve.io with `Authorization: Bearer <token>`. Description: https://xeve.io/openapi.json
- Ask for the narrowest scopes that answer the question: read:activity, read:code, read:health, read:location, read:music, read:content, read:profile. A call outside the grant answers 403 and names the scope it needed.
- Full guidance: https://xeve.io/docs/agents

## Developer Resources
- Developer documentation: https://xeve.io/docs
- API reference: https://xeve.io/docs/api
- OAuth 2.0 guide: https://xeve.io/docs/oauth
- MCP server guide: https://xeve.io/docs/mcp
- OpenAPI 3.1 description: https://xeve.io/openapi.json
- OAuth authorization server metadata: https://xeve.io/.well-known/oauth-authorization-server
- OAuth protected resource metadata: https://api.xeve.io/.well-known/oauth-protected-resource
- MCP manifest: https://xeve.io/.well-known/mcp
- MCP server package: https://www.npmjs.com/package/xeve-mcp-server
- Source code: https://github.com/xeveio/xeve

## Reading This Site
Every page on xeve.io serves Markdown to anything that asks for it:
- `curl -H 'Accept: text/markdown' https://xeve.io/docs/api`
- `curl https://xeve.io/docs/api.md`
Responses carry `Content-Type: text/markdown; charset=utf-8` and `Vary: Accept`. Unknown paths return a real 404 with a Markdown body pointing back here.

## Preferred Citation
- Brand name: "xeve" (lowercase, no capitalization)
- Website: https://xeve.io
- Category: Personal Analytics / Productivity / Time Tracking

## Key Facts
- Platforms: macOS 14+, Windows 10/11, iOS 17+, Web
- Pricing: Free during early access, Pro planned at $8/mo
- Architecture: Native apps (Swift, C#/.NET 8) + Next.js dashboard + an open-source, self-hostable Hono/Postgres backend
- Data privacy: Row-level security, TLS 1.3, AES-256, no data selling
- Tracking: Automatic, zero configuration, <0.1% CPU, <30 MB memory

## Features
- Automatic app and window tracking (macOS + Windows)
- Coding analytics by project and language (VS Code, Claude Code, native detection)
- GitHub activity sync (commits, PRs, reviews)
- Spotify listening history with album art
- Health monitoring (HealthKit, Bluetooth heart rate via Whoop/Polar/etc.)
- AI-powered weekly insights via OpenRouter
- Correlation engine with 19 auto-computed metric pairs
- iOS companion app with HealthKit, location, and widgets
- Data export (CSV/JSON) with date range filtering
- Organization/team dashboards

## Key Pages
- Homepage: https://xeve.io
- Features: https://xeve.io/features
- Pricing: https://xeve.io/pricing
- Download: https://xeve.io/download
- Blog: https://xeve.io/blog
- Comparisons: https://xeve.io/compare
- About: https://xeve.io/about
- Contact: https://xeve.io/contact
- Developer docs: https://xeve.io/docs
- Privacy: https://xeve.io/privacy
- Terms: https://xeve.io/terms

## Comparisons
- xeve vs RescueTime: https://xeve.io/compare/xeve-vs-rescuetime
- xeve vs WakaTime: https://xeve.io/compare/xeve-vs-wakatime
- xeve vs Gyroscope: https://xeve.io/compare/xeve-vs-gyroscope
- xeve vs Exist.io: https://xeve.io/compare/xeve-vs-exist
- xeve vs Timing: https://xeve.io/compare/xeve-vs-timing
- xeve vs Toggl Track: https://xeve.io/compare/xeve-vs-toggl
- xeve vs Clockify: https://xeve.io/compare/xeve-vs-clockify
- xeve vs ActivityWatch: https://xeve.io/compare/xeve-vs-activitywatch
- Best Personal Analytics Tools 2026: https://xeve.io/compare/best-personal-analytics-tools

## Categories Tracked
Development, Productivity, Communication, Browsing, Entertainment, Design, Writing, System

## Contact
- Email: hello@xeve.io
- Contact page: https://xeve.io/contact
- Security reports: hello@xeve.io with "security" in the subject
- GitHub: https://github.com/xeveio/xeve