Skip to content

superyuqiang/felo-skills

 
 

Repository files navigation

Felo AI CLI

Felo AI

Ask anything. Get current answers. Generate slides from a prompt.

npm version Discord X (Twitter) MIT License

Felo AI CLI — Real-time search, PPT generation, web fetch, YouTube subtitles, and X (Twitter) search from the terminal. Also works as Claude Code skills. Supports Chinese, English, Japanese, and Korean.

Felo AI · Docs · API Reference · Examples · FAQ · ClawHub · Discord · X (Twitter)


Install

npm install -g felo-ai

Get your API key from Felo AI (Settings → API Keys), then:

felo config set FELO_API_KEY your-api-key-here

That's it. The key is persisted in ~/.felo/config.json. You can also use environment variables as an alternative:

export FELO_API_KEY="..."           # Linux/macOS
$env:FELO_API_KEY="..."             # Windows (PowerShell)

Commands

Command Description
felo search "<query>" Search for current info (weather, news, prices, etc.)
felo slides "<prompt>" Generate PPT; returns link when done
felo web-fetch --url <url> Fetch webpage content (markdown/text/html)
felo youtube-subtitling -v <url-or-id> Fetch YouTube video subtitles
felo x "<query>" Search X (Twitter) tweets, users, and replies
felo livedoc <subcommand> Manage LiveDocs (knowledge bases) and resources
felo apple-buy-advisor "<query>" Research and compare Apple products before you buy
felo config <set|get|list|path> Manage API key and config

Examples

Search

felo search "Tokyo weather"
felo search "React 19 new features" --verbose
felo search "MacBook Air M3 price" --json

Slides

felo slides "Felo product intro, 3 slides"
felo slides "Q4 2024 business review, 10 pages" --poll-timeout 300

Web Fetchfull options →

felo web-fetch --url "https://example.com"
felo web-fetch --url "https://example.com" --format markdown --readability

YouTube Subtitlingfull options →

felo youtube-subtitling -v "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
felo youtube-subtitling -v "dQw4w9WgXcQ" --language zh-CN --with-time

X (Twitter) Searchfull options →

felo x "AI news"                                    # Search tweets
felo x "OpenAI" --user                              # Search users
felo x --id "elonmusk" --user                       # Get user info
felo x --id "elonmusk" --user --tweets              # Get user tweets
felo x --id "1234567890"                            # Get tweet replies

LiveDoc (Knowledge Base)full options →

felo livedoc create --name "My KB" --description "Project docs"
felo livedoc list
felo livedoc add-doc SHORT_ID --content "Hello" --title "Test"
felo livedoc add-urls SHORT_ID --urls "https://example.com"
felo livedoc upload SHORT_ID --file ./doc.pdf
felo livedoc retrieve SHORT_ID --query "search query"

Apple Buy Advisorfull options →

# Use as Felo CLI command
felo apple-buy-advisor "Should I buy MacBook Pro M4?"
felo apple-buy-advisor "Compare iPhone 17 vs iPhone 17e"
felo apple-buy-advisor "Is it worth upgrading to iPad Air 13?"
# Use as Claude Code skill
/apple-buy-advisor Should I buy MacBook Pro M4?
/apple-buy-advisor Compare iPhone 17 vs iPhone 17e
/apple-buy-advisor Is it worth upgrading to iPad Air 13?

See 40+ more examples →


Skills Overview

7 skills across search, content generation, web scraping, social media, knowledge base, and shopping advice:

Skill Description Docs
felo-search Real-time web search with AI answers. Triggers automatically.
felo-slides Generate PPT from a prompt
felo-web-fetch Fetch and extract webpage content
felo-youtube-subtitling Fetch YouTube video subtitles
felo-x-search Search X (Twitter) tweets, users, replies
felo-livedoc Manage knowledge bases and semantic retrieval
apple-buy-advisor Research and compare Apple products before you buy

Skills Install

Claude Code (Recommended)

# Add the marketplace
/plugin marketplace add Felo-Inc/felo-skills

# Install individual skills
/plugin install felo-search@felo-ai
/plugin install felo-slides@felo-ai
/plugin install felo-web-fetch@felo-ai
/plugin install felo-youtube-subtitling@felo-ai
/plugin install felo-x-search@felo-ai
/plugin install felo-livedoc@felo-ai
/plugin install apple-buy-advisor@felo-ai

ClawHub

ClawHub is a public skill registry for AI coding agents. Browse all Felo skills on ClawHub.

clawhub install felo-search
clawhub install felo-slides
clawhub install felo-web-fetch
clawhub install felo-youtube-subtitling
clawhub install felo-x-search
clawhub install felo-livedoc
clawhub install apple-buy-advisor

Gemini CLI

git clone https://github.com/Felo-Inc/felo-skills.git
cd felo-skills

# Copy skill folders to Gemini CLI skills directory
cp -r felo-search ~/.gemini/skills/
cp -r felo-slides ~/.gemini/skills/
cp -r apple-buy-advisor ~/.gemini/skills/

OpenAI Codex

git clone https://github.com/Felo-Inc/felo-skills.git
# Copy any skill folder to ~/.codex/skills/
cp -r felo-search ~/.codex/skills/
cp -r apple-buy-advisor ~/.codex/skills/

OpenClaw

bash <(curl -s https://raw.githubusercontent.com/Felo-Inc/felo-skills/main/scripts/openclaw-install.sh)

Manual Installation

git clone https://github.com/Felo-Inc/felo-skills.git
# Copy any skill folder to the skills directory of your AI coding agent
# Claude Code: ~/.claude/skills/
# Gemini CLI:  ~/.gemini/skills/
# Codex:       ~/.codex/skills/
cp -r felo-search ~/.claude/skills/
cp -r apple-buy-advisor ~/.claude/skills/

FAQ

  • Key not found? Run felo config set FELO_API_KEY <key> or set the FELO_API_KEY environment variable.
  • Request timeout? Use --timeout 120 (default 60s). 5xx errors are retried automatically.
  • Slides taking long? Use --poll-timeout 300 (default 1200s) to limit wait.
  • Skill not triggering? Use /felo-search your query to trigger manually.
  • Multi-language? Yes — Chinese, English, Japanese, and Korean are supported.

Full FAQ →


Contributing

We welcome contributions — report bugs, improve docs, or add new skills. Run tests with npm test.

Contributing guide →


License

MIT — see LICENSE for details.


Made with ❤️ by the Felo team

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • JavaScript 99.0%
  • Shell 1.0%