Big News: Socket raises $60M Series C at a $1B valuation to secure software supply chains for AI-driven development.Announcement
Sign In

felo-search

Package Overview
Dependencies
Maintainers
1
Versions
3
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

felo-search

Felo AI CLI - real-time search from the terminal

latest
Source
npmnpm
Version
0.2.0
Version published
Maintainers
1
Created
Source

Felo Skills for Claude Code

Ask anything. Get current answers powered by AI.

Real-time web search powered by Felo AI. Works in Chinese, English, Japanese, and Korean.

Setup Time License

Felo CLI (Terminal)

Use Felo search from the terminal without opening Claude Code.

Install

npm install -g felo-search

Or run without installing (uses latest published version):

npx felo-search search "东京天气"

After install, the command is felo (from the package name felo-search).

Configure API key

Option 1: Persist with config (recommended)

felo config set FELO_API_KEY your-api-key-here

The key is stored in ~/.felo/config.json (Windows: %USERPROFILE%\.felo\config.json). You only need to set it once.

Option 2: Environment variable

# Linux/macOS
export FELO_API_KEY="your-api-key-here"

# Windows (PowerShell)
$env:FELO_API_KEY="your-api-key-here"

Get your API key from felo.ai (Settings → API Keys). Environment variable overrides config if both are set.

Commands

CommandDescription
felo search "<query>"Search for current info (weather, news, prices, etc.)
felo slides "<query>"Generate PPT from a prompt (outputs live doc URL when done)
felo config set FELO_API_KEY <key>Save API key to config
felo config get FELO_API_KEYPrint stored key
felo config listList config keys
felo config pathShow config file path
felo summarize / felo translatePlanned; use felo search for now

Examples

felo search "东京天气"
felo search "MacBook Air M3 多少钱"
felo search "React 19 new features" --verbose
felo search "杭州明天天气" --json
npx felo-search search "Tokyo weather"

CLI FAQ

  • Key not found? Run felo config set FELO_API_KEY <key> or set the FELO_API_KEY environment variable.
  • Request timeout? Use felo search "query" --timeout 120 (default 60 seconds). 5xx errors are retried automatically with backoff.
  • Where is config stored? Run felo config path to see the file (e.g. ~/.felo/config.json).
  • Streaming? Not yet; when the Felo API supports streaming, the CLI can be updated to stream output.

Quick Start (Claude Code Skill)

Install the skill:

npx @claude/skills add felo-search

Get your API key from felo.ai (Settings → API Keys), then configure:

Linux/macOS:

export FELO_API_KEY="your-api-key-here"
# Add to ~/.bashrc or ~/.zshrc for persistence

Windows (PowerShell):

$env:FELO_API_KEY="your-api-key-here"
# For persistence, add to system environment variables

Test it works:

Ask Claude: "What's the weather in Tokyo today?"

You're done! The skill triggers automatically for any question needing current information.

Usage Examples

Daily Life

Weather

You: What's the weather in Tokyo today?
Claude: [Current temperature, conditions, forecast]

You: 杭州明天天气怎么样?
Claude: [明天杭州天气预报,温度范围,降水概率]

Restaurants & Food

You: Best ramen in Osaka
Claude: [Top-rated ramen shops with addresses, ratings, reviews]

You: 上海哪里有好吃的小笼包?
Claude: [推荐餐厅列表,地址,特色菜品]

Shopping & Prices

You: iPhone 15 Pro price comparison
Claude: [Prices from different retailers with links]

You: MacBook Air M3 多少钱?
Claude: [各渠道价格对比,优惠信息]

Travel

You: Things to do in Kyoto this weekend
Claude: [Events, attractions, seasonal activities]

You: 台北有什么好玩的地方?
Claude: [景点推荐,开放时间,交通方式]

Developer Scenarios

Latest Documentation

You: React 19 new features
Claude: [Latest React 19 features with official docs links]

You: Next.js 15 有什么新功能?
Claude: [Next.js 15 新特性总结,文档链接]

Library Comparison

You: Vite vs Webpack 2024 comparison
Claude: [Performance, features, use cases comparison]

You: Vue 3 和 React 哪个更适合新项目?
Claude: [对比分析,适用场景,社区生态]

Tech Trends

You: Latest AI developments January 2026
Claude: [Recent AI breakthroughs, company announcements]

You: 最近有什么重要的技术新闻?
Claude: [近期科技动态,行业趋势]

Multi-language Queries

Works seamlessly in:

  • Chinese (Simplified): "人工智能最新进展"
  • Chinese (Traditional): "台北最近有什麼新鮮事?"
  • Japanese: "東京で今人気のレストランは?"
  • Korean: "서울 맛집 추천"
  • Mixed: "React 在中国的使用情况"

Complex Queries

Research & Analysis

You: Impact of AI on software development 2024-2026
Claude: [Comprehensive analysis with statistics, trends, expert opinions]

You: 量子计算对密码学的影响
Claude: [深度分析,技术挑战,未来展望]

Comparisons

You: Cloud providers comparison: AWS vs Azure vs GCP
Claude: [Detailed comparison table, pricing, use cases]

You: 编程语言性能对比:Python vs Go vs Rust
Claude: [性能测试数据,适用场景,学习曲线]

See 40+ more examples →

Installation Details

Prerequisites

  • Claude Code CLI installed
  • Node.js (for npx command)
  • Internet connection

Manual Installation

If quick install doesn't work, install manually:

  • Clone this repository:

    git clone https://github.com/Felo-Inc/felo-skills.git
    cd felo-skills
    
  • Copy to Claude Code skills directory:

    • Linux/macOS: ~/.claude/skills/
    • Windows: C:\Users\<YourUsername>\.claude\skills\
    # Linux/macOS
    cp -r felo-search ~/.claude/skills/
    
    # Windows (PowerShell)
    Copy-Item -Recurse felo-search "$env:USERPROFILE\.claude\skills\"
    
  • Get API key from felo.ai (Settings → API Keys)

  • Set environment variable (see Quick Start section)

  • Restart Claude Code:

    claude restart
    

Verify Installation

Check the skill is loaded:

claude skills list

You should see felo-search in the output.

Test with a query:

Ask Claude: "Latest news about quantum computing"

If you see an AI-generated answer, it's working!

FAQ

Q: Skill not triggering automatically?

A: The skill triggers for questions needing current info (weather, news, prices, etc.). For manual trigger, use:

/felo-search your query here

Q: "FELO_API_KEY not set" error?

A: Set the environment variable:

# Linux/macOS
export FELO_API_KEY="your-key"

# Windows PowerShell
$env:FELO_API_KEY="your-key"

Then restart Claude Code.

Q: Environment variable not persisting?

A: Add to your shell profile:

  • bash: Add to ~/.bashrc
  • zsh: Add to ~/.zshrc
  • Windows: Add to system environment variables (System Properties → Environment Variables)

Q: "INVALID_API_KEY" error?

A: Your API key is incorrect or revoked. Generate a new one at felo.ai (Settings → API Keys).

Q: Does it work in Chinese/Japanese/Korean?

A: Yes! Fully supports multi-language queries. Ask in any language, get answers in that language.

Q: What's the response format?

A: Each response includes:

  • AI-generated answer - Comprehensive, well-structured
  • Query analysis - Optimized search queries used

Q: "curl: command not found" error?

A: Install curl:

# Linux (Debian/Ubuntu)
sudo apt install curl

# macOS
brew install curl

# Windows
# curl is built-in on Windows 10+

Q: Rate limits?

A: Check your Felo account tier at felo.ai. Free tier available.

Q: Can I use it offline?

A: No, requires internet connection to Felo API.

Q: How fast are responses?

A: Typically 2-5 seconds depending on query complexity.

See full FAQ →

Available Skills

Real-time web search with AI-generated answers.

Triggers automatically for:

  • Current events & news
  • Weather, prices, reviews
  • Location info (restaurants, attractions)
  • Latest documentation & tech trends
  • Product comparisons
  • Any question with "latest", "recent", "best", "how to"

View skill documentation →

Contributing

We welcome contributions! Whether you want to:

  • Report bugs or request features
  • Improve documentation
  • Add new skills

Run CLI tests: npm test

See contributing guide →

Support

License

MIT License - see LICENSE for details.

Made with ❤️ by the Felo team

Keywords

felo

FAQs

Package last updated on 03 Mar 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts