ai-summon 0.0.1 → 0.0.3

package/JUEJIN.md

@@ -0,0 +1,162 @@
+> 适用人群：项目多、切换频繁、被 Recent 背刺过、每天 `cd` 到心累的同学  
+> 关键词：Cursor、Claude Code、命令行、模糊搜索、效率工具
+
+---
+
+### 0. 你是不是也被「Recent 列表」PUA 过？
+
+你有没有这种瞬间崩溃过：
+
+- **项目越来越多**：Cursor 的 Recent 只能记住几个，你常用的那个总在关键时刻消失。
+- **打开一次很麻烦**：想开老项目，只能 Finder/Terminal 里翻目录，或者一路 `cd` 进去再开 IDE。
+- **Claude Code 也同款麻烦**：不进到项目目录里跑起来就别扭，每次都要先“搬运”到正确的文件夹。
+
+说白了就是：**我们每天都在做同一件低价值动作——找目录、进目录、打开工具。**
+
+都 2026 年了，打开项目这件事，能不能像 `git status` 一样自然？
+
+---
+
+### 1. 我想要的体验：打开项目 = 输入几个字母 + 回车
+
+于是我做了一个小工具：**`ai`**（一个命令行入口）。
+
+它的目标非常简单粗暴：
+
+- **把“打开项目”变成肌肉记忆**
+- **不再依赖 Recent**
+- **不再为了打开项目先手动 `cd`**
+
+你只需要记住两句话：
+
+- **打开 Cursor**：`ai cursor search`
+- **打开 Claude Code**：`ai claude search`
+
+从此你不再需要：
+
+- 先 Finder 里翻半天
+- 先 Terminal 里 `cd /some/very/long/path/...`
+- 先祈祷 Recent 列表“刚好记得你”
+
+---
+
+### 2. 为什么我觉得它“值”（而且项目越多越值）
+
+#### 2.1 Recent 是“记忆”，但我们需要的是“检索”
+
+Recent 的本质是：帮你记住最近几个。  
+你的真实需求是：**我随时能找到任何一个。**
+
+项目从 5 个到 50/200 个时，“记忆”天然失效，“检索”才可靠。
+
+#### 2.2 打开项目这件事，频率高到离谱
+
+每天开 10 次项目很正常吧？
+
+每次手动进目录哪怕只花 20 秒：  
+一天就是 200 秒，一周 1000 秒……更可怕的是：**它会打断注意力**。
+
+你本来在想需求/排查问题，结果被迫去“搬运自己到目录”。
+
+#### 2.3 Claude 更依赖“在正确目录里”
+
+很多人用 Claude Code 的时候都有这种感觉：  
+“我只是想开始聊，但又得先去到项目目录……好麻烦。”
+
+所以我干脆把“选中项目 → 进入目录 → 启动 Claude”这件事收编成一次操作。
+
+---
+
+### 3. 适合哪些人（对号入座）
+
+- **你的项目多到 Recent 永远不够用**
+- **你经常在多个 repo 来回切换**
+- **你用 Cursor 写代码、用 Claude Code 辅助分析/写方案**
+- **你已经受够了重复 `cd` / Finder 找目录**
+- **你想把“打开项目”变成一种丝滑启动仪式**
+
+如果你看到这里疯狂点头：你就是目标用户。
+
+---
+
+### 4. 它会改变什么：从“打开项目”到“打开思路”
+
+我最喜欢的点不是“省几秒钟”，而是：
+
+- 你不需要为了打开一个 repo 而离开当前思考
+- 你把启动成本降到接近 0
+- 你更愿意随时切回那个不常开的项目（因为不痛）
+
+一句话总结：**更少的摩擦 = 更顺的 flow = 更高的产出。**
+
+---
+
+### 5. 怎么开始用（超简单）
+
+#### 5.1 安装
+
+全局装一个 `ai` 命令：
+
+```bash
+npm install -g ai-summon
+```
+
+#### 5.2 初始化一次
+
+初始化配置（第一次用建议跑一下）：
+
+```bash
+ai init
+```
+
+它会让你设置一个“工作目录”（通常是你放所有 git 仓库的大目录，比如 `~/dev`）。
+
+#### 5.3 开始用
+
+```bash
+ai cursor search
+ai claude search
+```
+
+---
+
+### 6. 小技巧：用得越久越舒服
+
+- **把所有仓库收进一个 workingDirectory**：你会越来越依赖“统一入口”，而不是“记住路径”。
+- **当你新增/移动了大量仓库**：跑一下 refresh（你可以把它当成“更新索引”）。
+
+```bash
+ai cursor refresh
+ai claude refresh
+```
+
+---
+
+### 7. FAQ（我猜你会问）
+
+#### Q1：我只有几个项目，也值得用吗？
+
+一开始可能是“舒服一点点”，但当你项目变多、开始多 repo 协作时，它会从“舒服”变成“刚需”。
+
+#### Q2：这是不是只是个快捷方式？
+
+它表面是“打开工具”，本质是：**把打开项目这件事产品化**。  
+当入口足够低成本，你会更愿意切换、更愿意复用、更少被路径打断。
+
+#### Q3：我想分享给团队/同事？
+
+非常适合。尤其是多人、多 repo、频繁切换的团队环境。你可以把这篇文章甩过去（别客气）。
+
+---
+
+### 8. 写在最后：这是个很小的工具，但解决的是个很真实的痛
+
+我们总爱用更复杂的技术去解决更宏大的问题，但很多时候，效率就藏在最不起眼的重复动作里。
+
+如果你也被 Recent 背叛过、也在 Terminal 里 `cd` 到心累过——  
+欢迎试试这种思路：**把打开项目做成一个统一入口。**
+
+项目地址（GitHub）：`https://github.com/ai-shaohua/ai-summon.git`  
+欢迎大家 **点赞 / 收藏 / Star**，你的支持就是我继续打磨小工具的动力～
+
+

package/README.md

@@ -9,16 +9,24 @@ A small TypeScript CLI (binary name: `ai`) for:
 ## Installation
 
 ```bash
-yarn install
-yarn build:install
+npm install -g ai-summon
 ```
 
+[![npm version](https://img.shields.io/npm/v/ai-summon)](https://www.npmjs.com/package/ai-summon)
+
 After install, you should have the `ai` command available:
 
 ```bash
 ai --help
 ```
 
+### Install from source (dev)
+
+```bash
+yarn install
+yarn build:install
+```
+
 ## Commands
 
 ### `ai init`
@@ -116,41 +124,11 @@ Example:
 ```json
 {
   "workingDirectory": "/Users/you/dev",
-  "repos": {},
-  "yiren": {},
   "urls": {},
   "urlGroups": {}
 }
 ```
 
-### Manual mode (grouped projects)
-
-If `workingDirectory` is not set, `ai cursor` / `ai claude` will use `repos` (two-step selection: category → project).
-
-Example:
-
-```json
-{
-  "repos": {
-    "work": {
-      "impactful": "/Users/you/dev/impactful",
-      "payments": "/Users/you/dev/payments"
-    },
-    "personal": {
-      "dotfiles": "/Users/you/dev/dotfiles"
-    }
-  },
-  "yiren": {},
-  "urls": {
-    "jira": "https://your-jira.example.com",
-    "gitlab": "https://your-gitlab.example.com"
-  },
-  "urlGroups": {
-    "daily": ["https://example.com", "https://example.org"]
-  }
-}
-```
-
 ## Development
 
 ```bash

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "ai-summon",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "description": "",
   "main": "index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ai-shaohua/ai-summon.git"
+  },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "build": "rm -rf dist && tsc",