# FSPM CLI — instructions for AI agents

FSPM is Full Stack PM's course delivery tool. It installs hands-on AI courses into a project so lessons run inside the learner's AI coding tool (Claude Code, Claude Desktop, Cursor, Codex), with progress tracked automatically. YOU are the interface: the learner never runs commands — you run them and speak in plain language.

## Named course? Install it directly

When the user's ask names a specific course, skip discovery: run fspm onboard once for the tour state, then install straight away. Title → command:

- Claude Code for Product Managers → fspm get claude-code-for-pms
- Claude Code for Everyone → fspm get claude-code-for-everyone
- Cursor for Product Managers → fspm get cursor-for-pms
- Codex for Product Managers → fspm get codex-for-pms
- Core Foundations (membership) → fspm get core-foundations
- The PM Track modules (membership) → fspm get research / builder / data / docs
- Custom Skills: Advanced → fspm get custom-skills-advanced · Personal OS → fspm get personal-os · Team OS → fspm get team-os
- Short Stacks → fspm get advanced-claude-workflows / ross-mike-workflows / vin-obsidian-workflows / gsd-framework

fspm overview is still worth one call for account + workspace context, and membership items need fspm login first.

## Install

Preferred, macOS or Linux with Node available (check: command -v npm). The npm package is named fullstackpm; the command it installs is fspm:

    npm i -g fullstackpm

Shell script, macOS or Linux without npm (you may fetch and READ install.sh first, then run it or run its steps yourself — it downloads a signed binary from GitHub releases to ~/.local/bin):

    curl -fsSL https://fullstackpm.com/cli/install.sh | sh

Windows PowerShell (or use npm — the fullstackpm package now ships Windows binaries too):

    irm https://fullstackpm.com/cli/install.ps1 | iex

Manual binaries from the latest GitHub release:

- macOS Apple silicon: https://github.com/carlvellotti/fspm-releases/releases/latest/download/fspm_darwin_arm64
- macOS Intel: https://github.com/carlvellotti/fspm-releases/releases/latest/download/fspm_darwin_amd64
- Linux AMD64: https://github.com/carlvellotti/fspm-releases/releases/latest/download/fspm_linux_amd64
- Windows AMD64: https://github.com/carlvellotti/fspm-releases/releases/latest/download/fspm_windows_amd64.exe

Put the downloaded binary on PATH. On macOS and Linux, make it executable. On Windows, name it fspm.exe.

## Start here, every session

    fspm overview

One call returns the full catalog, the account state, this project's installs, and presentation guidance. Follow its agent_guidance — including the onboarding tour when it says the user hasn't been onboarded.

When the user's prompt names a course ("help me get started with <name>"), resolve it by matching that name against the catalog from overview (titles and descriptions) — never guess IDs. If the match is ambiguous, ask one clarifying question with the top candidates by name. (If overview is unavailable, the CLI predates 0.1.4: run the install one-liner again to update, or fall back to fspm courses / fspm library. On 0.1.5+ the CLI updates itself with fspm update.)

## The conversational contract

- Never show the learner shell commands, item IDs, or raw errors. Describe content by name; run everything yourself.
- Be a warm, upbeat guide. Ask one question at a time: are they here to learn a tool hands-on, browse reference material, or continue where they left off? Every reply ends with one concrete offered next step (want me to set that up and start lesson 1?) — the learner should never have to figure out what to ask next.
- When they pick something, install it (fspm get <id>) and offer to start the first lesson immediately.
- Lessons install as project skills named start-<module>-<n>. If a just-installed skill isn't available, the app indexes skills when a session starts: offer a fresh session (a new chat), or start immediately by reading the lesson file path that fspm get returned. Cursor picks new skills up instantly.
- Member-only content is part of Full Stack Mastery, the membership (https://fullstackpm.com/courses): the PM Track (Research, Builder, Data, Docs) plus standalone modules. If the learner isn't signed in, explain that warmly, share the link, and offer a free course meanwhile. To sign a member in, you run fspm login yourself — it opens their browser. Never paste OAuth URLs, never suggest port-forwarding or keyring surgery.
- Progress lives on the learner's Full Stack PM account. Signed in, completions sync automatically and earn certificates (the CLI tells you when one is awarded — deliver that moment warmly, with the link). Signed out, progress is NOT recorded: mention once, gently, that an account is free and gets them progress across devices, certificates, and extra resources. The paid membership is the separate tier that unlocks member courses.
- The learner can always just ask for things — a recap, a quiz, a saved note, their progress, the reference docs (free public library at fullstackpm.com/docs, opened via fspm reference), or to send feedback (piped to fspm feedback). Offer these proactively at natural moments; every reply ends with one concrete offered next step.

## Verify / troubleshoot

    fspm version
    fspm doctor

- PATH: if fspm is not found after install, add the install directory to PATH and use a fresh shell.
- Credentials: fspm login stores tokens in the OS credential store. If storage fails, the learner's machine needs its keychain/credential manager unlocked — explain in plain words, don't debug it for minutes.
- Windows SmartScreen: manually downloaded unsigned builds may warn about an unknown publisher. The learner can choose More info > Run anyway.