felo-ai 0.2.0 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.en.md CHANGED
@@ -84,4 +84,5 @@ After setting `FELO_API_KEY`, ask Claude things like “What’s the weather in
84
84
 
85
85
  ---
86
86
 
87
- **Other languages / 其他语言:** [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [繁體中文](README.zh-TW.md)
87
+ **Other languages:** [Chinese (Simplified)](README.zh-CN.md) | [Japanese](README.ja.md) | [Korean](README.ko.md) | [Chinese (Traditional)](README.zh-TW.md)
88
+
package/README.md CHANGED
@@ -1,55 +1,30 @@
1
- # Felo AI
1
+ # Felo Skills for Claude Code
2
2
 
3
3
  **Ask anything. Get current answers powered by AI.**
4
4
 
5
- Felo AI provides a terminal CLI and Claude Code skill, with support for English, Chinese (Simplified & Traditional), Japanese, and Korean.
5
+ Real-time web search powered by Felo AI. Works in Chinese, English, Japanese, and Korean.
6
6
 
7
7
  [![Setup Time](https://img.shields.io/badge/setup-2%20minutes-blue)]() [![License](https://img.shields.io/badge/license-MIT-green)]()
8
8
 
9
- **Other languages:** [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [繁體中文](README.zh-TW.md)
10
-
11
- ---
12
-
13
- ## Two Core Capabilities
14
-
15
- Felo AI offers two main features: **Real-time Search** and **PPT Generation**. Use them via the CLI in your terminal, or in Claude Code via the skill (search can trigger automatically).
16
-
17
- ### Capability 1: Real-time Search
18
-
19
- Search the web for up-to-date information and get AI-synthesized answers. Ideal for weather, news, prices, documentation, tech updates, and any question that needs “right now” information.
20
-
21
- - **Multi-language**: Ask in your preferred language.
22
- - **Terminal**: `felo search "your question"`
23
- - **Claude Code**: After installing the skill, it triggers automatically, or type `/felo-ai your question`
24
- - **Examples**: `felo search "Tokyo weather"`, `felo search "React 19 new features" --verbose`
25
-
26
- ### Capability 2: Generate PPT
27
-
28
- Describe a topic in one sentence and Felo generates a slideshow. The job runs in the cloud; when done, you get an **online document link** to open in your browser.
29
-
30
- - **Terminal**: `felo slides "your topic or description"`
31
- - **Options**: `--verbose` for polling status, `--json` for raw JSON (`task_id`, `live_doc_url`).
32
- - **Examples**: `felo slides "Felo product intro, 3 slides"`, `felo slides "Introduction to React"`, `felo slides "Quarterly review" --poll-timeout 300`
33
-
34
9
  ---
35
10
 
36
11
  ## Felo CLI (Terminal)
37
12
 
38
- Use Felo from the terminal without opening Claude Code.
13
+ Use Felo search from the terminal without opening Claude Code.
39
14
 
40
15
  ### Install
41
16
 
42
17
  ```bash
43
- npm install -g felo-ai
18
+ npm install -g felo-search
44
19
  ```
45
20
 
46
- Run without installing (latest published version):
21
+ Or run without installing (uses latest published version):
47
22
 
48
23
  ```bash
49
- npx felo-ai search "Tokyo weather"
24
+ npx felo-search search "Tokyo weather"
50
25
  ```
51
26
 
52
- After install, the command is `felo` (from package name `felo-ai`).
27
+ After install, the command is `felo` (from the package name `felo-search`).
53
28
 
54
29
  ### Configure API key
55
30
 
@@ -75,12 +50,14 @@ Get your API key from [felo.ai](https://felo.ai) (Settings → API Keys). Enviro
75
50
 
76
51
  ### Commands
77
52
 
78
- | Command | Description |
79
- |---------|-------------|
80
- | `felo search "<query>"` | **Real-time search** weather, news, prices, docs, etc. |
81
- | `felo slides "<prompt>"` | **Generate PPT** outputs online doc link when done |
82
- | `felo config set FELO_API_KEY <key>` | Save API key (recommended before first use) |
83
- | `felo config get/list/path/unset` | View, list, path, or remove config |
53
+ | Command | Description |
54
+ | ------------------------------------ | ----------------------------------------------------- |
55
+ | `felo search "<query>"` | Search for current info (weather, news, prices, etc.) |
56
+ | `felo config set FELO_API_KEY <key>` | Save API key to config |
57
+ | `felo config get FELO_API_KEY` | Print stored key |
58
+ | `felo config list` | List config keys |
59
+ | `felo config path` | Show config file path |
60
+ | `felo summarize` / `felo translate` | Planned; use `felo search` for now |
84
61
 
85
62
  ### Examples
86
63
 
@@ -89,7 +66,7 @@ felo search "Tokyo weather"
89
66
  felo search "MacBook Air M3 price"
90
67
  felo search "React 19 new features" --verbose
91
68
  felo search "Hangzhou tomorrow weather" --json
92
- npx felo-ai search "Tokyo weather"
69
+ npx felo-search search "Tokyo weather"
93
70
  ```
94
71
 
95
72
  ### CLI FAQ
@@ -106,24 +83,27 @@ npx felo-ai search "Tokyo weather"
106
83
  Install the skill:
107
84
 
108
85
  ```bash
109
- npx @claude/skills add felo-ai
86
+ npx @claude/skills add felo-search
110
87
  ```
111
88
 
112
89
  Get your API key from [felo.ai](https://felo.ai) (Settings → API Keys), then configure:
113
90
 
114
91
  **Linux/macOS:**
92
+
115
93
  ```bash
116
94
  export FELO_API_KEY="your-api-key-here"
117
95
  # Add to ~/.bashrc or ~/.zshrc for persistence
118
96
  ```
119
97
 
120
98
  **Windows (PowerShell):**
99
+
121
100
  ```powershell
122
101
  $env:FELO_API_KEY="your-api-key-here"
123
102
  # For persistence, add to system environment variables
124
103
  ```
125
104
 
126
105
  Test it:
106
+
127
107
  ```
128
108
  Ask Claude: "What's the weather in Tokyo today?"
129
109
  ```
@@ -137,24 +117,28 @@ Ask Claude: "What's the weather in Tokyo today?"
137
117
  ### Daily life
138
118
 
139
119
  **Weather**
120
+
140
121
  ```
141
122
  You: What's the weather in Tokyo today?
142
123
  Claude: [Current temperature, conditions, forecast]
143
124
  ```
144
125
 
145
126
  **Restaurants & food**
127
+
146
128
  ```
147
129
  You: Best ramen in Osaka
148
130
  Claude: [Top-rated ramen shops with addresses, ratings, reviews]
149
131
  ```
150
132
 
151
133
  **Shopping & prices**
134
+
152
135
  ```
153
136
  You: iPhone 15 Pro price comparison
154
137
  Claude: [Prices from different retailers with links]
155
138
  ```
156
139
 
157
140
  **Travel**
141
+
158
142
  ```
159
143
  You: Things to do in Kyoto this weekend
160
144
  Claude: [Events, attractions, seasonal activities]
@@ -163,18 +147,21 @@ Claude: [Events, attractions, seasonal activities]
163
147
  ### Developer scenarios
164
148
 
165
149
  **Latest documentation**
150
+
166
151
  ```
167
152
  You: React 19 new features
168
153
  Claude: [Latest React 19 features with official docs links]
169
154
  ```
170
155
 
171
156
  **Library comparison**
157
+
172
158
  ```
173
159
  You: Vite vs Webpack 2024 comparison
174
160
  Claude: [Performance, features, use cases comparison]
175
161
  ```
176
162
 
177
163
  **Tech trends**
164
+
178
165
  ```
179
166
  You: Latest AI developments January 2026
180
167
  Claude: [Recent AI breakthroughs, company announcements]
@@ -201,12 +188,14 @@ Works in Chinese (Simplified & Traditional), Japanese, Korean, and English. Ask
201
188
  If quick install doesn’t work:
202
189
 
203
190
  1. Clone this repository:
191
+
204
192
  ```bash
205
193
  git clone https://github.com/Felo-Inc/felo-skills.git
206
194
  cd felo-skills
207
195
  ```
208
196
 
209
197
  2. Copy to Claude Code skills directory:
198
+
210
199
  - **Linux/macOS:** `~/.claude/skills/`
211
200
  - **Windows:** `C:\Users\<YourUsername>\.claude\skills\`
212
201
 
@@ -230,9 +219,9 @@ If quick install doesn’t work:
230
219
  claude skills list
231
220
  ```
232
221
 
233
- You should see `felo-ai` or `felo-search` in the output.
222
+ You should see `felo-search` in the output.
234
223
 
235
- Test: ask Claude *"Latest news about quantum computing"*. If you see an AI-generated answer, it’s working.
224
+ Test: ask Claude _"Latest news about quantum computing"_. If you see an AI-generated answer, it’s working.
236
225
 
237
226
  ---
238
227
 
@@ -240,7 +229,11 @@ Test: ask Claude *"Latest news about quantum computing"*. If you see an AI-gener
240
229
 
241
230
  ### Q: Skill not triggering automatically?
242
231
 
243
- **A:** The skill triggers for questions needing current info (weather, news, prices, etc.). For manual trigger, use `/felo-ai your query here`.
232
+ **A:** The skill triggers for questions needing current info (weather, news, prices, etc.). For manual trigger, use:
233
+
234
+ ```
235
+ /felo-search your query here
236
+ ```
244
237
 
245
238
  ### Q: "FELO_API_KEY not set" error?
246
239
 
@@ -274,15 +267,22 @@ Test: ask Claude *"Latest news about quantum computing"*. If you see an AI-gener
274
267
 
275
268
  ---
276
269
 
277
- ## Claude Code skill (summary)
270
+ ## Available Skills
271
+
272
+ ### felo-search
278
273
 
279
- With `felo-ai` installed, **real-time search** runs as a skill: when you ask about weather, news, prices, or latest docs, Felo search is triggered and returns an answer. You can also type `/felo-ai your question` to trigger it manually.
274
+ Real-time web search with AI-generated answers.
280
275
 
281
- **Typical triggers:** current events, weather/prices/reviews, places (restaurants, attractions), latest tech docs and trends, product comparisons, and questions with words like “latest”, “recent”, “best”, “how to”.
276
+ **Triggers automatically for:**
282
277
 
283
- PPT generation is only available in the terminal via `felo slides`.
278
+ - Current events & news
279
+ - Weather, prices, reviews
280
+ - Location info (restaurants, attractions)
281
+ - Latest documentation & tech trends
282
+ - Product comparisons
283
+ - Any question with "latest", "recent", "best", "how to"
284
284
 
285
- **[Search skill details →](./felo-search/)**
285
+ **[View skill documentation →](./felo-search/)**
286
286
 
287
287
  ---
288
288