Skip to content

Commit 86e1691

Browse files
chore: replace npm with bun in docs and scripts
Amp-Thread-ID: https://ampcode.com/threads/T-019c0918-5b9d-753a-ac3e-317b748ce4e7 Co-authored-by: Amp <amp@ampcode.com>
1 parent c6e99e6 commit 86e1691

4 files changed

Lines changed: 29 additions & 29 deletions

File tree

.agent/skills/_shared/lessons-learned.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ Add in the following format after session completion:
6767
### Initial Lessons
6868
- **Rate limiting verification method**: Send continuous requests with `curl` and verify 429 response. Code review alone is insufficient.
6969
- **CORS wildcard**: Using `*` in development environment is OK, but production build must restrict to specific domains.
70-
- **npm audit vs safety**: Use `npm audit` for frontend, `pip-audit` or `safety check` for backend (Python).
70+
- **bun audit vs safety**: Use `bun audit` for frontend, `pip-audit` or `safety check` for backend (Python).
7171

7272
---
7373

docs/USAGE.ko.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -77,10 +77,10 @@ wait
7777
**실시간 모니터링:**
7878
```bash
7979
# 터미널 (별도 창)
80-
npm run dashboard
80+
bun run dashboard
8181

8282
# 또는 브라우저
83-
npm run dashboard:web
83+
bun run dashboard:web
8484
# → http://localhost:9847
8585
```
8686

@@ -91,7 +91,7 @@ npm run dashboard:web
9191
### 터미널 대시보드
9292

9393
```bash
94-
npm run dashboard
94+
bun run dashboard
9595
```
9696

9797
`fswatch` (macOS) 또는 `inotifywait` (Linux)로 `.serena/memories/`를 감시합니다. 세션 상태, 에이전트 상태, 턴 수, 최신 활동을 실시간 테이블로 표시합니다. 메모리 파일 변경 시 자동으로 업데이트됩니다.
@@ -103,8 +103,8 @@ npm run dashboard
103103
### 웹 대시보드
104104

105105
```bash
106-
npm install # 최초 1회
107-
npm run dashboard:web
106+
bun install # 최초 1회
107+
bun run dashboard:web
108108
```
109109

110110
브라우저에서 `http://localhost:9847` 열기. 기능:
@@ -231,7 +231,7 @@ Antigravity IDE 채팅에서 입력하여 단계별 워크플로우를 실행합
231231
### 워크플로우 D: CLI Orchestration + 대시보드
232232

233233
```
234-
터미널 1: npm run dashboard:web
234+
터미널 1: bun run dashboard:web
235235
터미널 2: ./scripts/spawn-subagent.sh backend "task" ./backend &
236236
./scripts/spawn-subagent.sh frontend "task" ./frontend &
237237
브라우저: http://localhost:9847 → 실시간 상태
@@ -245,7 +245,7 @@ Antigravity IDE 채팅에서 입력하여 단계별 워크플로우를 실행합
245245
2. **멀티 도메인은 Agent Manager 사용** — 한 채팅에서 모든 것을 하려고 하지 마세요.
246246
3. **Knowledge Base 검토**`.gemini/antigravity/brain/`에서 API 일관성 확인
247247
4. **재생성으로 반복** — 처음부터 다시 하지 말고, 명령을 다듬어 재생성하세요.
248-
5. **대시보드 사용**`npm run dashboard` 또는 `npm run dashboard:web`로 orchestrator 세션 모니터링
248+
5. **대시보드 사용**`bun run dashboard` 또는 `bun run dashboard:web`로 orchestrator 세션 모니터링
249249
6. **별도 워크스페이스** — 각 에이전트에 고유 디렉토리 할당
250250

251251
---
@@ -258,19 +258,19 @@ Antigravity IDE 채팅에서 입력하여 단계별 워크플로우를 실행합
258258
| Agent Manager를 찾을 수 없음 | View → Agent Manager 메뉴, Antigravity 2026+ 필요 |
259259
| 에이전트 산출물이 호환되지 않음 | Knowledge Base에서 둘 다 검토, 수정하여 재생성 |
260260
| 대시보드: "No agents" 표시 | 메모리 파일이 아직 생성되지 않음, orchestrator 실행 필요 |
261-
| 웹 대시보드가 시작 안 됨 | `npm install`로 chokidar, ws 설치 |
261+
| 웹 대시보드가 시작 안 됨 | `bun install`로 chokidar, ws 설치 |
262262
| fswatch not found | macOS: `brew install fswatch`, Linux: `apt install inotify-tools` |
263263
| QA 리포트에 50개 이상 이슈 | CRITICAL/HIGH부터 처리, 나머지는 문서화 후 나중에 |
264264

265265
---
266266

267-
## npm 스크립트
267+
## Bun 스크립트
268268

269269
```bash
270-
npm run dashboard # 터미널 실시간 대시보드
271-
npm run dashboard:web # 웹 대시보드 → http://localhost:9847
272-
npm run validate # 스킬 파일 검증
273-
npm run info # 이 사용 가이드 출력
270+
bun run dashboard # 터미널 실시간 대시보드
271+
bun run dashboard:web # 웹 대시보드 → http://localhost:9847
272+
bun run validate # 스킬 파일 검증
273+
bun run info # 이 사용 가이드 출력
274274
```
275275

276276
---

docs/USAGE.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -77,10 +77,10 @@ wait
7777
**Monitor in real-time:**
7878
```bash
7979
# Terminal (separate terminal window)
80-
npm run dashboard
80+
bun run dashboard
8181

8282
# Or browser
83-
npm run dashboard:web
83+
bun run dashboard:web
8484
# → http://localhost:9847
8585
```
8686

@@ -91,7 +91,7 @@ npm run dashboard:web
9191
### Terminal Dashboard
9292

9393
```bash
94-
npm run dashboard
94+
bun run dashboard
9595
```
9696

9797
Watches `.serena/memories/` using `fswatch` (macOS) or `inotifywait` (Linux). Displays a live table with session status, agent states, turns, and latest activity. Updates automatically when memory files change.
@@ -103,8 +103,8 @@ Watches `.serena/memories/` using `fswatch` (macOS) or `inotifywait` (Linux). Di
103103
### Web Dashboard
104104

105105
```bash
106-
npm install # first time only
107-
npm run dashboard:web
106+
bun install # first time only
107+
bun run dashboard:web
108108
```
109109

110110
Open `http://localhost:9847` in your browser. Features:
@@ -232,7 +232,7 @@ You: "Login button throws TypeError"
232232
### Workflow D: CLI Orchestration with Dashboard
233233

234234
```
235-
Terminal 1: npm run dashboard:web
235+
Terminal 1: bun run dashboard:web
236236
Terminal 2: ./scripts/spawn-subagent.sh backend "task" ./backend &
237237
./scripts/spawn-subagent.sh frontend "task" ./frontend &
238238
Browser: http://localhost:9847 → real-time status
@@ -246,7 +246,7 @@ Browser: http://localhost:9847 → real-time status
246246
2. **Use Agent Manager** for multi-domain projects — don't try to do everything in one chat
247247
3. **Review Knowledge Base** — check `.gemini/antigravity/brain/` for API consistency
248248
4. **Iterate with re-spawns** — refine instructions, don't start over
249-
5. **Use dashboards**`npm run dashboard` or `npm run dashboard:web` to monitor orchestrator sessions
249+
5. **Use dashboards**`bun run dashboard` or `bun run dashboard:web` to monitor orchestrator sessions
250250
6. **Separate workspaces** — assign each agent its own directory
251251

252252
---
@@ -259,19 +259,19 @@ Browser: http://localhost:9847 → real-time status
259259
| Agent Manager not found | View → Agent Manager menu, requires Antigravity 2026+ |
260260
| Incompatible agent outputs | Review both in Knowledge Base, re-spawn with corrections |
261261
| Dashboard: "No agents" | Memory files not created yet, run orchestrator first |
262-
| Web dashboard won't start | Run `npm install` to install chokidar and ws |
262+
| Web dashboard won't start | Run `bun install` to install chokidar and ws |
263263
| fswatch not found | macOS: `brew install fswatch`, Linux: `apt install inotify-tools` |
264264
| QA report has 50+ issues | Focus on CRITICAL/HIGH first, document rest for later |
265265

266266
---
267267

268-
## npm Scripts
268+
## Bun Scripts
269269

270270
```bash
271-
npm run dashboard # Terminal real-time dashboard
272-
npm run dashboard:web # Web dashboard → http://localhost:9847
273-
npm run validate # Validate skill files
274-
npm run info # Show this usage guide
271+
bun run dashboard # Terminal real-time dashboard
272+
bun run dashboard:web # Web dashboard → http://localhost:9847
273+
bun run validate # Validate skill files
274+
bun run info # Show this usage guide
275275
```
276276

277277
---

scripts/dashboard-web/server.js

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,15 +26,15 @@ try {
2626
chokidar = require("chokidar");
2727
} catch {
2828
console.error(
29-
"Missing dependency: chokidar\nRun: npm install chokidar ws"
29+
"Missing dependency: chokidar\nRun: bun install chokidar ws"
3030
);
3131
process.exit(1);
3232
}
3333

3434
try {
3535
({ WebSocketServer } = require("ws"));
3636
} catch {
37-
console.error("Missing dependency: ws\nRun: npm install chokidar ws");
37+
console.error("Missing dependency: ws\nRun: bun install chokidar ws");
3838
process.exit(1);
3939
}
4040

0 commit comments

Comments
 (0)