Skip to content

ca-who-codes/fit.forge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ‹οΈ FitForge

Open-source Claude skills to forge your strongest, healthiest self.

An AI strength & nutrition coach you actually own β€” evidence-based, safety-first, and free.


FitForge is a collection of Claude skills + a curated knowledge base that turns Claude into a genuinely useful, honest fitness and nutrition coach. No app subscription, no upsells, no "shredded in 30 days" nonsense. Just the boring fundamentals that work, applied to your life, equipment, diet, and schedule.

It's built for everyone: total beginners, returning lifters, busy parents, desk workers, vegetarians and vegans, people training at home with nothing, and folks who just want more energy and fewer aches.

✨ What it does

  • πŸ—“οΈ Builds your training program β€” periodized, progressive, matched to your goal, equipment, and time.
  • πŸ₯— Coaches your nutrition β€” calorie & macro targets plus realistic meal plans (incl. veg / Indian / budget options).
  • πŸ“ˆ Runs weekly check-ins β€” reads your data, adjusts the plan, and keeps you honest.
  • 🀸 Fixes your form β€” cues, common mistakes, and easier/harder variations for any lift.
  • 🧠 Builds the habit β€” behavior design so you actually stick with it past week three.
  • 😴 Manages recovery β€” sleep, stress, soreness, deloads, and "should I train today?" calls.

All of it grounded in a vetted knowledge base, with hard safety guardrails baked into CLAUDE.md β€” it knows when to tell you to see a doctor.

πŸš€ Quick start

Option A β€” Claude Code (recommended)

git clone https://github.com/<your-username>/fitforge.git
cd fitforge
claude            # Claude Code auto-loads CLAUDE.md and the skills in .claude/skills/

Then just talk to it:

"I'm a 30yo beginner, 3 days a week, only dumbbells at home, want to build muscle. Build me a plan."

Option B β€” Claude.ai / Projects

Create a new Project, paste CLAUDE.md into the custom instructions, and upload the knowledge/ files as Project knowledge. Copy any skill you want from .claude/skills/.

πŸ”Œ Connections (optional, but powerful)

Hook up real data so FitForge stops guessing β€” wearables (Apple Health, Garmin, Whoop, Strava), food logging (Open Food Facts, USDA), and tracking (Notion, Google Sheets). See connections/README.md.

πŸ“š Repo layout

fitforge/
β”œβ”€β”€ CLAUDE.md                  # The coach's brain: philosophy, safety, how it behaves
β”œβ”€β”€ knowledge/                 # Vetted reference the coach reasons from
β”‚   β”œβ”€β”€ training-science.md
β”‚   β”œβ”€β”€ nutrition-science.md
β”‚   β”œβ”€β”€ exercise-library.md
β”‚   └── safety-red-flags.md
β”œβ”€β”€ .claude/skills/            # The skills
β”‚   β”œβ”€β”€ build-training-program/
β”‚   β”œβ”€β”€ nutrition-coach/
β”‚   β”œβ”€β”€ progress-review/
β”‚   β”œβ”€β”€ form-coach/
β”‚   β”œβ”€β”€ habit-architect/
β”‚   └── recovery-readiness/
└── connections/               # MCP / integration setup guide

🀝 Contributing

PRs welcome β€” new skills, better exercise cues, regional meal templates, translations, more connections. Keep two rules: (1) evidence-based, and (2) safety-first (read the guardrails in CLAUDE.md). Cite sources for any factual claims in the knowledge base.

⚠️ Disclaimer

FitForge is open-source educational software, not medical advice. It does not diagnose, treat, or prescribe. Always consult a qualified physician, physiotherapist, or registered dietitian before starting any exercise or nutrition program β€” especially if you have a health condition, are pregnant, or are returning from injury.

πŸ“„ License

MIT β€” see LICENSE. Build on it, remix it, share it.

About

πŸ‹οΈ FitForge β€” open-source Claude skills to forge your strongest, healthiest self. An evidence-based, safety-first AI strength & nutrition coach you actually own.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors