Setup Guide
Choose your AI coding tool, follow the steps, and you'll be running workflows in 2 minutes.
Before you start
node -v to check)
Choose your tool
Claude Code
Anthropic's official CLI. Our primary supported platform — all workflows are tested here first.
Install Claude Code
If you don't have Claude Code yet, install it with npm:
npm install -g @anthropic-ai/claude-code
First time? After install, run claude in your terminal. It will ask you to log in with your Anthropic account.
Install a workflow (one command)
Replace YOUR_KEY with the License Key from your purchase email:
npx xiaohu-ai install tweet-to-wechat --key YOUR_KEY
Or even easier: Open Claude Code and paste this sentence — it handles everything: "Help me install a workflow, run npx xiaohu-ai install tweet-to-wechat --key YOUR_KEY"
Use the workflow
Open Claude Code and tell it what to do. For example, for tweet-to-wechat:
Help me turn this tweet into a WeChat article: https://x.com/...
Verify installation
npx xiaohu-ai list
This shows all installed workflows. If you see your workflow listed, you're all set.
Codex
OpenAI's open-source coding agent. Skills are auto-installed to ~/.codex/skills/.
Install Codex
Install Codex CLI with npm:
npm install -g @openai/codex
First time? Run codex and sign in with your OpenAI API key.
Install a workflow
Same command — it auto-detects Codex and installs skills to the right place:
npx xiaohu-ai install tweet-to-wechat --key YOUR_KEY
Use the workflow
Open Codex and describe what you want — it picks up the installed skills automatically.
codex "turn this tweet into a WeChat article: https://x.com/..."
Verify installation
npx xiaohu-ai list
ls ~/.codex/skills/
Gemini CLI
Google's AI coding agent. Skills are installed to ~/.gemini/skills/.
Install Gemini CLI
Install Gemini CLI with npm:
npm install -g @google/gemini-cli
First time? Requires Node.js 20+. Run gemini, choose "Sign in with Google" — your browser will open for login. Or set GEMINI_API_KEY from Google AI Studio.
Install a workflow
Same install command — auto-detects Gemini CLI:
npx xiaohu-ai install tweet-to-wechat --key YOUR_KEY
Use the workflow
Open Gemini CLI and give it a task:
Turn this tweet into a WeChat article: https://x.com/...
Verify installation
npx xiaohu-ai list
ls ~/.gemini/skills/
OpenClaw
Open-source coding agent. Skills are installed to ~/.openclaw/skills/.
Install OpenClaw
Install with npm (requires Node.js 22+):
npm install -g openclaw@latest
First time? Run openclaw onboard --install-daemon to set up your AI provider and API key.
Install a workflow
Same install command — auto-detects OpenClaw:
npx xiaohu-ai install tweet-to-wechat --key YOUR_KEY
Use the workflow
Open OpenClaw and describe what you need — it will use the installed skills.
openclaw "turn this tweet into a WeChat article: https://x.com/..."
Verify installation
npx xiaohu-ai list
ls ~/.openclaw/skills/
OpenCode
Lightweight coding agent. Skills are installed to ~/.config/opencode/skills/.
Install OpenCode
Install with brew (recommended) or npm:
brew install anomalyco/tap/opencode
npm i -g opencode-ai@latest
First time? Run opencode in a project directory, then type /connect to link your AI provider (supports OpenAI, Claude, GitHub Copilot, etc.).
Install a workflow
Same install command — auto-detects OpenCode:
npx xiaohu-ai install tweet-to-wechat --key YOUR_KEY
Use the workflow
Open OpenCode and give it a task — it picks up installed skills automatically.
opencode "turn this tweet into a WeChat article: https://x.com/..."
Verify installation
npx xiaohu-ai list
ls ~/.config/opencode/skills/
Common Questions
I have multiple tools installed. Which one gets the workflow?
All of them! The installer auto-detects every supported tool on your machine and installs skills to each one.
What is Node.js and how do I install it?
Node.js is a runtime that lets you run JavaScript on your computer. Download it from nodejs.org — choose the LTS version. After install, open a new terminal and run "node -v" to verify.
What does "npx" do? Do I need to install it?
npx comes with Node.js — you already have it. It runs packages without installing them globally. So "npx xiaohu-ai" downloads and runs our CLI on the fly.
Where are workflows stored on my computer?
Workflow definitions are in ~/.xiaohu/workflows/. Skills (the actual code) are copied to each tool's skills directory (e.g., ~/.claude/skills/). Everything is local — it works offline after install.
I got "No AI coding tool detected" error
This means the installer couldn't find any supported tool's config directory. Make sure you've opened Claude Code (or your tool) at least once — it creates the config directory on first run.
Can I use one License Key on multiple computers?
Yes — each key supports up to 3 devices. Just run the same install command on each machine.