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
echo "$OSTYPE" 2>/dev/null || echo "win32"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
10x doctor --json 2>/dev/null | head -1Also check which tool profile is configured:
cat ~/.config/10x-cli/config.json 2>/dev/null || cat "$APPDATA/10x-cli/config.json" 2>/dev/null || echo "{}"If the config contains a "tool" key, that is the active profile. If not, the default is claude-code.
CLI version
10x --versionStep 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.
10x get m1l1 # Fetch module 1, lesson 1
10x get m2l3 # Fetch module 2, lesson 3
10x get m1l1 --dry-run # Preview what would be written
10x get m1l1 --tool cursor # Use a different AI tool profile
10x get m1l1 --lang pl # Fetch Polish contentFiltering artifacts:
10x get m1l1 --type skills # Only skills
10x get m1l1 --type skills --name code-review # One specific skill
10x get m1l1 --print --type skills --name code-review # Print to stdoutWhere 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> |
| Generic | .ai/skills/<name>/SKILL.md | .ai/prompts/<name>.md | AGENTS.md | .ai/config-templates/<name> |
Re-applying a lesson overwrites skills and prompts if content changed, updates the rules sentinel block, but never overwrites config templates (they may contain user edits).
Switching lessons cleans up artifacts from the previous lesson that are not in the new one, keeps shared artifacts, and adds new ones.
10x list [module] — Browse available content
10x list # Show all modules with lock state
10x list m1 # Show lessons in module 1Locked 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.
10x doctor # Human-readable output
10x doctor --json # Machine-readable for scriptingExit code 78 means at least one check failed.
10x auth — Session management
10x auth # Start magic-link login
10x auth --status # Check current session
10x auth --logout # Clear credentialsSessions 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.
---
Switching Tools
To change your AI tool (e.g., from Claude Code to Cursor):
10x get m1l1 --tool cursorThe CLI will detect that artifacts from the old tool exist and offer two options:
- Migrate (default) — move all artifacts to the new tool's directories, remove the sentinel block from the old rules file.
- Delete — remove only 10x-managed artifacts from the old tool's directories. Your own files (e.g.,
.github/workflows/) are never touched.
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.exeon Windows. If a skill outputs a clipboard command, it will fall back silently ifclip.exeis unavailable. - Config location:
%APPDATA%\10x-cli\config.jsonand%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 clipboardorxsel --clipboard. If neither is installed, clipboard operations fail silently. Install withsudo apt install xclip(Debian/Ubuntu) orsudo dnf install xclip(Fedora). - Config location:
~/.config/10x-cli/(respects$XDG_CONFIG_HOMEif 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
10x doctorThis 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
10x get m1l1 --verbose
10x doctor --verboseThis prints request/response diagnostics to stderr, useful for diagnosing API or network issues.
4. Nuclear reset
If config is corrupted:
On macOS/Linux:
rm -rf ~/.config/10x-cli
10x authOn Windows (PowerShell):
Remove-Item -Recurse -Force "$env:APPDATA\10x-cli"
10x authThis 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
pbcopyto a Windows user. Never show%APPDATA%to a macOS user. - Run
10x doctorbefore 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.
