| name | 10x-cli-guide |
| description | 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, or working on a specific OS (Windows, Linux, macOS). Covers commands (get, list, doctor, auth --status/--logout), tool profiles, artifact locations, common errors, and platform-specific tips. Excludes: first-time installation and onboarding (use 10x-cli-setup instead), developing or contributing to 10x-cli source code, and general programming help. |
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 -1
Also 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 --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.
10x get m1l1
10x get m2l3
10x get m1l1 --dry-run
10x get m1l1 --tool cursor
10x get m1l1 --lang pl
Filtering artifacts:
10x get m1l1 --type skills
10x get m1l1 --type skills --name code-review
10x get m1l1 --print --type skills --name code-review
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> |
| 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
10x list m1
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.
10x doctor
10x doctor --json
Exit code 78 means at least one check failed.
10x auth — Session management
10x auth
10x auth --status
10x auth --logout
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.
Switching Tools
To change your AI tool (e.g., from Claude Code to Cursor):
10x get m1l1 --tool cursor
The 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.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
10x doctor
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
10x get m1l1 --verbose
10x doctor --verbose
This 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 auth
On Windows (PowerShell):
Remove-Item -Recurse -Force "$env:APPDATA\10x-cli"
10x auth
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.
