Back to Details

10x-cli-setup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

10x-cli Setup

10x-cli 设置

This skill sets up the 
@przeprogramowani/10x-cli
on the user's machine. The core principle is simple: the README is the single source of truth. The CLI evolves — version requirements change, new install methods appear, commands get updated. Rather than hardcoding any of that here, this skill tells you how to work, and the README tells you what to do.
此技能用于在用户机器上设置
@przeprogramowani/10x-cli
。核心原则很简单：README是唯一的事实来源。该CLI会不断演进——版本要求会变化，新的安装方法会出现，命令会更新。与其在此处硬编码任何内容，本技能会告诉你如何操作，而README会告诉你具体要做什么。

Step 1: Check if the CLI is already installed

步骤1：检查CLI是否已安装

Before anything else, check the current state:
bash
10x --version 2>/dev/null || echo "NOT_INSTALLED"
  • If a version is printed, the CLI is already installed. Tell the user and ask if they want to update, reconfigure, or troubleshoot.
  • If not installed, proceed to Step 2.
This avoids wasting time on prerequisites when the user might just need a config change or re-auth.
在进行任何操作之前，先检查当前状态：
bash
10x --version 2>/dev/null || echo "NOT_INSTALLED"
  • 如果打印出版本号，说明CLI已安装。告知用户并询问他们是否需要更新、重新配置或排查问题。
  • 如果未安装，则继续步骤2。
这避免了在用户可能只需要修改配置或重新验证身份时，在前置条件上浪费时间。

Step 2: Fetch the latest README

步骤2：获取最新的README

Retrieve the current README from GitHub — this is the authoritative source for all install steps, prerequisites, commands, and tool configurations:
URL: https://raw.githubusercontent.com/przeprogramowani/10x-cli/refs/heads/master/README.md
Use WebFetch or 
curl -sL
to get it. If the fetch fails, tell the user and stop — don't guess at install steps from memory, because they may be outdated.
从GitHub获取当前的README——这是所有安装步骤、前置条件、命令和工具配置的权威来源：
URL: https://raw.githubusercontent.com/przeprogramowani/10x-cli/refs/heads/master/README.md
使用WebFetch或
curl -sL
来获取它。如果获取失败，告知用户并停止操作——不要凭记忆猜测安装步骤，因为它们可能已经过时。

Step 3: Build a plan from the README and execute it

步骤3：根据README制定计划并执行

Read the fetched README and construct a step-by-step setup plan from it. The README contains everything needed: prerequisites, install commands, auth flow, available commands, and tool-specific configuration. Your job is to translate the README into actionable steps for the user's specific situation.
The general flow from the README is:
  1. Prerequisites — whatever the README says is required (runtime version, package manager, etc.). Check each one and stop if something is missing.
  2. Install — use the install method described in the README. Verify it worked.
  3. Authenticate — the README describes the auth command and flow. Note: auth is interactive (magic-link email), so the user may need to run it themselves via 
    ! 10x auth
    if the shell doesn't support input.
  4. Verify — the README lists a diagnostic command. Run it and review the output with the user.
  5. Explore — show the user how to browse and fetch content using the commands from the README.
  6. Tool configuration — if the user mentioned a specific AI tool (Claude Code, Cursor, etc.), use the README's multi-tool support section to configure it. If not, explain the options and let them choose.
Do not hardcode specific version numbers, command flags, or directory paths — read them from the README. This way the skill stays correct even when the CLI changes.
阅读获取到的README，从中构建分步设置计划。README包含所有必要信息：前置条件、安装命令、身份验证流程、可用命令以及特定工具的配置。你的任务是根据用户的具体情况，将README内容转化为可执行的步骤。
README中的通用流程如下：
  1. 前置条件——README中提到的所有必要项（运行时版本、包管理器等）。逐一检查，如果缺少某项则停止操作。
  2. 安装——使用README中描述的安装方法。验证安装是否成功。
  3. 身份验证——README描述了身份验证命令和流程。注意：身份验证是交互式的（魔术链接邮件），如果shell不支持输入，用户可能需要自行运行
    ! 10x auth
    。
  4. 验证——README列出了诊断命令。运行该命令并与用户一起查看输出结果。
  5. 探索——向用户展示如何使用README中的命令浏览和获取内容。
  6. 工具配置——如果用户提到了特定AI工具（Claude Code、Cursor等），使用README中的多工具支持部分进行配置。如果没有提到，则解释选项并让用户选择。
不要硬编码特定版本号、命令标志或目录路径——从README中读取这些信息。这样即使CLI发生变化，本技能也能保持正确。

Important principles

重要原则

  • README over memory. If you think you know a command or requirement, but the fetched README says something different, follow the README. Always.
  • Check before installing. Step 1 exists for a reason — don't reinstall what's already there.
  • Be interactive. Confirm with the user before installing global packages or modifying their system. Ask before running 
    sudo
    .
  • Diagnose before fixing. If something fails, read the error and the README's guidance before suggesting a fix. Don't just retry blindly.
  • Stay focused on end-user setup. This skill is about installing and configuring the published CLI package, not about development/contributing workflows.
  • 优先遵循README。如果你认为自己知道某个命令或要求，但获取到的README内容不同，务必遵循README。始终如此。
  • 安装前先检查。步骤1的存在是有原因的——不要重新安装已有的内容。
  • 保持交互性。在安装全局包或修改用户系统之前，先与用户确认。运行
    sudo
    前先询问。
  • 先诊断再修复。如果出现问题，先读取错误信息和README中的指导，再建议修复方案。不要盲目重试。
  • 专注于终端用户设置。本技能的目的是安装和配置已发布的CLI包，而非开发/贡献工作流。