75b5ba17cf
Added 623 new skills from skills.sh leaderboard (14 repos): - google-labs-code/stitch-skills (react:components, design-md, stitch-loop, enhance-prompt, shadcn-ui) - expo/skills (building-native-ui, native-data-fetching, expo-tailwind-setup, 7 more) - xixu-me/skills (github-actions-docs, readme-i18n, use-my-browser, 6 more) - anthropics/skills (algorithmic-art, web-artifacts-builder, theme-factory, brand-guidelines, 14 more) - github/awesome-copilot (git-commit, gh-cli, prd, documentation-writer, 130+ more) - firecrawl/cli (firecrawl, firecrawl-scrape, firecrawl-browser, 5 more) - inferen-sh/skills (web-search, python-executor, ai-image-generation, ai-video-generation) - wshobson/agents (tailwind-design-system, typescript-advanced-types) - neondatabase/agent-skills (neon-postgres) - microsoft/azure-skills (azure-kubernetes, 15+ azure services) - vercel/ai (ai-sdk) - currents-dev (playwright-best-practices) - resciencelab, aaron-he-zhu (seo-geo, backlink-analyzer) Total: 795 skills (42 shared + 52 paperclip + 701 community) Updated README.md and CLAUDE.md with current stats, architecture diagram, platform install matrix, and shared library documentation. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
# ax CLI — Troubleshooting
|
|
|
|
Consult this only when an `ax` command fails. Do NOT run these checks proactively.
|
|
|
|
## Check version first
|
|
|
|
If `ax` is installed (not `command not found`), always run `ax --version` before investigating further. The version must be `0.8.0` or higher — many errors are caused by an outdated install. If the version is too old, see **Version too old** below.
|
|
|
|
## `ax: command not found`
|
|
|
|
**macOS/Linux:**
|
|
1. Check common locations: `~/.local/bin/ax`, `~/Library/Python/*/bin/ax`
|
|
2. Install: `uv tool install arize-ax-cli` (preferred), `pipx install arize-ax-cli`, or `pip install arize-ax-cli`
|
|
3. Add to PATH if needed: `export PATH="$HOME/.local/bin:$PATH"`
|
|
|
|
**Windows (PowerShell):**
|
|
1. Check: `Get-Command ax` or `where.exe ax`
|
|
2. Common locations: `%APPDATA%\Python\Scripts\ax.exe`, `%LOCALAPPDATA%\Programs\Python\Python*\Scripts\ax.exe`
|
|
3. Install: `pip install arize-ax-cli`
|
|
4. Add to PATH: `$env:PATH = "$env:APPDATA\Python\Scripts;$env:PATH"`
|
|
|
|
## Version too old (below 0.8.0)
|
|
|
|
Upgrade: `uv tool install --force --reinstall arize-ax-cli`, `pipx upgrade arize-ax-cli`, or `pip install --upgrade arize-ax-cli`
|
|
|
|
## SSL/certificate error
|
|
|
|
- macOS: `export SSL_CERT_FILE=/etc/ssl/cert.pem`
|
|
- Linux: `export SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt`
|
|
- Fallback: `export SSL_CERT_FILE=$(python -c "import certifi; print(certifi.where())")`
|
|
|
|
## Subcommand not recognized
|
|
|
|
Upgrade ax (see above) or use the closest available alternative.
|
|
|
|
## Still failing
|
|
|
|
Stop and ask the user for help.
|