Repository navigation
Releases
0.29.1
Pahlavan 0.29.1 makes the coach a Claude Code plugin: it installs in two commands, and Claude Code keeps it up to date.
New in 0.29.1
-
Install the coach in two commands. In a terminal:
claude plugin marketplace add saeed1262/pahlavan claude plugin install pahlavan@pahlavanThen open a folder for your training in Claude Code and type
/fitness-coach intake. The coach is there in every folder you open, andclaude plugin update pahlavan@pahlavanupdates it. The zip below,pahlavan-coach-0.29.1.zip, is still here, for a folder that carries its own coach. Pahlavan without Obsidian gives both ways, step by step. -
The coach finds its engine wherever it's installed: in your vault, in the zip's folder, or as a plugin. Nothing changes in how you use it.
-
A privacy policy, in one page: what stays in your files, and what Claude Code sends to Anthropic.
The changelog has the details.
Update
- The plugin: Obsidian, Settings, Community plugins, then update Pahlavan.
- The coach: Home shows Update the coach under Needs you; press it (it's also in Pahlavan's settings, the Coach section).
- Without Obsidian: install the plugin as above, or download the zip and replace your folder's
.claude/skills/fitness-coachwith the one inside it. Your files stay as they are.
0.29.0
Pahlavan 0.29.0 brings the coach to Claude Code on its own, without Obsidian, gives the plugin a name people search for, estimates your meals from a photo or a description, and adds grips to the pulls, presses and curls.
New in 0.29.0
- The coach without Obsidian. Download
pahlavan-coach-0.29.0.zipbelow and double-click it: you get aPahlavanfolder. Open it in Claude Code and type/fitness-coach intake. The whole coach works in chat (your plan and its reasons, logging, a morning check-in, the Sunday check-in and letter, the reviews, an eating plan, daily habits), with the same engine and the same files. To add the screens later, open the same folder as a vault in Obsidian and install Pahlavan. New to Claude Code? Pahlavan without Obsidian walks through it step by step. - A morning job:
/fitness-coach todaygives today's session with its targets, what's due, and a short morning check-in, "I'm ill today" included. - Meals from a photo or a description:
/fitness-coach meal. Send a photo of a meal or say what you ate. The coach estimates its protein, calories, fiber, fat and carbs, shows your day so far, and saves it after your yes; the photo itself is never kept. When the day reaches your protein target, Protein ticks itself. The numbers are the coach's estimates, said with "about": a weight or a label you give makes them better. - Log a meal in Obsidian: Log a meal on the Food tab (or in the command palette) saves what you ate, with a photo if you like, for your coach to estimate next time you talk to it. The Food tab's new Meals card shows today's estimates against your protein target, and the meals still waiting. A photo stays only until your coach has read it, and never goes into git.
- Change or delete a logged session in chat, and pause, resume or remove a tracked item. The coach does what the Log and Habits screens do, through the same writers.
- A new name in the directory: Pahlavan - Fitness Workout and Health Coach. Commands keep their ids, so your hotkeys still work.
- Grips. Fourteen pulls, presses and a curl list the grips that change their path, each with its own setup line. Name one in your plan in parentheses, such as "Lat Pulldown (close neutral grip)": the muscles still count, and it keeps its own history, since the weights differ by grip. They show in the Movements tab's guide and the exercise catalogue.
- A repeat takes a different path. The plan check notes two movements on the same path in one session (pull-ups and a lat pulldown, both overhand) and one accessory on two days of the week, so your coach gives the repeat another grip, angle or tool, kept for the block.
- One question for you. Your first Sunday letter of a cycle asks what would make Pahlavan better, and drafts it as an issue for you to post if you like. Nothing is sent.
Fixed: a session's target follows the rep range its row shows. An exercise whose entry in the plan's lift table held another range (a bench at 8 to 12 from an earlier plan, now 10 to 15) targeted the old one.
The changelog has the details.
Update
- The plugin: Obsidian, Settings, Community plugins, then update Pahlavan.
- The coach: Home shows Update the coach under Needs you; press it (it's also in Pahlavan's settings, the Coach section).
- Without Obsidian: download the zip and replace your folder's
.claude/skills/fitness-coachwith the one inside it. Your files stay as they are.
0.28.2
Pahlavan 0.28.2 is a small cleanup. The stylesheet now passes the warnings Obsidian's automated review raised on 0.28.1, and the screens look the same.
Changed in 0.28.2
Cleaner styles. The changes Obsidian's automated review of 0.28.1 asked for in the stylesheet. The one thing you might notice: a link's underline now takes the link's own colour.
Reduce motion. Home's opening animation now runs only when your system allows motion. With Reduce motion on, Home opens without it, as before.
Progress in a narrow pane. The cards still read one under the other in the same order. Pahlavan now lays them out that way itself when the pane is narrow.
The changelog has the details.
Update
The plugin: Obsidian, Settings, Community plugins, then update Pahlavan.
The coach: Home shows Update the coach under Needs you; press it (it's also in Pahlavan's settings, the Coach section).
0.28.1
Pahlavan 0.28.1 is a small update. Your week no longer stacks three lifting days, a snoozed reminder opens when you ask for it, and the code now passes Obsidian's automated review.
Fixed in 0.28.1
- No third lifting day in a row. If your week slipped a day (lifting on Tuesday and Wednesday, say), Today still offered the next lift on Thursday. Now it offers your next short session and says why, while the week still has short sessions to do. Once they're done, the lift stays, and Change session still offers it. A week on schedule looks the same as before.
- Answer opens a snoozed card. In Due today, Answer on a snoozed card ("Did you train today?") said the card wasn't due. It now opens it.
- Cleaner code. The changes Obsidian's automated review of 0.28.0 asked for. Nothing you see changes.
The changelog has the details.
Update
- The plugin: Obsidian, Settings, Community plugins, then update Pahlavan.
- The coach: Home shows Update the coach under Needs you; press it (it's also in Pahlavan's settings, the Coach section).
0.28.0
Pahlavan 0.28.0 adds a Movements tab, logs every set with one tap, puts your targets on the weights your gym actually has, and shows why your plan is built the way it is. You can now try it in your browser before you install: the real screens on a made-up athlete, nothing to install, and nothing sent anywhere.
Your coach also plans differently. A new plan starts from a blank page, from your answers and the evidence, not as an edit of the plan you're on. At each review it plans the next block like a coach: from the long-term plan and what the last block's numbers show, keeping a movement only when the data earns it.
New in 0.28.0
- Try it in your browser. The demo runs every tab, the Log panel and the settings on a made-up athlete. What you change stays in the page until you reload.
- Movements, a seventh tab. Search every movement as you type (a name, a muscle or a tool), filter by group, muscle, level or your own equipment, and open each one's guide. Also from the command Pahlavan: Browse movements.
- Every set, one tap a set. In the Log panel's Every set, tap a set's number once it's done as shown. Sets start from your target or from last time, supersets get a row per part, and the weight goes up only when every set of the day reaches the top.
- Targets on your gym's real weights. Tell your coach the dumbbells, plates and machine steps your gym has, and every target lands on one of them. At the heaviest dumbbell, reps carry the progress instead.
- Why this plan. A card on the Plan tab gives your coach's reasons for your plan, each with how strong its evidence is, and the kinds of split it left out, with why.
- Your coach decides your priority muscles. What you care about most is one input; the coach ranks the priorities from your assessment (photos, posture, the movement self-check, pain and goals), each with its reason, and you confirm or change them.
- Your coach counts skips, swaps and pain. Each review has the facts for every exercise: how often it was skipped or swapped and why, when it last improved, and the pain reported on it.
- HRV and "I'm ill today" in the morning check-in. A low HRV two mornings running gets a note; a sick day stops hard training for that day.
- Using Pahlavan? Say hi. Pahlavan counts nothing about you, so a reply in the pinned issue is how I know who uses it. The welcome card links it too.
Your plan stays as it is until you ask your coach for a new one or reach a review. Your coach asks for your gym's weights at your next plan run. The changelog has every change.
Update
- The plugin: Obsidian, Settings, Community plugins, then update Pahlavan.
- The coach: Home shows Update the coach under Needs you; press it (it's also in Pahlavan's settings, the Coach section).
0.27.0
Pahlavan now opens on Home, an overview in plain words: today's session, what needs you, and how you're doing, each a click away from the tab with the detail. The coach has 244 movements to choose from (it was 100), each with how to set up, do it and what to avoid.
This release also brings everything from 0.26.0, which wasn't released on its own: your coach designs the plan and the engine checks it, muscles have regions where the evidence supports them, and a finding from your photos or self-check is a question for you before it changes anything.
New in 0.27.0
- Home, the first tab. Today's session with its length, what your morning check-in changes and any swap, the week's ring, Needs you (up to three things to do or check), Food and habits, Progress in one sentence and three small pictures, and Your tabs: what each tab is for and where it stands. No jargon, no legends.
- The exercise library. 244 movements, including calisthenics and bodyweight progressions, each with its muscles, regions, tools, easier and harder versions, and guide text, plus 24 ladders.
- A readable exercise catalogue. The whole list in docs/exercise-catalogue.md, and in your vault through the new command Pahlavan: Write the exercise catalogue.
- Ladders count at your starting level. A plan can say which level a ladder starts at, so its weekly sets are right before you log a level.
- Beta user since. Pahlavan records the day you install it, shown in its settings. It's free during the beta; 1.0 will be paid, and everyone who installs before 1.0 keeps it free. The date stays in your vault; nothing leaves your Mac.
From 0.26.0
- The coach designs, the engine checks. The coach designs your plan from your answers and Pahlavan's evidence library; the engine does the numbers, checks the plan against the safety rules and the evidence, and follows the rules the coach writes.
- Muscle regions. Front, side and rear delts, the quads' and hamstrings' parts, the calves, the triceps' long head, the upper chest and more, each graded by its evidence. Ideas the evidence doesn't support, such as the inner chest, are explained with the nearest option.
- Findings are confirmed first. Nothing from your photos or self-check rules out a movement until you say it holds.
Your numbers may change. Sets per muscle now use the engine's muscle tags, hamstrings are no longer credited from squats, the leg press, bridges and hip thrusts, and the calibration week (plan week 1) holds your weights at 3 reps in reserve. The changelog has the details.
Update
- The plugin: Obsidian, Settings, Community plugins, then update Pahlavan.
- The coach: in Pahlavan's settings, the Coach section's Set up the coach updates it.
0.25.2
- Needs Obsidian 1.7.2 or later (it was 1.5.0). Pahlavan opens its tab with Obsidian's
revealLeaf, which since 1.7.2 waits for the tab to load; the directory's review asks the declared minimum to cover it. Obsidian 1.7.2 came out in October 2024.
0.25.1
Changes from the community directory's automated review. Nothing you do in Pahlavan changes.
- Popout windows: the screens are built on the window in use (Obsidian's
activeDocument) and their timers run on it, as Obsidian's guidelines ask. - The open command is now Pahlavan: Open in the command palette (it was "Pahlavan: Open Pahlavan").
- For developers:
npm run buildbuilds the plugin, the same on any system (the engine alone isnpm run build-engine);package-lock.jsonlists every dependency, sonpm ciworks; the preview builds from the public repository; the code passes Obsidian's lint rules, with two exceptions: the coach's command-line engine runs outside Obsidian, whereVault#configDirdoesn't exist, and the settings don't yet use Obsidian 1.13's settings search.
0.25.0
The first public version of Pahlavan, free while it's in beta. It was built and used in private before this, from 0.1 to 0.24.
- The plugin: Today (the session, how to do each movement and why it's in your plan, a checklist, the log), Progress (your week, strength over time, the body record and photos, your habits with 4-week charts for sitting, stand-ups and desk breaks), Plan, Check-in, Food, and reminder cards with quiet hours.
- The coach: the
/fitness-coachskill for Claude Code (intake, plan, logging, the Sunday check-in and letter, reviews, progress reports, an eating plan, habits), set up from Pahlavan's welcome card or its settings. - Licence: the Elastic License 2.0. The code is open to read, use and change; it can't be offered as a service, have a licence key removed or got around, or lose its notices.
- Calls are not detected: a stand-up or sitting count treats a call without typing as time away. Pausing during calls, through a small helper program you choose in the settings, is planned for a later version.