Invoke this skill when the user asks how to USE the 10x-cli day-to-day — fetching lessons, listing modules, switching AI tools, troubleshooting errors, understanding where artifacts land, checking the 10xBench model leaderboard, or working on a specific OS (Windows, Linux, macOS). Covers commands (g

10x cli Daily Usage Guide This skill helps users work with @przeprogramowani/10x cli after it is already installed and authenticated. If the user has not installed or authenticated yet, hand off to the 10x cli setup skill instead. Step 1: Detect the user's environment Before giving any guidance, gather context silently — run these checks and remember the results. Do not print raw output to the user. Operating system Use the result to tailor path separators, shell syntax, and clipboard commands throughout your answers: OS Shell Home var Clipboard Temp dir macOS ( darwin ) zsh / bash $HOME pbcopy $TMPDIR Linux ( linux gnu ) bash / zsh $HOME xclip selection clipboard or xsel clipboard /tmp Windows ( win32 / MSYS / Git Bash) PowerShell / cmd %USERPROFILE% clip.exe %TEMP% Active AI tool Also check which tool profile is configured: If the config contains a "tool" key, that is the active profile. If not, the default is claude code . CLI version Step 2: Answer the user's question using the reference below Use the environment context from Step 1 to personalize every answer. Always use the OS appropriate shell syntax, paths, and commands. Never show macOS specific commands to a Windows user or vice versa. Command Reference 10x get <ref — Fetch and apply lesson artifacts The primary daily command. Fetches a lesson bundle from the API and writes skills, prompts, rules, and config templates to the project directory. Filtering artifacts: Where artifacts land (depends on the active tool profile): Tool Skills Prompts Rules file Config templates Claude Code .claude/skills/<name /SKILL.md .claude/prompts/<name .md CLAUDE.md .claude/config templates/<name Cursor .cursor/skills/<name /SKILL.md .cursor/prompts/<name .md .cursor/rules/10x course.mdc .cursor/config templates/<name GitHub Copilot .github/skills/<name /SKILL.md .github/prompts/<name .md .github/copilot instructions.md .github/config templates/<name Codex CLI .agents/skills/<name /SKILL.md .agents/prompts/<name .md AGENTS.md .agents/config templates/<name Devin Desktop .devin/skills/<name /SKILL.md .devin/prompts/<name .md AGENTS.md .devin/config templates/<name Generic .ai/skills/<name /SKILL.md .ai/prompts/<name .md AGENTS.md .ai/config templates/<name Re applying a lesson updates clean managed files and preserves local edits unless explicitly resolved. Config templates are create only. Course rules with local edits or an unknown baseline require explicit resolution, even with force or when opting out. Text outside the managed markers stays intact. Switching lessons accumulates downloaded artifacts. Cleanup is scoped to the lesson being updated and removes only unchanged files with known hashes and no remaining owner. User files, modified files and files without a baseline are preserved. 10x list [module] — Browse available content Locked modules show their unlock date. Use this to see what is available before fetching. 10x doctor — Diagnose problems Runs 5 checks: Auth status, API connectivity, Config directory, CLI version, and tool directory presence. Exit code 78 means at least one check failed. 10x auth — Session management Sessions refresh transparently — if a token is near expiry, the next command refreshes it automatically. You only need to re auth manually if the session has fully expired. 10x bench — 10xBench model leaderboard Shows the live leaderboard from [10xbench.ai](https://10xbench.ai) — AI models benchmarked on vibe coding the Przeprogramowani.pl website. Each row has the average score, number of runs, cost per run where measured, and the agent harness used. No authentication needed — this works before 10x auth . Data updates when new benchmark results are published; superseded model versions are already filtered out upstream. If it reports the leaderboard as unavailable, the site may be mid deploy — retry in a few minutes. Switching Tools To change your AI tool (e.g., from Claude Code to Cursor): The CLI will detect that artifacts from the old tool exist and offer three options: 1. Migrate (default) — transfer eligible managed files to the new profile, preserving modified or conflicting source files and their ownership. 2. Delete — remove only unchanged managed files with known hashes and no other owner; preserve user files and edits. 3. Keep both — retain the existing profile and dismiss its repeated orphan prompt. Tool switching cannot change a project's course edition. If profiles disagree about the course or a manifest is corrupt, preserve the files and resolve that conflict before writing. The tool choice is saved in the config file ( ~/.config/10x cli/config.json on macOS/Linux, %APPDATA%/10x cli/config.json on Windows). Future get commands will use the new tool without needing tool again. Platform Specific Tips Windows Use PowerShell (not cmd.exe). The CLI outputs ANSI colors and Unicode symbols that render correctly in Windows Terminal + PowerShell but may garble in legacy cmd. npx works fine : npx @przeprogramowani/10x cli get m1l1 — no global install needed. Node 20+ is the only prerequisite. Clipboard : Skills that copy to clipboard use clip.exe on Windows. If a skill outputs a clipboard command, it will fall back silently if clip.exe is unavailable. Config location : %APPDATA%\10x cli\config.json and %APPDATA%\10x cli\auth.json . The CLI creates these automatically. Path separators : The CLI uses Node's path.join() internally, so forward slashes in command output (like .claude/skills/code review/SKILL.md ) work fine on Windows — no need to convert them. Linux Clipboard : Skills use xclip selection clipboard or xsel clipboard . If neither is installed, clipboard operations fail silently. Install with sudo apt install xclip (Debian/Ubuntu) or sudo dnf install xclip (Fedora). Config location : ~/.config/10x cli/ (respects $XDG CONFIG HOME if set). macOS Clipboard : Skills use pbcopy — works out of the box. Config location : ~/.config/10x cli/ . Troubleshooting When the user reports a problem, follow this sequence: 1. Run doctor first This catches the most common issues. Read the output and address each failing check. 2. Common problems and fixes Symptom Likely cause Fix "You're not signed in" No auth or expired session 10x auth "Session expired" Token past expiry and auto refresh failed 10x auth (re login) API unreachable / timeout Network issue or API outage Check internet; retry in a few minutes "Module is locked" Content not yet released 10x list to see unlock date .claude/ not found (doctor fail) Running from wrong directory or wrong tool profile cd to project root; check 10x doctor json for which tool is configured "403 Forbidden" on 10x get Module locked or no membership Check 10x list for module state; verify enrollment Orphaned artifact prompt on get Switching tools mid lesson Choose "migrate" to move files, or "delete" to clean up Permission denied writing files Directory not writable Check directory permissions; on POSIX: chmod u+w <dir 3. Verbose mode for deeper debugging This prints request/response diagnostics to stderr, useful for diagnosing API or network issues. 4. Nuclear reset If config is corrupted: On macOS/Linux: On Windows (PowerShell): This clears auth and tool preference. The next 10x auth recreates everything. Important Principles Answer with the user's OS and tool in mind. Never show pbcopy to a Windows user. Never show %APPDATA% to a macOS user. Run 10x doctor before speculating. It catches 80% of issues. Don't guess command syntax from memory. If unsure about a flag or behavior, fetch the latest README: https://raw.githubusercontent.com/przeprogramowani/10x cli/refs/heads/master/README.md Distinguish tool profile issues from CLI issues. If artifacts land in the wrong directory, it is a tool profile question. If the command itself fails, it is a CLI/auth/network question. Course selection and project edition get , list , and sync select the explicit course first, then the project's edition, then the live API recommendation. A new project with only v3 access selects v3, with only v4 selects v4, and with both selects published, available v4. An unpublished v4 can leave v3 as the recommendation; network or backend failures are reported instead of falling back. Output includes the course and selection reason. The first validated write records { "version": 1, "course": "10xdevs4" } (or 10xdevs3 ) in the root .10x cli.json , shared across AI tool profiles. Existing supported v2/v3 manifests preserve their recorded edition. All profiles, including legacy Windsurf, must agree. Corrupt, unknown version, or conflicting manifests block writes and must be preserved for repair. Artifact names never infer an edition. Ordinary get and sync cannot change a bound project's edition. Start v4 in a separate directory while retaining the v3 project. Read only inspection of another entitled edition is allowed with course . Do not delete the binding or manifests to bypass an edition conflict. Course edition and manifest schema version are separate concepts. list , get print , get dry run , sync dry run , and doctor preserve project files and tool/language preferences, including interactive tool choices. Auth token rotation may update only the credential store. Failed download, signature, course, or path validation leaves a new project unbound. Once writing starts, its binding remains even if an I/O operation fails, so retry stays on the same edition. auth status and doctor distinguish token expiry from live course access. v3 compatibility and v4 rollout Upgrade the CLI to use v4 capabilities. Existing v3 users can continue auth , list , get and sync without compulsory course flags or project migration. A new v4 purchase does not switch a bound v3 project; create a separate directory for v4. Complete skill directories are installed, including references and scripts; print in human mode shows only SKILL.md and explains how to download the rest. The first v4 delivery release does not include a course edition migration command. Do not recommend deleting a binding or manifest to force another edition. Warnings about using old binaries on edition migrated projects belong to the later migration release. If v4 is unavailable, distinguish its publication/unlock state from course membership; do not claim that reinstalling or changing a tool grants access.

10x-cli-guide