@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 +77 -0
- package/README.md +105 -26
- package/dist/guide.js +25 -6
- package/examples/watch-agent/README.md +3 -4
- package/package.json +12 -3
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
|
-
>
|
|
4
|
-
>
|
|
3
|
+
> [Odyssey365](https://product.odyssey365.app) — **Odyssey60**(계획·기록) · **Odyssey30**(회고·공유)을
|
|
4
|
+
> 터미널과 AI 에이전트에서 다루는 CLI. 여러 계정을 호출마다 고른다.
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
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 #
|
|
14
|
-
odyssey login -p 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` 하나
|
|
22
|
-
|
|
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
|
|
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 스킬
|
|
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
|
-
|
|
100
|
-
Claude Code 는 `CLAUDE.md`)에 짧은 절을 붙이는 것이다. 그 절은 "시작할 때 `odyssey agent-guide` 를 실행하라"고 가리키므로,
|
|
101
|
-
계정이나 서버 지침이 바뀌어도 파일을 고칠 필요가 없다.
|
|
181
|
+
**잘 쓰는 패턴**
|
|
102
182
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
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
|
|
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
|
-
-
|
|
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-
|
|
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
|
-
|
|
59
|
-
읽고 쓰는 CLI
|
|
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
|
-
|
|
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:
|
|
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
|
|
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 /
|
|
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.
|
|
4
|
-
"description": "
|
|
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": {
|