10x Cli Guide
Learn day-to-day 10x-cli commands, tool profiles, artifact paths, and OS-specific troubleshooting after install and auth are done.
Overview
10x-cli-guide is an agent skill for the Build phase that explains day-to-day 10x-cli usage—commands, profiles, artifacts, and OS-specific troubleshooting after setup.
Install
npx skills add https://github.com/przeprogramowani/10x-cli --skill 10x-cli-guideWhat is this skill?
- Covers get, list, doctor, and auth --status / --logout—not installation (hand off to 10x-cli-setup)
- Step 1 silently detects OS via OSTYPE and tailors paths, shells, clipboard, and temp dirs
- Documents tool profiles and switching AI tools for lesson fetch workflows
- Explains where artifacts land and common error recovery on Windows, Linux, and macOS
- Explicit exclusion: no 10x-cli source contribution or generic programming help
- OS matrix covers macOS, Linux, and Windows shell/path/clipboard variants
- Commands emphasized: get, list, doctor, auth --status, auth --logout
Adoption & trust: 1.6k installs on skills.sh; 31 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have 10x-cli installed but keep hitting wrong paths, auth confusion, or platform-specific errors when fetching lessons or switching AI tools.
Who is it for?
Solo learners using 10x-cli with multiple AI editors who need quick, environment-aware command help without reinstall docs.
Skip if: First-time install and authentication (use 10x-cli-setup), contributing to 10x-cli source, or general language tutorials unrelated to the CLI.
When should I use this skill?
User asks how to USE 10x-cli day-to-day—lessons, modules, tool switching, errors, artifact locations, or OS-specific tips—not first-time install.
What do I get? / Deliverables
You run the right get, list, and doctor flows with tool profiles and artifact locations matched to your OS, or you are directed to 10x-cli-setup if install/auth is missing.
- OS-tailored command guidance
- Artifact location and profile switching steps
- Troubleshooting paths for common CLI errors
Recommended Skills
Journey fit
Build fits because the skill supports ongoing use of a learning CLI alongside agent workflows—not first-time setup or unrelated programming tutoring. Agent-tooling is the shelf for configuring and operating CLI tools that feed lessons, modules, and artifacts into coding agents.
How it compares
Daily operations companion to 10x-cli-setup—usage and troubleshooting, not onboarding.
Common Questions / FAQ
Who is 10x-cli-guide for?
Indie builders and students who already use @przeprogramowani/10x-cli with coding agents and need command-level help on their specific OS.
When should I use 10x-cli-guide?
When you ask how to use 10x-cli day-to-day: get lessons, list modules, doctor, auth status, logout, tool profiles, artifact locations, or fix CLI errors on Windows, Linux, or macOS.
Is 10x-cli-guide safe to install?
It is documentation-oriented; review the Security Audits panel on this page and treat auth tokens like any local CLI secret.
Workflow Chain
Then invoke: 10x cli setup
SKILL.md
READMESKILL.md - 10x Cli Guide
# 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 ```bash 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 ```bash 10x doctor --json 2>/dev/null | head -1 ``` Also check which tool profile is configured: ```bash 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 ```bash 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. ```bash 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:** ```bash 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 co