@odyssey365/cli 0.2.0 → 0.2.1

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/AGENTS.md ADDED
@@ -0,0 +1,77 @@
1
+ # Odyssey CLI — 에이전트 안내
2
+
3
+ 이 패키지는 **Odyssey365** 앱(**Odyssey60** 계획·기록, **Odyssey30** 회고·공유)의 공개 CLI다.
4
+ 설치명: `@odyssey365/cli` · 명령: `odyssey`.
5
+
6
+ ## 시작 (필수)
7
+
8
+ ```bash
9
+ odyssey agent-guide
10
+ ```
11
+
12
+ 위 출력이 정본이다 — 이 기계에 로그인된 계정, 최신 서버 사용 지침, 파라미터·종료 코드 규칙이 나온다.
13
+ 계정·서버 지침은 시점에 따라 달라지므로 **이 파일을 복사해 두지 말고** 작업 시작 시 `agent-guide`를 다시 실행한다.
14
+
15
+ 프로젝트 `AGENTS.md` / `CLAUDE.md` / `GEMINI.md`에 붙일 짧은 절:
16
+
17
+ ```bash
18
+ odyssey agent-guide --snippet
19
+ ```
20
+
21
+ Claude Code·Codex 스킬 파일:
22
+
23
+ ```bash
24
+ odyssey agent-guide --skill
25
+ ```
26
+
27
+ ## 무엇을 할 수 있나
28
+
29
+ | 영역 | 예 |
30
+ |---|---|
31
+ | Odyssey60 | 할일·체크리스트·오늘/기한, 메모, 루틴, 기록(측정값), 일정, 타임라인, 리포트, 카테고리·태그 |
32
+ | 보드 | 프로젝트 보드 읽기/구성, 칸반, 댓글, 에셋 |
33
+ | Odyssey30 | 스냅샷 초안·발행본 조회/수정(공개·컬렉션 stage는 admin 스크립트), 컬렉션 |
34
+ | 실시간 | `odyssey watch` — 태그 할일·댓글 NDJSON. `odyssey watch-agent init` 예제 |
35
+ | 다계정 | `-p <프로필>` 로 개인·운영·지원 계정 오가기 (MCP 연결 하나와 다른 점) |
36
+
37
+ 도구 목록은 서버가 정본이다: `odyssey tools` → `odyssey describe <도구>` → 실행.
38
+
39
+ ## 사례 — 이런 걸 만들 때 참고
40
+
41
+ 에이전트·프로그램을 **새로 설계**할 때 아래 패턴을 먼저 본다. 자세한 명령은 [README.md](./README.md) 「사례로 배우기」.
42
+
43
+ ### A. 감시 에이전트 (태그·멘션 → 코딩 세션)
44
+
45
+ 앱에서 할일에 감시 태그를 달거나 댓글에 멘션하면, PC의 디스패처가 Claude Code 세션을 깨운다.
46
+
47
+ ```bash
48
+ odyssey watch-agent init ../my-watch-agent # 검증된 예제 추출
49
+ # 또는 처음부터: odyssey agent-guide --watch-agent
50
+ ```
51
+
52
+ 역할 분리: **감시·배달만** CLI/디스패처, **판단·답글·코드 작업**은 깨운 세션(+ Odyssey MCP).
53
+ 에이전트 댓글(`authorKind`)에는 반응하지 않는다 — 메아리 방지.
54
+
55
+ ### B. 활동 자동 기록기
56
+
57
+ 게임·앱 세션 감시기 → `create_record` 한 번 + 세션마다 `add_record_trace`(+`dedupeKey`).
58
+ 네트워크 실패(종료 4)만 같은 키로 재전송.
59
+
60
+ ### C. 저장소에 Odyssey를 도구로 심기
61
+
62
+ `agent-guide --snippet`을 프로젝트 지침에 붙이면, 대화형 코딩 에이전트가
63
+ 할일·보드·스냅샷을 `odyssey`로 읽고 쓴다. MCP가 없는 환경·다계정(`-p`)에 특히 유용.
64
+
65
+ ### D. 운영 계정 전환
66
+
67
+ 공지·사용법 지면은 `-p admin` / `-p support`. 쓰기 전 `odyssey whoami -p …`로 uid 확인.
68
+
69
+ ## 잘 쓰는 순서
70
+
71
+ 1. `odyssey agent-guide` (또는 `whoami` / `profiles`)로 계정 확인
72
+ 2. `odyssey search` / `list_*` 로 UID를 찾은 뒤 쓴다 — 없는 id를 추측하지 않는다
73
+ 3. 쓰기 뒤 `get_*`로 다시 읽고, 실제로 한 일만 보고한다
74
+ 4. 종료 코드 `3` = 로그인 필요 → 사람에게 `odyssey login` 부탁 (비밀번호·토큰을 에이전트가 다루지 않음)
75
+ 5. 종료 코드 `4` = 네트워크 → 잠시 뒤 같은 입력으로 재시도(`dedupeKey`가 있으면 중복 방지)
76
+
77
+ 설치·파라미터·감시·프로그램 연동 전문: [README.md](./README.md).
package/README.md CHANGED
@@ -1,26 +1,107 @@
1
- # Odyssey CLI
1
+ # Odyssey CLI (`@odyssey365/cli`)
2
2
 
3
- > Command-line client for [Odyssey](https://product.odyssey365.app) — manage tasks, memos, boards and snapshots
4
- > from your terminal or an AI agent, across **multiple Odyssey accounts**.
3
+ > [Odyssey365](https://product.odyssey365.app) — **Odyssey60**(계획·기록) · **Odyssey30**(회고·공유)을
4
+ > 터미널과 AI 에이전트에서 다루는 CLI. 여러 계정을 호출마다 고른다.
5
5
 
6
- Odyssey MCP 커넥터와 **같은 서버·같은 도구**를 터미널에서 부른다. 다른 점은 계정이다 — 커넥터는 연결 하나에
7
- 계정 하나지만, CLI 는 **호출마다 프로필(계정)을 고른다**. 개인 계정과 운영 계정을 한 세션에서 오가거나,
8
- AI 에이전트(Claude Code 등)가 두 계정을 함께 다루게 할 때 쓴다.
6
+ npm 검색: `Odyssey365` · `Odyssey60` · `Odyssey30` · `OdysseyCLI` → 패키지명 **`@odyssey365/cli`**
7
+ (무관한 `odyssey-cli` NFT 패키지와 헷갈리지 말 것).
8
+
9
+ ## 무엇을 할 수 있나
10
+
11
+ | | |
12
+ |---|---|
13
+ | **Odyssey60** | 할일·체크리스트·오늘/기한, 메모, 루틴, 기록(측정값·추적), 일정, 타임라인, 리포트, 카테고리·태그 |
14
+ | **보드** | 프로젝트 보드·칸반·댓글·에셋 읽기/구성 |
15
+ | **Odyssey30** | 스냅샷 초안·조회·수정, 컬렉션 (공개 stage/publish는 admin 스크립트) |
16
+ | **다계정** | `-p` 프로필로 개인·운영·지원을 한 세션에서 오가기 — MCP 연결 하나와 가장 다른 점 |
17
+ | **에이전트** | `odyssey agent-guide` / `--snippet`(AGENTS.md) / `--skill` — 계정·서버 지침을 실시간으로 |
18
+ | **프로그램·감시** | `add_record_trace` 등 자동 기록, `odyssey watch` NDJSON, `watch-agent init` 예제 |
19
+
20
+ Odyssey MCP 와 **같은 서버·같은 도구**다. 도구가 늘어도 CLI를 다시 설치할 필요는 없다(`--refresh-tools`).
21
+
22
+ ## 사례로 배우기 — 이런 에이전트·프로그램을 만들 때
23
+
24
+ CLI는 “도구 나열”보다 **입구를 Odyssey에 두고 PC에서 일하는 프로그램**을 붙일 때 빛이 난다.
25
+ 아래는 실제로 쓰이는 패턴이다. 새 에이전트를 설계할 때 복사·변형하면 된다.
26
+
27
+ ### 1) 감시 에이전트 — 앱에서 맡긴 일을 코딩 에이전트에게 배달
28
+
29
+ 앱에서 할일에 태그(예: `클로드 코드`)를 달거나, 아무 항목 댓글에 `@클로드코드`를 남기면
30
+ 맥에서 돌던 디스패처가 그 항목용 Claude Code 세션을 깨운다. 대기 중에는 모델을 부르지 않는다.
31
+
32
+ ```bash
33
+ # 작업할 프로젝트 옆 새 폴더에 검증된 예제를 꺼낸다(기존 폴더는 안 덮어씀)
34
+ odyssey watch-agent init ../my-watch-agent
35
+ cd ../my-watch-agent
36
+ # config.json: 작업 폴더·프로필·태그·예산 확인
37
+ node dispatcher.mjs --check
38
+ node dispatcher.mjs --dry-run
39
+ node dispatcher.mjs # 상시 — launchd 등은 예제 README
40
+ ```
41
+
42
+ 설계 포인트(직접 만들 때도 같음):
43
+
44
+ | 역할 | 누가 |
45
+ |---|---|
46
+ | 변화 감지 | `odyssey watch --tag …` → NDJSON |
47
+ | 배달만 | 디스패처 — 세션 고르기·깨우기·예산·재연결. **답글·판단은 하지 않음** |
48
+ | 실제 작업 | 깨운 코딩 에이전트 세션 + Odyssey MCP(`comment_on_item` 등) |
49
+
50
+ 처음부터 짜려면 `odyssey agent-guide --watch-agent` 프롬프트를 코딩 에이전트에 준다.
51
+ 자세한 계약·중지 방법: [examples/watch-agent/README.md](examples/watch-agent/README.md).
52
+
53
+ ### 2) 활동 자동 기록기 — 게임·앱 세션을 타임라인에 남기기
54
+
55
+ 사람 없이 도는 프로그램이 “언제부터 언제까지 무엇을 했다”를 남긴다.
56
+ 한 번 `odyssey login` + `create_record` 한 뒤, 세션마다 `add_record_trace`(+`dedupeKey`).
57
+
58
+ ```bash
59
+ odyssey create_record --title "리그 오브 레전드" --emoji 🎮 --numType time --numUnit min --categoryName "게임"
60
+ # → recordId 를 프로그램 설정에 저장
61
+ echo '{"recordId":"…","value":133,"time":"…+09:00","endTime":"…+09:00","dedupeKey":"lol-…"}' \
62
+ | odyssey add_record_trace --input -
63
+ ```
64
+
65
+ 종료 코드 `4`(네트워크)만 같은 `dedupeKey`로 재전송. 아래 「프로그램에서 쓰기」에 Windows·Python 예가 있다.
66
+
67
+ ### 3) 대화형 코딩 에이전트 — 저장소에 Odyssey를 “도구”로 심기
68
+
69
+ 프로젝트 `AGENTS.md`에 짧은 절만 붙이면, Claude·Codex·Cursor 등이 시작할 때
70
+ `odyssey agent-guide`를 읽고 할일·보드·스냅샷을 직접 다룬다(계정·서버 지침은 그때그때).
71
+
72
+ ```bash
73
+ odyssey agent-guide --snippet >> AGENTS.md # 내용 확인 후 반영
74
+ # 또는
75
+ odyssey agent-guide --skill > .claude/skills/odyssey/SKILL.md
76
+ ```
77
+
78
+ ### 4) 다계정 운영 — 개인 / 공지(admin) / 사용법(support)
79
+
80
+ MCP 연결은 계정 하나지만, CLI는 호출마다 `-p`로 바꾼다.
81
+ 공지 지면은 `-p admin`, 사용법·소개는 `-p support`(로그인·`whoami`로 uid 확인 후 쓰기).
82
+
83
+ ```bash
84
+ odyssey -p admin whoami
85
+ odyssey -p support search "반복 알림"
86
+ ```
87
+
88
+ ## 빠른 시작
9
89
 
10
90
  ```bash
11
91
  npm i -g @odyssey365/cli
92
+ odyssey --version # 0.2.1+
12
93
 
13
- odyssey login # 브라우저로 로그인 → 프로필 default
14
- odyssey login -p work # 다른 계정 → 프로필 work
94
+ odyssey login # 브라우저 → 프로필 default
95
+ odyssey login -p work # 다른 계정
15
96
 
97
+ odyssey agent-guide # AI 에이전트면 먼저 읽기
16
98
  odyssey list_todos --status inProgress
17
99
  odyssey -p work search "주간 회의"
18
100
  odyssey get_todo <todoId>
19
101
  ```
20
102
 
21
- Node.js 20 이상. 런타임 의존성은 `firebase` 하나 — `odyssey watch` 만 쓰고, 그 명령에서만 불러온다.
22
- 감시·예제 준비 기능은 **0.2.0 이상**이 필요하다. 설치 후 `odyssey --version`을 확인한다.
23
- 아직 공개판이 0.1.0이면 감시 명령은 없으므로, 제공된 후보 `.tgz`를 `npm i -g /경로/파일.tgz`로 설치한다.
103
+ Node.js 20 이상. 런타임 의존성은 `firebase` 하나(`odyssey watch`에서만 로드).
104
+ 감시·`watch-agent`는 **0.2.0+**.
24
105
 
25
106
  ## 계정
26
107
 
@@ -88,25 +169,23 @@ cat input.json | odyssey create_memo --input -
88
169
 
89
170
  ## AI 에이전트에서
90
171
 
91
- CLI 가 에이전트용 설명서를 직접 낸다 — 사용법 · 이 컴퓨터에 로그인된 계정 · Odyssey 서버의 사용 지침(실시간).
172
+ CLI가 설명서를 **직접 낸다** — 사용법 · 이 컴퓨터의 로그인 계정 · 서버 사용 지침(실시간).
173
+ 패키지에 실린 [AGENTS.md](./AGENTS.md)는 그 입구만 적고, 정본은 항상 `agent-guide`다.
92
174
 
93
175
  ```bash
94
- odyssey agent-guide # 전문 — 에이전트가 작업을 시작할 때 한 번 읽는다
95
- odyssey agent-guide --snippet # AGENTS.md · CLAUDE.md · GEMINI.md 등에 붙일 짧은 절
96
- odyssey agent-guide --skill # Claude Code · Codex 스킬 파일(SKILL.md) 내용
176
+ odyssey agent-guide # 전문 — 작업 시작 시 한 번
177
+ odyssey agent-guide --snippet # 프로젝트 AGENTS.md · CLAUDE.md · GEMINI.md 에 붙일 짧은 절
178
+ odyssey agent-guide --skill # Claude Code · Codex 스킬(SKILL.md)
97
179
  ```
98
180
 
99
- 에이전트에게 알리는 가장 쉬운 방법은 그 에이전트가 일하는 프로젝트의 `AGENTS.md`(여러 코딩 에이전트가 함께 읽는 관례 —
100
- Claude Code 는 `CLAUDE.md`)에 짧은 절을 붙이는 것이다. 그 절은 "시작할 때 `odyssey agent-guide` 를 실행하라"고 가리키므로,
101
- 계정이나 서버 지침이 바뀌어도 파일을 고칠 필요가 없다.
181
+ **잘 쓰는 패턴**
102
182
 
103
- ```bash
104
- odyssey agent-guide --snippet # 내용을 확인한 뒤 기존 저장소 지침의 정본에 맞게 반영
105
- odyssey agent-guide --skill # 스킬 내용을 출력한다. 기존 파일 덮어쓰기 전에 내용을 확인한다.
106
- ```
183
+ 1. 프로젝트 `AGENTS.md`에 `--snippet` 절을 붙여 둔다 → 에이전트가 시작 시 `odyssey agent-guide`를 읽게 됨
184
+ 2. 찾을 때 `search` / `list_*` → 쓸 때 `describe` → 쓴 뒤 `get_*`로 확인
185
+ 3. 종료 코드 `3`이면 사람에게 `odyssey login` 부탁 (비밀번호·토큰은 에이전트 몫이 아님)
186
+ 4. **새 배달/감시 에이전트**를 만들 땐 위 「사례 1」— `watch-agent init` 예제 또는 `--watch-agent` 프롬프트부터
107
187
 
108
- > MCP 커넥터는 연결할 때 서버의 사용 지침(복잡한 작업 전 `getGuide` 로 절차를 읽을 것 등)을 받는다. CLI 는 호출마다 한 왕복으로
109
- > 끝내려 그 연결 단계를 건너뛰므로, 그 지침은 `odyssey agent-guide` 로 받는다.
188
+ > MCP는 연결 때 서버 지침을 받는다. CLI는 왕복을 줄이려 initialize를 건너뛰므로 지침은 `odyssey agent-guide`로 받는다.
110
189
 
111
190
  ## 프로그램에서 쓰기 — 활동 자동 기록 (예: 게임 기록기)
112
191
 
@@ -258,7 +337,7 @@ odyssey watch --tag "클로드 코드" | my-dispatcher # 파이프로 프로
258
337
  Firebase 신원은 OAuth 연결마다 분리한다. 내 할일·내 댓글·읽을 수 있는 방 메타데이터만 읽고, 앱 데이터 쓰기는 허용하지 않는다.
259
338
  `odyssey logout`으로 서버 연결이 회수되면 rules가 추가 데이터 접근을 거절하고 CLI 신원의 Firebase 갱신도 회수한다. 일반 앱 로그인은 유지한다.
260
339
  Firebase 로그인 상태는 메모리에만 두고 App Check는 만료 때 다시 교환한다. Windows 발급·새 OAuth 연결 생성으로 파생 자격을 재사용할 수 없다.
261
- - 이 보안 변경은 Functions v1/v2·Firestore/Storage 규칙의 동반 반영이 필요하다. 새 CLI는 전용 신원을 주지 않는 구버전 서버에서 `watch`를 거절한다. 현재 후보는 미배포이며 운영 반영은 별도다.
340
+ - CLI 전용 Firebase 신원·규칙은 운영에 반영돼 있다(0.2.0+, 261025). 구버전 서버는 `watch`를 거절할 수 있다.
262
341
  - 에이전트 댓글을 가르는 표식은 `metadata.authorKind`다. `claude`·`companion`·알 수 없는 비어 있지 않은 값은 모두 `agent`로 분류한다. 직접 디스패처를 만들 때 에이전트 댓글은 배달하지 않는다. 예제는 `--include-agent`로 표식을 받되, 세션 재개 판정에만 쓰고 일꾼에게 배달하지 않는다.
263
342
  - **감시 에이전트 만들기**: `odyssey agent-guide --watch-agent` 가 코딩 에이전트(예: Claude Code)에게 줄 프롬프트를 낸다 —
264
343
  디스패처는 **배달만** 한다: 감시 → 항목으로 일꾼 세션을 고르고 → 새로 만들거나(`--session-id`) 이어 받아(`--resume`) 깨운다.
@@ -294,4 +373,4 @@ node dist/index.js --help
294
373
 
295
374
  MIT
296
375
 
297
- > 2026-10-22: 통신 장애 회귀·감시 예제·패키지 새 설치 검사를 추가했다. 공개 npm 게시와 서버 배포는 별도 단계다.
376
+ > 2026-10-28: npm 검색 키워드(Odyssey60/30/365·OdysseyCLI)·AGENTS.md·에이전트 안내 보강. 공개판 0.2.1.
package/dist/guide.js CHANGED
@@ -16,6 +16,7 @@
16
16
  * 건너뛰어 받지 못했다 — 전문 모드가 initialize 를 한 번 보내 그대로 싣는다.
17
17
  *
18
18
  * 이력: document/90-process/work-log/261010 Odyssey CLI agent-guide 에이전트 설명서 서버 지침.md
19
+ * 이력: document/90-process/work-log/261028 Odyssey CLI 검색키워드 AGENTS 감시사례.md
19
20
  */
20
21
  const CORE_RULES = `- **사용자의 데이터다.** 쓰기는 사용자 앱 화면·알림에 그대로 나타난다. 요청 범위를 넘는 생성·수정을 하지 않는다.
21
22
  - \`[쓰기·덮어씀]\` 도구와 \`delete_*\` 는 사용자가 그 변경을 분명히 원할 때만 부른다(삭제는 휴지통으로 가지만 그래도 먼저 확인).
@@ -55,8 +56,24 @@ export function renderAgentGuide(input) {
55
56
 
56
57
  ## 무엇인가
57
58
 
58
- Odyssey(계획·기록·회고 앱) 사용자의 데이터 — 할일·메모·루틴·기록(측정값)·일정·타임라인·리포트·프로젝트 보드·댓글·스냅샷·컬렉션 — 를
59
- 읽고 쓰는 CLI 다. 도구는 서버(${input.server})가 정의한다 — Odyssey MCP 서버와 같은 도구다.
59
+ **Odyssey365** 앱 — **Odyssey60**(계획·기록: 할일·메모·루틴·기록·일정·타임라인·보드)과 **Odyssey30**(회고·공유: 스냅샷·컬렉션·피드) — 사용자 데이터를
60
+ 터미널에서 읽고 쓰는 CLI 다(\`npm i -g @odyssey365/cli\`, 명령 \`odyssey\`). 도구는 서버(${input.server})가 정의한다 — Odyssey MCP 와 같은 도구다.
61
+
62
+ **언제 쓰면 좋은가**
63
+ - 사용자가 Odyssey / Odyssey60 / Odyssey30 / Odyssey365 데이터(할일·메모·보드·스냅샷 등)를 다루라고 할 때
64
+ - MCP 커넥터가 없거나, **여러 계정**을 한 세션에서 \`-p\` 로 오가야 할 때
65
+ - **에이전트·프로그램을 새로 만들 때** — Odyssey를 입구로 두고 PC에서 일시키는 패턴(아래 사례)
66
+
67
+ ## 사례 — 이런 에이전트·프로그램을 만들 때
68
+
69
+ | 만들고 싶은 것 | 쓰는 것 | 한 줄 |
70
+ |---|---|---|
71
+ | **감시 에이전트** — 앱 태그/멘션 → 코딩 세션 깨우기 | \`odyssey watch-agent init <새폴더>\` 또는 \`odyssey agent-guide --watch-agent\` | 디스패처는 **배달만**. 답글·판단은 깨운 세션+MCP. 에이전트 댓글엔 반응 금지 |
72
+ | **활동 기록기** — 게임/앱 세션 → 타임라인 | \`create_record\` 1회 + \`add_record_trace\`(+\`dedupeKey\`) | 종료 4만 같은 키로 재전송. JSON은 \`--input -\` |
73
+ | **저장소 코딩 에이전트**에 Odyssey 도구 심기 | \`odyssey agent-guide --snippet\` → AGENTS.md | 시작 시 \`agent-guide\` 전문을 읽게 한다 |
74
+ | **운영**(공지·사용법) | \`-p admin\` / \`-p support\` | 쓰기 전 \`whoami -p …\` 로 uid 확인 |
75
+
76
+ 감시 예제 폴더의 README·검사가 “검증된 계약”이다. 처음부터 짜기 전에 \`init\` 예제를 먼저 돌린다.
60
77
 
61
78
  ${profileSection(input)}
62
79
 
@@ -92,13 +109,15 @@ ${instructionsSection(input)}
92
109
  }
93
110
  /** AGENTS.md·CLAUDE.md·GEMINI.md·Cursor 규칙 등에 붙일 짧은 절 — 기계마다 다른 계정 정보는 싣지 않는다. */
94
111
  export function renderSnippet() {
95
- return `## Odyssey (\`odyssey\` CLI)
112
+ return `## Odyssey / Odyssey365 (\`odyssey\` CLI)
96
113
 
97
- Odyssey(계획·기록·회고 앱)의 데이터 — 할일·메모·루틴·기록·일정·타임라인·프로젝트 보드·스냅샷 — 는 \`odyssey\` CLI 로 읽고 쓴다.
114
+ **Odyssey60**(할일·메모·루틴·기록·일정·타임라인·보드) · **Odyssey30**(스냅샷·컬렉션) 데이터는 \`odyssey\` CLI(\`@odyssey365/cli\`)로 읽고 쓴다.
98
115
 
99
- - **작업을 시작할 때 \`odyssey agent-guide\` 를 실행해 읽는다** — 사용법·로그인된 계정·최신 서버 지침이 나온다.
116
+ - **작업을 시작할 때 \`odyssey agent-guide\` 를 실행해 읽는다** — 사용법·로그인된 계정·최신 서버 지침·**실사용 사례**(감시 에이전트·자동 기록 등)가 나온다.
100
117
  - 도구: \`odyssey tools\` → \`odyssey describe <도구>\` → \`odyssey <도구> --파라미터 값\`(또는 \`--input -\` 에 JSON). 결과는 JSON.
101
118
  - 계정: \`-p <프로필>\`. 종료 코드 3 = 로그인 필요 → 사용자에게 \`odyssey login\` 을 부탁한다.
119
+ - 설치: \`npm i -g @odyssey365/cli\` (검색어 Odyssey365 / Odyssey60 / Odyssey30 / OdysseyCLI).
120
+ - **새 에이전트/프로그램을 만들 때**: 감시 배달은 \`odyssey watch-agent init <새폴더>\`(또는 \`agent-guide --watch-agent\`), 세션 자동 기록은 \`add_record_trace\`+\`dedupeKey\`. 디스패처는 배달만, 답글은 깨운 세션 몫.
102
121
  ${CORE_RULES}
103
122
  `;
104
123
  }
@@ -106,7 +125,7 @@ ${CORE_RULES}
106
125
  export function renderSkill() {
107
126
  return `---
108
127
  name: odyssey
109
- description: Odyssey(계획·기록·회고 앱) 사용자 데이터 — 할일·메모·루틴·기록(측정값)·일정·타임라인·프로젝트 보드·댓글·스냅샷·컬렉션 — 를 \`odyssey\` CLI 로 읽고 쓴다. 사용자가 Odyssey 나 그 안의 할일·메모·기록·일정·타임라인·보드를 언급하거나 다뤄 달라고 할 때, 여러 Odyssey 계정(-p 프로필)을 오갈 때 사용.
128
+ description: Odyssey365 / Odyssey60 / Odyssey30 / OdysseyCLI — 할일·메모·보드·스냅샷과 감시 에이전트(watch-agent)·활동 자동 기록을 \`odyssey\` CLI(\`@odyssey365/cli\`)로 다룬다. Odyssey 데이터·태그/멘션 배달 에이전트·다계정(-p) 작업 시 사용.
110
129
  ---
111
130
 
112
131
  ${renderSnippet()}`;
@@ -1,6 +1,6 @@
1
1
  # Odyssey 감시 에이전트 예제
2
2
 
3
- > 0.2.0 보안 후보: 감시는 CLI 전용 Firebase 신원을 요구합니다. Functions·규칙의 동반 업데이트 전에는 감시가 시작되지 않습니다. 이 저장소 후보는 아직 배포하지 않았습니다.
3
+ > `@odyssey365/cli` **0.2.0+** · 감시는 CLI 전용 Firebase 신원(OAuth 프로필)이 필요합니다.
4
4
 
5
5
  Odyssey에서 태그나 댓글로 맡긴 일을 Claude Code에 전달하는 실행 가능한 예제입니다.
6
6
  할일·항목마다 세션 하나를 만들고, 이후 댓글은 같은 세션으로 이어 받습니다.
@@ -9,11 +9,10 @@ Odyssey에서 태그나 댓글로 맡긴 일을 Claude Code에 전달하는 실
9
9
  ## 처음 시작하기
10
10
 
11
11
  Node.js 20 이상, OAuth 로그인한 Odyssey CLI, 로그인한 Claude Code가 필요합니다.
12
- 배포 전 후보를 받았다면 제공된 `.tgz`로 설치합니다. 공개된 0.1.0에는 이 예제가 없습니다.
13
12
 
14
13
  ```sh
15
- npm install -g /path/to/odyssey365-cli-0.2.0.tgz
16
- odyssey --version
14
+ npm install -g @odyssey365/cli
15
+ odyssey --version # 0.2.0+
17
16
  odyssey login
18
17
  odyssey whoami
19
18
  ```
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@odyssey365/cli",
3
- "version": "0.2.0",
4
- "description": "Odyssey CLI — 터미널과 AI 에이전트에서 Odyssey 계정(여러 개)의 할일·메모·보드·스냅샷을 다룬다",
3
+ "version": "0.2.1",
4
+ "description": "Odyssey365 / Odyssey60 / Odyssey30 CLI — 터미널·AI 에이전트에서 할일·메모·루틴·기록·보드·스냅샷을 다룬다 (OdysseyCLI)",
5
5
  "type": "module",
6
6
  "engines": {
7
7
  "node": ">=20"
@@ -14,6 +14,7 @@
14
14
  "prompts",
15
15
  "examples",
16
16
  "README.md",
17
+ "AGENTS.md",
17
18
  "LICENSE"
18
19
  ],
19
20
  "scripts": {
@@ -26,12 +27,20 @@
26
27
  },
27
28
  "keywords": [
28
29
  "odyssey",
30
+ "Odyssey365",
31
+ "Odyssey60",
32
+ "Odyssey30",
33
+ "OdysseyCLI",
34
+ "odyssey-cli",
29
35
  "cli",
30
36
  "mcp",
31
37
  "todo",
32
38
  "memo",
39
+ "routine",
40
+ "snapshot",
33
41
  "claude",
34
- "ai-agent"
42
+ "ai-agent",
43
+ "grok"
35
44
  ],
36
45
  "license": "MIT",
37
46
  "publishConfig": {