10x-cli

CLI tool for 10xDevs course content. Fetch and apply AI coding skills, prompts, and configs directly into your workspace.

Install

# npm (recommended)
npm install -g @przeprogramowani/10x-cli

# Or download a standalone binary from GitHub Releases
# https://github.com/przeprogramowani/10x-cli/releases

Agentic Installation

Let your AI coding agent handle the setup. This repo ships a 10x-cli-setup skill that walks your agent through installing, authenticating, and configuring the CLI — all driven by the latest README.

Install the skill with skills.sh:

# Add the skill to your current project (symlinked)
npx skills add przeprogramowani/10x-cli

# Or install globally so it's available in every project
npx skills add przeprogramowani/10x-cli -g

# Target a specific agent
npx skills add przeprogramowani/10x-cli -a claude-code
npx skills add przeprogramowani/10x-cli -a cursor

Once installed, just tell your agent to set up 10x-cli and it will pick up the skill automatically.

Quick Start

10x auth        # Authenticate with your email
10x list        # Browse available modules and lessons
10x get m1l1    # Fetch and apply lesson artifacts
10x doctor      # Check everything is working

Commands

| Command | Description | |---------|-------------| | 10x auth | Magic-link login with your Circle-registered email | | 10x list | Browse modules and lessons in your course | | 10x get <ref> | Fetch a lesson and apply artifacts to your workspace | | 10x doctor | Diagnose auth, API connectivity, and local config |

10x get Flags

| Flag | Description | |------|-------------| | --tool <tool> | AI coding tool: claude-code, cursor, copilot, codex, generic | | --print | Output artifact content to stdout instead of writing files | | --type <type> | Filter by artifact type: skills, prompts, rules, configs | | --name <name> | Filter by artifact name (requires --type) | | --dry-run | Show what would be written without touching the filesystem | | --course <slug> | Override the course slug (default: 10xdevs3) |

Examples

# Fetch full lesson — writes skills, prompts, rules, configs
10x get m1l1

# Write only skills (skip prompts, rules, configs)
10x get m1l1 --type skills

# Write a single artifact
10x get m1l1 --type skills --name code-review

# Print to stdout (pipe-friendly)
10x get m1l1 --print --type skills --name code-review
10x get m1l1 --print --type skills --name code-review | pbcopy

# Use with a different AI coding tool
10x get m1l1 --tool cursor

Global Flags

• --json — Machine-readable JSON output (auto-detected when piped)
• --verbose — Request/response diagnostics on stderr
• --version — Print CLI version
• --help — Show help

Lesson References

Lessons are referenced by module and lesson number:

• m1l1 — Module 1, Lesson 1
• m2l3 — Module 2, Lesson 3

Multi-Tool Support

On first run, the CLI prompts you to choose your AI coding tool. Artifacts are written to the correct directory for your tool:

| Tool | Directory | Rules file | |------|-----------|------------| | Claude Code | .claude/ | CLAUDE.md | | Cursor | .cursor/ | .cursor/rules/10x-course.mdc | | GitHub Copilot | .github/ | .github/copilot-instructions.md | | Codex CLI | .agents/ | AGENTS.md | | Generic | .ai/ | AGENTS.md |

Override anytime with --tool <name>. Your choice is saved in ~/.config/10x-cli/config.json.

Development

bun install
bun run dev -- --help       # Run CLI from source
bun run build               # Build dist/index.mjs (node target)
bun run build:binary        # Build standalone binary (~59MB)
bun test                    # Run tests
bun run typecheck           # tsc --noEmit
bun run lint                # oxlint

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feat/my-feature)
3. Commit using conventional commits (feat:, fix:, etc.)
4. Push and open a pull request

CI runs lint, typecheck, tests, and build checks on every PR. Releases are automated on merge to master via conventional-commit analysis.

License

MIT