antenna-fyi 1.3.39 → 1.3.40

package/README.md

@@ -11,6 +11,10 @@ npm install -g antenna-fyi
 ## CLI Usage
 
 ```bash
+# Find people by intent (agent-facing search)
+antenna find --id <platform>:<user_id> --query "想找一个懂 consumer social 增长的人"
+antenna find-people --id <platform>:<user_id> --query "find someone building AI hardware" --limit 3
+
 # Create your profile card
 antenna setup --id <platform>:<user_id>
 
@@ -48,6 +52,7 @@ This starts a stdio-based MCP server with tools:
 - `antenna_checkin` — Check in at a location
 - `antenna_accept` — Accept a match
 - `antenna_check_matches` — Check match status
+- `antenna_find_people` — Find 1-3 people from a free-form user intent. Use when the user says "I want to meet/find someone who..."; returns refs and safe profile fields, not contact info or raw device IDs.
 
 ## Hermes Agent Integration
 
@@ -103,9 +108,10 @@ The plugin adds automatic location-triggered scanning, match polling, and real-t
 ## How It Works
 
 1. **Create a profile card** — emoji, name, 3 lines about you
-2. **Scan nearby** — find people within radius at your location
-3. **Accept matches** — if both sides accept, exchange contact info
-4. **Everything expires in 24h** — ephemeral by design
+2. **Find by intent** — users can say "I want someone who understands X"; agents call `antenna_find_people` / `antenna find`
+3. **Scan nearby** — find people within radius at your location
+4. **Accept matches** — if both sides accept, exchange contact info
+5. **Everything expires in 24h** — ephemeral by design
 
 ## License
 

package/lib/cli.js

@@ -1098,6 +1098,12 @@ export async function handleDrift(f) {
 export function printHelp() {
   console.log(`📡 Antenna — nearby people discovery
 
+Agent shortcuts:
+  antenna find       Find 1-3 people by intent, e.g. "想找一个懂 consumer social 增长的人"
+  antenna discover   Get today's global recommendation
+  antenna scan       Find nearby people after GPS is available
+  antenna accept     Use a returned ref/profile_slug when the user wants an intro
+
 Usage:
   antenna scan       --lat 39.99 --lng 116.48 [--radius 500] (max 1000) [--id <platform>:<user_id>]
   antenna checkin    --id <platform>:<user_id> --lat 39.99 --lng 116.48
@@ -1107,6 +1113,7 @@ Usage:
   antenna matches    --id <platform>:<user_id>
   antenna discover   --id <platform>:<user_id>
   antenna find       --id <platform>:<user_id> --query '想找一个懂 consumer social 增长的人' [--limit 3]
+  antenna find-people --id <platform>:<user_id> --query 'find someone building AI hardware' [--limit 3]
   antenna event      --create --name 'AI Meetup' --starts-at '...' --ends-at '...' [--lat 34.05 --lng -118.25] [--desc '...'] [--og-image 'url'] [--requires-approval] [--screening-questions 'Q1|Q2'] | --join --code abc123 | --scan --code abc123 | --end --code abc123 --id <platform>:<user_id> | --upload-image --code abc123 --file /path/to/image.png | --update --code abc123 --name 'New Name' | --approve --code abc123 --ref 1 | --reject --code abc123 --ref 1 | --add-host --code abc123 --ref 1
   antenna drift      --throw --message 'hello' | --pick | --reply --bottle-id <uuid> --message 'reply' | --check | --my-bottles  --id <platform>:<user_id>
   antenna watch       --id <platform>:<user_id> [--push hermes|openclaw|terminal]  Watch for new matches in real-time (Ctrl+C to stop)
@@ -1126,5 +1133,5 @@ Environment:
   ANTENNA_SUPABASE_KEY   Supabase anon key (optional, has default)
 
 Install:  npm install -g antenna-fyi
-Or:       npx antenna-fyi scan --lat 39.99 --lng 116.48`);
+Or:       npx antenna-fyi find --id <platform>:<user_id> --query 'AI hardware builders'`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antenna-fyi",
-  "version": "1.3.39",
+  "version": "1.3.40",
   "description": "Antenna — nearby people discovery. CLI + MCP server + OpenClaw skill & plugin, all in one package.",
   "type": "module",
   "bin": {

package/skill/SKILL.md

@@ -23,6 +23,8 @@ Antenna 帮你的用户发现值得认识的人。不只是"附近的人"--profi
 
 - 如果有 Antenna plugin tools(antenna_scan, antenna_profile 等),直接用。
 - 如果没有,用 CLI:`antenna <command> [flags]`。
+- 用户说"我想找一个 xxx 的人"、"find someone who..."、"有没有做 X 的人"时,优先用 `antenna_find_people`。CLI 等价命令是:
+  `antenna find --id <platform>:<user_id> --query "<用户原话>" --limit 3`
 - **所有 tool 必须传 `chat_id`**--Antenna 用它发通知。
 
 ## Onboarding - 装上后主动引导
@@ -128,6 +130,8 @@ openclaw cron add --every 1h --message "Check antenna matches: call antenna_chec
 - 不返回联系方式或 raw `device_id`
 - 你仍然要结合上下文判断是否推荐,不要机械展示所有结果
 - 用户想认识某人时,用 `ref` 调 `antenna_accept`
+- 没有 plugin tool 时,用 CLI:
+  `antenna find --id <platform>:<user_id> --query "想找一个懂 consumer social 增长的人" --limit 3`
 
 ### 4. Profile 链接
 用户收到 `antenna.fyi/p/xxx` 链接时: