# cyclst

> Personal cycling coach — training insights, plans, and reflections based on your real data.

## Overview

cyclst is a terminal-style web app at https://cycl.st. Connect your training platform, sync your rides, and interact with your coach through slash commands. cyclst analyzes activity metrics (power, heart rate, duration, distance) and your goals to generate coaching feedback. No GPS data is sent to AI providers.

## How it works

1. Create an account (/register) and connect Intervals.icu (/setup intervals).
2. Sync your activities (/sync).
3. After a ride, reflect on how it felt (/reflect) — the coach analyzes your effort and suggests what to do next.
4. Get a multi-day training outlook (/plan) and check today's session (/today).
5. Life happens — adjust your plan on the fly (/adapt).
6. Set goals (/goals) to steer your training direction.

## Commands

/register — Create an account
/login — Log in
/setup intervals — Connect Intervals.icu
/sync — Sync activities (options: --since=12m, --since=all)
/list — List recent activities (options: --all, --limit=N, --last)
/reflect — Reflect on your last ride
/plan — Training plan for the next few days
/today — Today's planned session
/adapt — Adjust your current plan
/goals — View, add, or remove training goals
/feedback <message> — Send feedback to the team
/help — Show all commands
/clear — Clear the terminal

## Integrations

- Intervals.icu — fully supported
- Strava — coming soon

## MCP Server

cyclst-mcp-server (npm) lets MCP-compatible AI assistants access your training data. Tools: list_activities, sync_activities, list_connections. Setup: https://cycl.st/mcp

## API

REST API at https://cycl.st/api/v1/. Auth via Bearer API key. Docs: https://cycl.st/api/docs

## Links

- Home: https://cycl.st
- Commands: https://cycl.st/commands
- FAQ: https://cycl.st/faq
- MCP: https://cycl.st/mcp
- API docs: https://cycl.st/api/docs
- Legal: https://cycl.st/legal

## Contact

info@cycl.st