About
Switchback Running is a free, open-source AI-powered training companion designed specifically for self-coached ultra trail runners. It bridges your wearable data and exercise science by connecting to your Intervals.icu account — which syncs from Garmin, Suunto, COROS, Apple Watch, or Strava — and feeding that data into an AI agent running locally in your terminal. The companion reviews your running log, flags recovery concerns, helps you adjust weekly training loads, and builds race-day plans — all anchored in evidence-based methodologies from respected coaches and authors like Steve Magness, Jason Koop, and the Uphill Athlete team. A curated knowledge base covering aerobic base building, periodization, volume progression, taper protocols, nutrition, injury prevention, heat and altitude adaptation, and more is baked in before any recommendation is made. Switchback is designed to be personalized: during setup you choose your companion's name, tone, and personality — from casual and humorous to analytical and structured. It works with Gemini CLI (free, no credit card needed), Claude Code, Codex CLI, or OpenClaw, making it model-agnostic. The tool is explicitly not a replacement for a real coach or medical professional, but rather a knowledgeable companion for the many runners who train alone and want more than a static plan. Released under the MIT License and actively maintained on GitHub, it's ideal for tech-comfortable ultra runners who value data-driven, science-backed training guidance.
Key Features
- Intervals.icu Integration: Syncs your training data from Garmin, Suunto, COROS, Apple Watch, or Strava via Intervals.icu to give the AI a full picture of your running history.
- Exercise-Science Knowledge Base: A built-in knowledge base covering periodization, taper protocols, injury prevention, nutrition, altitude adaptation, and more — drawn from leading ultra running coaches and authors.
- Model-Agnostic AI Agent: Works with Gemini CLI (free), Claude Code, Codex CLI, or OpenClaw, so you can use the AI backend of your choice.
- Customizable Companion Personality: Choose a name, tone, humor level, and style for your companion during setup — casual or analytical, brief or detailed, fired up or methodical.
- No-Code Terminal Installer: A guided shell installer handles all setup steps automatically — no coding or developer experience required.
Use Cases
- An ultra trail runner without a personal coach reviews their last training week, flags signs of overtraining, and gets science-backed suggestions for adjusting load.
- A self-coached runner preparing for a 100-mile race uses Switchback to build a periodized training plan with taper protocols aligned to their race date.
- A runner returning from injury consults their Switchback companion to gradually rebuild volume while monitoring recovery metrics from their Intervals.icu data.
- A trail runner new to structured training uses the built-in knowledge base to understand concepts like aerobic base building, workout types, and long run pacing.
- An experienced ultrarunner customizes a companion named after their favorite training partner and uses it daily for conversational workout debriefs and race-day prep.
Pros
- Completely Free and Open Source: Released under the MIT License with no subscription or credit card required when using Gemini CLI as the AI backend.
- Grounded in Established Science: Every recommendation is anchored in a curated exercise-science knowledge base drawn from respected coaches, reducing the risk of bro-science or generic advice.
- Model-Agnostic Flexibility: Supports multiple AI agent backends, so users aren't locked into one provider and can use tools they already have.
- Highly Personalized Experience: Customizable companion name, tone, and style make the tool feel tailored rather than generic, improving long-term engagement.
Cons
- Terminal-Only Interface: Runs exclusively in a command-line terminal, which may be a barrier for runners who are not comfortable with CLI tools.
- Not a Substitute for a Real Coach: Explicitly not medical or professional coaching advice — runners with complex needs or injuries should work with qualified professionals.
- Requires Intervals.icu Account: Depends on Intervals.icu as the data layer, so users must set up and maintain that account in addition to Switchback.
Frequently Asked Questions
Is Switchback Running free to use?
Yes. Switchback Running is completely free and open-source under the MIT License. When paired with Gemini CLI as the AI backend, no credit card is required at all.
What devices and watch platforms are supported?
Any device that syncs to Intervals.icu is supported, including Garmin, Suunto, COROS, Apple Watch, and Strava-connected devices.
Do I need to know how to code to use it?
No. A guided shell installer handles all setup steps automatically. Once installed, you simply type 'switchback' in your terminal to start.
Which AI agents does Switchback work with?
Switchback works with Gemini CLI (free, no credit card needed), Claude Code, Codex CLI, and OpenClaw. The AI agent acts as the brain while Switchback provides the training science layer.
Is Switchback only for ultrarunners?
While designed with ultra trail runners in mind, the underlying exercise science and training principles are broadly applicable to endurance runners of all distances.
