10x-cli-guide

$28

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 — 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 content

Filtering 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 stdout

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       # Show all modules with lock state

10x list m1    # Show lessons in module 1

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          # Human-readable output

10x doctor --json   # Machine-readable for scripting

Exit 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 credentials

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.