@odyssey365/cli 0.1.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 +216 -21
- package/dist/files.js +58 -0
- package/dist/guide.js +132 -0
- package/dist/index.js +92 -2
- package/dist/oauth.js +2 -9
- package/dist/rpc.js +20 -13
- package/dist/session.js +57 -1
- package/dist/watch-agent.js +45 -0
- package/dist/watch-events.js +78 -0
- package/dist/watch.js +181 -0
- package/examples/watch-agent/README.md +123 -0
- package/examples/watch-agent/config.example.json +20 -0
- package/examples/watch-agent/dispatcher.mjs +1443 -0
- package/examples/watch-agent/gitignore.template +6 -0
- package/examples/watch-agent/package.json +12 -0
- package/examples/watch-agent/test/dispatcher.test.mjs +763 -0
- package/examples/watch-agent/test/supervisor.test.mjs +126 -0
- package/package.json +21 -5
- package/prompts/watch-agent.md +250 -0
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,24 +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 이상. 런타임
|
|
103
|
+
Node.js 20 이상. 런타임 의존성은 `firebase` 하나(`odyssey watch`에서만 로드).
|
|
104
|
+
감시·`watch-agent`는 **0.2.0+**.
|
|
22
105
|
|
|
23
106
|
## 계정
|
|
24
107
|
|
|
@@ -36,7 +119,7 @@ Node.js 20 이상. 런타임 의존성 없음.
|
|
|
36
119
|
브라우저 로그인이 끝나면 그 주소로 돌아온 인가 코드를 토큰으로 바꾼다. 로그인 페이지는 매번 새로 로그인하므로
|
|
37
120
|
다른 계정으로 바꿔 로그인하기 쉽다.
|
|
38
121
|
|
|
39
|
-
토큰은 `~/.odyssey/cli/credentials.json
|
|
122
|
+
토큰은 `~/.odyssey/cli/credentials.json`에 평문으로 저장된다(디렉터리 0700·파일 0600, Windows에서는 POSIX chmod가 적용되지 않음). 액세스 토큰은 60일이고, 만료 하루 전부터
|
|
40
123
|
리프레시 토큰으로 알아서 갱신한다.
|
|
41
124
|
|
|
42
125
|
**계정 고르는 순서**: `-p/--profile` → 환경변수 `ODYSSEY_TOKEN`(저장 없이 토큰 직접) → `ODYSSEY_PROFILE`
|
|
@@ -44,7 +127,7 @@ Node.js 20 이상. 런타임 의존성 없음.
|
|
|
44
127
|
|
|
45
128
|
## 도구
|
|
46
129
|
|
|
47
|
-
도구 정의는 서버가 정본이다. 서버에 도구가 늘면 CLI
|
|
130
|
+
도구 정의는 서버가 정본이다. 서버에 도구가 늘면 CLI 코드를 업데이트하지 않아도 쓸 수 있다. 목록은 6시간 캐시하므로 즉시 반영이 필요하면 `--refresh-tools`를 붙인다(모르는 이름은 한 번 새로 받는다).
|
|
48
131
|
|
|
49
132
|
```bash
|
|
50
133
|
odyssey tools # 전체 목록 ([읽기]/[쓰기] 표시)
|
|
@@ -86,13 +169,23 @@ cat input.json | odyssey create_memo --input -
|
|
|
86
169
|
|
|
87
170
|
## AI 에이전트에서
|
|
88
171
|
|
|
89
|
-
CLI
|
|
172
|
+
CLI가 설명서를 **직접 낸다** — 사용법 · 이 컴퓨터의 로그인 계정 · 서버 사용 지침(실시간).
|
|
173
|
+
패키지에 실린 [AGENTS.md](./AGENTS.md)는 그 입구만 적고, 정본은 항상 `agent-guide`다.
|
|
90
174
|
|
|
175
|
+
```bash
|
|
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)
|
|
91
179
|
```
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
180
|
+
|
|
181
|
+
**잘 쓰는 패턴**
|
|
182
|
+
|
|
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` 프롬프트부터
|
|
187
|
+
|
|
188
|
+
> MCP는 연결 때 서버 지침을 받는다. CLI는 왕복을 줄이려 initialize를 건너뛰므로 지침은 `odyssey agent-guide`로 받는다.
|
|
96
189
|
|
|
97
190
|
## 프로그램에서 쓰기 — 활동 자동 기록 (예: 게임 기록기)
|
|
98
191
|
|
|
@@ -102,7 +195,9 @@ Odyssey 데이터는 `odyssey` CLI 로 다룬다. `odyssey tools` 로 도구를
|
|
|
102
195
|
|
|
103
196
|
```bash
|
|
104
197
|
odyssey login # 브라우저 로그인 한 번 — 이후 토큰은 알아서 갱신된다
|
|
105
|
-
odyssey
|
|
198
|
+
odyssey list_categories # 카테고리 이름 확인
|
|
199
|
+
odyssey create_record --title "리그 오브 레전드" --emoji 🎮 --numType time --numUnit min --tags 게임 --categoryName "게임"
|
|
200
|
+
# 기록의 카테고리가 타임라인 카드에도 붙는다 — 앱 타임라인의 카테고리 필터·기록장 묶기가 이 값으로 거른다
|
|
106
201
|
# → {"recordId":"…"} 를 프로그램 설정에 저장
|
|
107
202
|
```
|
|
108
203
|
|
|
@@ -122,7 +217,39 @@ odyssey create_record --title "리그 오브 레전드" --emoji 🎮 --numType t
|
|
|
122
217
|
odyssey add_record_trace --input - # 위 JSON 을 표준입력으로
|
|
123
218
|
```
|
|
124
219
|
|
|
125
|
-
|
|
220
|
+
**승패·KDA 까지 같이 남기려면** — 기록을 만들 때 칸(`fields`)을 설계한다. 첫 칸이 대표값(차트·통계)이다.
|
|
221
|
+
킬·데스·어시처럼 한 덩어리로 생각하는 숫자는 **숫자 묶음 칸(`numberSet`) 하나**에 담는다 — KDA 비율은 저장하지 않고 앱·서버가 계산한다.
|
|
222
|
+
|
|
223
|
+
```json
|
|
224
|
+
{
|
|
225
|
+
"title": "리그 오브 레전드 랭크",
|
|
226
|
+
"emoji": "🎮",
|
|
227
|
+
"fields": [
|
|
228
|
+
{ "label": "결과", "kind": "choice", "options": ["승", "패"] },
|
|
229
|
+
{ "label": "KDA", "kind": "numberSet", "calc": "kda",
|
|
230
|
+
"parts": [{ "label": "킬" }, { "label": "데스" }, { "label": "어시" }] },
|
|
231
|
+
{ "label": "플레이", "kind": "span" }
|
|
232
|
+
]
|
|
233
|
+
}
|
|
234
|
+
```
|
|
235
|
+
|
|
236
|
+
```bash
|
|
237
|
+
odyssey create_record --input - # 위 JSON — 운동이면 parts 를 무게(kg)·횟수(회)·세트(세트), joiner "times", calc "product"(볼륨)
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
측정값은 칸 **이름**으로 적는다. 묶음 값은 `"12/3/8"` 글·`[12, 3, 8]` 목록·`{"킬": 12, …}` 맵 어느 것이든 된다. 구간 칸은 `time`·`endTime` 이 값이다.
|
|
241
|
+
|
|
242
|
+
```json
|
|
243
|
+
{
|
|
244
|
+
"recordId": "<recordId>",
|
|
245
|
+
"values": { "결과": "승", "KDA": "12/3/8" },
|
|
246
|
+
"time": "2026-10-10T21:03:00+09:00",
|
|
247
|
+
"endTime": "2026-10-10T21:35:00+09:00",
|
|
248
|
+
"dedupeKey": "lol-2026-10-10T21:03:00+09:00"
|
|
249
|
+
}
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
기록 없이 타임라인 카드만 원하면 `create_timeline_event` 에 `title`·`startTime`·`endTime`(+`dedupeKey`·`categoryName`)을 준다 —
|
|
126
253
|
시작·끝이 둘 다 있으면 다른 내용 없이도 만들어진다.
|
|
127
254
|
|
|
128
255
|
**지켜야 할 것**
|
|
@@ -154,6 +281,69 @@ elif p.returncode == 3: notify("odyssey login 이 필요합니다")
|
|
|
154
281
|
elif p.returncode != 0: log_error(p.stderr)
|
|
155
282
|
```
|
|
156
283
|
|
|
284
|
+
## 관리자 — 사용량 한도·요금제 (`-p admin`)
|
|
285
|
+
|
|
286
|
+
관리자(admin 클레임) 계정으로 붙으면 도구 목록에 셋이 더 보인다(일반 계정엔 없다). 사용자가 앱에서 [더 필요해요]로 한도 상향을
|
|
287
|
+
요청하면 이걸로 올린다 — 저장소·서비스 계정 키 없이, 앱 릴리스 없이 바로 먹는다.
|
|
288
|
+
|
|
289
|
+
```bash
|
|
290
|
+
odyssey -p admin get_usage_quota --account user@example.com # 요금제·상향·유효 한도·사용량 + 요금제 표
|
|
291
|
+
odyssey -p admin set_usage_quota --account user@example.com --projectLimit 20 --storageLimitMb 1024
|
|
292
|
+
odyssey -p admin set_usage_quota --account user@example.com --companionMonthlyBudgetKrw 10000
|
|
293
|
+
odyssey -p admin set_usage_quota --json '{"account":"user@example.com","clear":["all"]}' # 상향 지우기(요금제 값으로)
|
|
294
|
+
odyssey -p admin set_usage_plan --planId beta --projectLimit 8 # 요금제 표 고치기 → 그 요금제 계정 전부 다시 적힘
|
|
295
|
+
```
|
|
296
|
+
|
|
297
|
+
유효 한도 = 계정별 상향 ?? 요금제(`usage_plan/{id}`) ?? 코드 기본값(보드 6 · 업로드 300MB · 컴패니언 월 ₩3,000).
|
|
298
|
+
결제가 붙으면 계정의 `plan` 만 바꾼다(`set_usage_quota --plan pro`) — 운영자 상향과 섞이지 않는다.
|
|
299
|
+
이력: `document/90-process/work-log/261019 베타 사용량 한도 요금제 usage_plan 계정별 한도 관리자 도구.md`
|
|
300
|
+
|
|
301
|
+
## 실시간 감시 — `odyssey watch`
|
|
302
|
+
|
|
303
|
+
내 계정의 변화를 실시간으로 받아 **한 줄에 JSON 하나씩(NDJSON)** stdout 으로 흘린다. 그 위에 프로그램을 붙인다.
|
|
304
|
+
|
|
305
|
+
**바로 실행할 감시 에이전트 예제**가 패키지에 포함돼 있다. 작업할 프로젝트 폴더에서:
|
|
306
|
+
|
|
307
|
+
```bash
|
|
308
|
+
odyssey watch-agent init ../my-watch-agent
|
|
309
|
+
cd ../my-watch-agent
|
|
310
|
+
# config.json의 작업 폴더·프로필·Claude Code MCP 이름·예산 확인
|
|
311
|
+
node dispatcher.mjs --check
|
|
312
|
+
node dispatcher.mjs --dry-run
|
|
313
|
+
# 배달 예정 확인 후 Ctrl+C
|
|
314
|
+
node dispatcher.mjs
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
예제는 태그·멘션 배달, 항목별 세션 재개, 중복 방지·커서 보관, 준비 대기 제한시간·재연결, 단일 실행 잠금과 하루 예산을 갖춘다.
|
|
318
|
+
CLI와 Claude Code MCP는 같은 Odyssey 계정으로 로그인한다. 예제 생성은 기존 폴더를 덮어쓰거나 자동 시작을 등록하지 않는다.
|
|
319
|
+
자세한 설치·설정·중지 방법은 [예제 README](examples/watch-agent/README.md)를 따른다.
|
|
320
|
+
|
|
321
|
+
```bash
|
|
322
|
+
odyssey watch --tag "클로드 코드" # 그 태그 할일의 추가·수정·삭제 + 내 댓글
|
|
323
|
+
odyssey watch --tag 버그 --tag "새 기능" --no-comments
|
|
324
|
+
odyssey watch --since 2026-10-16T00:00:00+09:00 # 이 시각 뒤의 내 댓글부터(밀린 댓글)
|
|
325
|
+
odyssey watch --tag "클로드 코드" | my-dispatcher # 파이프로 프로그램에 넘기기
|
|
326
|
+
```
|
|
327
|
+
|
|
328
|
+
| 이벤트 | 내용 |
|
|
329
|
+
|---|---|
|
|
330
|
+
| `{"type":"ready", uid, streams, since}` | 첫 스냅샷까지 받았다 |
|
|
331
|
+
| `{"type":"todo", change, initial, uid, title, status, tags, updatedAt}` | `change` = added·modified·removed. 켠 직후의 첫 묶음은 `initial: true`(밀린 일) |
|
|
332
|
+
| `{"type":"comment", author, commentUid, itemType, itemUid, itemOwnerUid, parentItemUid, replyToCommentUid, roomUid, text, kind, createdAt}` | 내가 쓴 새 댓글. AI(MCP·컴패니언) 댓글은 기본으로 뺀다(`--include-agent`). `parentItemUid` = 보드 카드면 그 보드 · `replyToCommentUid` = 앱 「답글」이면 어느 댓글에 단 것인지 |
|
|
333
|
+
| `{"type":"error", stream, code, message}` | 그 스트림의 오류. Firestore 리스너는 오류 뒤 다시 붙지 않는다 — 받는 쪽이 감시를 다시 띄운다 |
|
|
334
|
+
|
|
335
|
+
- **OAuth 로그인 프로필만** 된다(`odyssey login`). API 키는 서버가 거절한다.
|
|
336
|
+
- 어떻게: CLI 로그인을 서버(`/cli/firebase-session`)에서 Firebase 커스텀 토큰 + App Check 토큰으로 바꿔 Firestore 리스너를 직접 붙인다.
|
|
337
|
+
Firebase 신원은 OAuth 연결마다 분리한다. 내 할일·내 댓글·읽을 수 있는 방 메타데이터만 읽고, 앱 데이터 쓰기는 허용하지 않는다.
|
|
338
|
+
`odyssey logout`으로 서버 연결이 회수되면 rules가 추가 데이터 접근을 거절하고 CLI 신원의 Firebase 갱신도 회수한다. 일반 앱 로그인은 유지한다.
|
|
339
|
+
Firebase 로그인 상태는 메모리에만 두고 App Check는 만료 때 다시 교환한다. Windows 발급·새 OAuth 연결 생성으로 파생 자격을 재사용할 수 없다.
|
|
340
|
+
- CLI 전용 Firebase 신원·규칙은 운영에 반영돼 있다(0.2.0+, 261025). 구버전 서버는 `watch`를 거절할 수 있다.
|
|
341
|
+
- 에이전트 댓글을 가르는 표식은 `metadata.authorKind`다. `claude`·`companion`·알 수 없는 비어 있지 않은 값은 모두 `agent`로 분류한다. 직접 디스패처를 만들 때 에이전트 댓글은 배달하지 않는다. 예제는 `--include-agent`로 표식을 받되, 세션 재개 판정에만 쓰고 일꾼에게 배달하지 않는다.
|
|
342
|
+
- **감시 에이전트 만들기**: `odyssey agent-guide --watch-agent` 가 코딩 에이전트(예: Claude Code)에게 줄 프롬프트를 낸다 —
|
|
343
|
+
디스패처는 **배달만** 한다: 감시 → 항목으로 일꾼 세션을 고르고 → 새로 만들거나(`--session-id`) 이어 받아(`--resume`) 깨운다.
|
|
344
|
+
입구는 감시 태그 할일과, 아무 항목 댓글의 멘션(`@클로드코드`) 둘이다. 세션이 생긴 항목은 그 스레드의 내 새 댓글·답글로 다시 깨운다. 세션이 없는 항목은 멘션으로 연다.
|
|
345
|
+
판단·작업·답글·상태는 깨운 세션의 Claude 가 Odyssey MCP 로 한다(`prompts/watch-agent.md`). 일이 없으면 토큰 0.
|
|
346
|
+
|
|
157
347
|
## 환경변수
|
|
158
348
|
|
|
159
349
|
| 이름 | 뜻 |
|
|
@@ -163,19 +353,24 @@ elif p.returncode != 0: log_error(p.stderr)
|
|
|
163
353
|
| `ODYSSEY_MCP_URL` | 서버 주소(기본 `https://mcp-odyssey30-60.odyssey365.app`) |
|
|
164
354
|
| `ODYSSEY_CONFIG_DIR` | 자격증명·캐시 위치(기본 `~/.odyssey/cli`) |
|
|
165
355
|
| `ODYSSEY_OUTPUT_DIR` | 이미지 저장 위치 |
|
|
166
|
-
| `ODYSSEY_TIMEOUT_MS` | 요청 제한 시간(기본 120000) |
|
|
356
|
+
| `ODYSSEY_TIMEOUT_MS` | 헤더부터 본문 수신 완료까지 요청 제한 시간(기본 120000). OAuth·MCP·감시 세션 교환 공통. 네트워크 실패는 종료 4 |
|
|
167
357
|
| `ODYSSEY_PRETTY=1` | 파이프에서도 JSON 들여쓰기 |
|
|
168
358
|
|
|
169
359
|
## 개발
|
|
170
360
|
|
|
171
361
|
```bash
|
|
172
362
|
npm install
|
|
173
|
-
npm test # 빌드 +
|
|
363
|
+
npm test # 빌드 + CLI 회귀·가짜 서버 E2E + 감시 예제 검사
|
|
364
|
+
npm run test:package # tarball → 새 prefix 설치 → 예제 추출·복사본 검사(게시 없음)
|
|
174
365
|
node dist/index.js --help
|
|
175
366
|
```
|
|
176
367
|
|
|
177
|
-
|
|
368
|
+
후보 준비: `npm run prepublishOnly`로 검사하고 `npm pack --pack-destination <폴더>`로 tarball을 만든다.
|
|
369
|
+
`prepack`은 빌드를 갱신하고, `prepublishOnly`는 전체 검사와 패키지 새 설치 검사까지 수행한다.
|
|
370
|
+
실제 게시 `npm publish`는 별도 배포 요청이 있을 때만 실행한다. CI는 Node 20·22·24에서 검사하며 게시 단계는 없다.
|
|
178
371
|
|
|
179
372
|
## License
|
|
180
373
|
|
|
181
374
|
MIT
|
|
375
|
+
|
|
376
|
+
> 2026-10-28: npm 검색 키워드(Odyssey60/30/365·OdysseyCLI)·AGENTS.md·에이전트 안내 보강. 공개판 0.2.1.
|
package/dist/files.js
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 로컬 파일 붙이기 — 도구 입력의 `image: { file: "경로" }` 를 보내기 전에 읽어 `{ data: base64, name }` 으로 바꾼다.
|
|
3
|
+
*
|
|
4
|
+
* 서버(MCP)는 바이트만 받는다 — 서버가 로컬 경로를 열 수는 없고, 임의 URL 을 받아 오는 길은 일부러 닫았다
|
|
5
|
+
* (snapshot-images.ts). 커넥터로 붙은 AI 는 파일을 못 읽지만 CLI 는 읽는다: 스냅샷 지면에 스크린샷을 올리는
|
|
6
|
+
* 운영 흐름이 이 한 단계로 열린다.
|
|
7
|
+
*
|
|
8
|
+
* - 바꾸는 자리는 **`image` 키의 객체**뿐이다(create_snapshot · update_snapshot · create_snapshot_draft 의 사진 칸).
|
|
9
|
+
* 이름이 다른 키의 `file` 은 손대지 않는다 — 다른 도구의 문자열을 파일로 오인해 읽어 보내면 안 된다.
|
|
10
|
+
* - 상대 경로는 `--input` 파일이 있는 폴더 기준(원고 JSON 옆에 그림을 두는 흐름), 없으면 지금 폴더.
|
|
11
|
+
*
|
|
12
|
+
* 이력: document/90-process/work-log/261011 MCP 스냅샷 AI 왕복 생성·수정 역할 어휘 통일 서식 표기.md
|
|
13
|
+
*/
|
|
14
|
+
import { readFileSync, statSync } from 'node:fs';
|
|
15
|
+
import { basename, isAbsolute, resolve } from 'node:path';
|
|
16
|
+
import { UsageError } from './config.js';
|
|
17
|
+
/** 서버 상한(한 장 10MB)보다 먼저 막는다 — 큰 파일을 base64 로 부풀려 보낸 뒤 거절받지 않게. */
|
|
18
|
+
export const MAX_INLINE_FILE_BYTES = 10 * 1024 * 1024;
|
|
19
|
+
/** 붙인 파일 수 — 호출부가 안내에 쓴다. */
|
|
20
|
+
export function inlineImageFiles(value, baseDir) {
|
|
21
|
+
let count = 0;
|
|
22
|
+
const visit = (node) => {
|
|
23
|
+
if (Array.isArray(node)) {
|
|
24
|
+
node.forEach(visit);
|
|
25
|
+
return;
|
|
26
|
+
}
|
|
27
|
+
if (!node || typeof node !== 'object')
|
|
28
|
+
return;
|
|
29
|
+
const obj = node;
|
|
30
|
+
for (const [key, child] of Object.entries(obj)) {
|
|
31
|
+
if (key === 'image' && child && typeof child === 'object' && !Array.isArray(child)) {
|
|
32
|
+
const img = child;
|
|
33
|
+
if (typeof img.file === 'string' && img.data === undefined) {
|
|
34
|
+
const path = isAbsolute(img.file) ? img.file : resolve(baseDir, img.file);
|
|
35
|
+
let size;
|
|
36
|
+
try {
|
|
37
|
+
size = statSync(path).size;
|
|
38
|
+
}
|
|
39
|
+
catch {
|
|
40
|
+
throw new UsageError(`image.file 을 찾지 못했습니다: ${path}`);
|
|
41
|
+
}
|
|
42
|
+
if (size > MAX_INLINE_FILE_BYTES) {
|
|
43
|
+
throw new UsageError(`image.file 이 ${(size / 1024 / 1024).toFixed(1)}MB 입니다 — 한 장은 10MB 까지입니다: ${path}`);
|
|
44
|
+
}
|
|
45
|
+
img.data = readFileSync(path).toString('base64');
|
|
46
|
+
if (img.name === undefined)
|
|
47
|
+
img.name = basename(path);
|
|
48
|
+
delete img.file;
|
|
49
|
+
count += 1;
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
visit(child);
|
|
54
|
+
}
|
|
55
|
+
};
|
|
56
|
+
visit(value);
|
|
57
|
+
return count;
|
|
58
|
+
}
|
package/dist/guide.js
ADDED
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AI 에이전트용 설명서 — `odyssey agent-guide`.
|
|
3
|
+
*
|
|
4
|
+
* 다른 AI(Claude Code·Codex·Gemini CLI·Cursor 등)가 이 CLI 를 처음 만나도 쓸 수 있게, 설명서를 CLI 자신이 낸다.
|
|
5
|
+
* 파일로 따로 두지 않는 이유: 계정(프로필)과 서버 사용 지침은 실행할 때마다 다를 수 있다 — 설명서가 그 순간의 사실을 말해야 한다.
|
|
6
|
+
*
|
|
7
|
+
* odyssey agent-guide 전문(사용법 + 로그인된 계정 + 서버 사용 지침 실시간)
|
|
8
|
+
* odyssey agent-guide --skill Claude Code·Codex 스킬 파일(SKILL.md) — "시작할 때 agent-guide 를 읽어라" 가리킴
|
|
9
|
+
* odyssey agent-guide --snippet AGENTS.md·CLAUDE.md·GEMINI.md 등에 붙일 짧은 절
|
|
10
|
+
*
|
|
11
|
+
* AGENTS.md(여러 코딩 에이전트가 함께 읽는 관례)는 **에이전트가 일하는 프로젝트 폴더에 두는 파일**이다 — 도구가
|
|
12
|
+
* 미리 실어 둘 수 없으니, 그 파일에 넣을 내용(--snippet)을 CLI 가 내고 그 내용이 "시작할 때 agent-guide 를 실행하라"고
|
|
13
|
+
* 가리킨다(`odyssey agent-guide --snippet >> AGENTS.md`).
|
|
14
|
+
*
|
|
15
|
+
* 서버 사용 지침(MCP instructions)은 MCP 커넥터라면 연결 때 받는 것인데, CLI 는 왕복을 줄이려 initialize 를
|
|
16
|
+
* 건너뛰어 받지 못했다 — 전문 모드가 initialize 를 한 번 보내 그대로 싣는다.
|
|
17
|
+
*
|
|
18
|
+
* 이력: document/90-process/work-log/261010 Odyssey CLI agent-guide 에이전트 설명서 서버 지침.md
|
|
19
|
+
* 이력: document/90-process/work-log/261028 Odyssey CLI 검색키워드 AGENTS 감시사례.md
|
|
20
|
+
*/
|
|
21
|
+
const CORE_RULES = `- **사용자의 데이터다.** 쓰기는 사용자 앱 화면·알림에 그대로 나타난다. 요청 범위를 넘는 생성·수정을 하지 않는다.
|
|
22
|
+
- \`[쓰기·덮어씀]\` 도구와 \`delete_*\` 는 사용자가 그 변경을 분명히 원할 때만 부른다(삭제는 휴지통으로 가지만 그래도 먼저 확인).
|
|
23
|
+
- 없는 UID·도구·파라미터를 추측하지 않는다 — \`odyssey search\`·\`list_*\` 로 찾는다. 이름으로 찾을 땐 \`search\` 가 먼저다.
|
|
24
|
+
- 쓰기 뒤에는 \`get_*\`/\`list_*\` 로 다시 읽어 결과를 확인하고, 실제로 한 일만 보고한다.
|
|
25
|
+
- 로그인(\`odyssey login\`)은 브라우저 인증이 필요한 **사람의 일**이다. 종료 코드 3 이면 사용자에게 부탁하고, 비밀번호·토큰을 직접 다루지 않는다.`;
|
|
26
|
+
function profileSection(input) {
|
|
27
|
+
const lines = ['## 계정(프로필)', ''];
|
|
28
|
+
if (input.envToken) {
|
|
29
|
+
lines.push('환경변수 `ODYSSEY_TOKEN` 이 설정돼 있어 `-p` 를 주지 않은 호출은 그 토큰의 계정으로 간다.', '');
|
|
30
|
+
}
|
|
31
|
+
if (input.profiles.length === 0) {
|
|
32
|
+
lines.push('로그인된 프로필이 없다. 사용자에게 터미널에서 `odyssey login` 을 실행해 브라우저로 로그인해 달라고 부탁한다.', '(계정을 여럿 쓰려면 `odyssey login -p <이름>` 으로 이름을 붙인다.)');
|
|
33
|
+
}
|
|
34
|
+
else {
|
|
35
|
+
lines.push('| 프로필 | 계정 | |', '|---|---|---|');
|
|
36
|
+
for (const p of input.profiles) {
|
|
37
|
+
const who = p.email ?? (p.auth === 'apiKey' ? '(API 키 — 계정 정보 없음)' : '(알 수 없음)');
|
|
38
|
+
lines.push(`| \`${p.name}\` | ${who} | ${p.isDefault ? '기본' : `\`-p ${p.name}\``} |`);
|
|
39
|
+
}
|
|
40
|
+
lines.push('', '- `-p <프로필>` 을 주지 않으면 기본 프로필이다. 사용자가 계정을 말하지 않았으면 기본으로 한다.', '- 여러 계정을 다룰 때는 쓰기 전에 `odyssey whoami -p <프로필>` 로 의도한 계정인지 확인한다.');
|
|
41
|
+
}
|
|
42
|
+
return lines.join('\n');
|
|
43
|
+
}
|
|
44
|
+
function instructionsSection(input) {
|
|
45
|
+
const from = input.instructionsFrom ? ` — 프로필 \`${input.instructionsFrom}\` 로 받음` : '';
|
|
46
|
+
if (input.serverInstructions) {
|
|
47
|
+
return `## 서버 사용 지침 (실시간${from})\n\nOdyssey 서버가 모든 AI 클라이언트에 주는 지침이다. 아래 \`getGuide\` 같은 이름은 \`odyssey getGuide\` 로 부른다.\n\n${input.serverInstructions.trim()}`;
|
|
48
|
+
}
|
|
49
|
+
return `## 서버 사용 지침\n\n받지 못했다${input.serverInstructionsError ? ` (${input.serverInstructionsError})` : ''}. 로그인한 뒤 \`odyssey agent-guide\` 를 다시 실행하면 여기에 실린다.\n복잡한 생성·구성(보드 꾸리기 등) 전에는 \`odyssey getGuide\` 로 지침 목록을 보고, 맞는 것을 \`odyssey getGuide --guideIds <ID>\` 로 읽은 뒤 그 절차를 따른다.`;
|
|
50
|
+
}
|
|
51
|
+
/** 전문 — 사용법 + 계정 + 서버 지침. */
|
|
52
|
+
export function renderAgentGuide(input) {
|
|
53
|
+
return `# Odyssey CLI — AI 에이전트 설명서 (odyssey ${input.version})
|
|
54
|
+
|
|
55
|
+
이 문서는 \`odyssey agent-guide\` 의 출력이다. 작업을 시작할 때 한 번 실행해 읽는다 — 계정·서버 지침은 그때그때 다를 수 있다.
|
|
56
|
+
|
|
57
|
+
## 무엇인가
|
|
58
|
+
|
|
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\` 예제를 먼저 돌린다.
|
|
77
|
+
|
|
78
|
+
${profileSection(input)}
|
|
79
|
+
|
|
80
|
+
## 작업 순서
|
|
81
|
+
|
|
82
|
+
1. **찾기** — \`odyssey tools [검색어]\`: 도구 목록. \`[읽기]\`·\`[쓰기]\`·\`[쓰기·덮어씀]\` 표시.
|
|
83
|
+
2. **확인** — \`odyssey describe <도구>\`: 설명 전문·파라미터. 설명에 적힌 선행 조건(먼저 부를 도구·읽을 지침)을 따른다.
|
|
84
|
+
3. **실행** — \`odyssey <도구> --파라미터 값 …\`, 또는 JSON 을 표준입력으로 \`odyssey <도구> --input -\`.
|
|
85
|
+
4. **확인** — 쓰기 뒤 다시 읽어 확인한다.
|
|
86
|
+
|
|
87
|
+
## 파라미터 적는 법
|
|
88
|
+
|
|
89
|
+
- \`--key 값\` · \`--key=값\` · 불리언 \`--flag\` / \`--no-flag\` · 배열은 반복(\`--tags a --tags b\`) 또는 JSON
|
|
90
|
+
- 객체 안쪽은 점 경로(\`--deadline.endTime 2026-10-20T18:00:00+09:00\`) 또는 JSON(\`--checklist '[{"title":"a"}]'\`) · null 은 \`null\`
|
|
91
|
+
- 필수 파라미터가 하나뿐이면 위치 인자: \`odyssey get_todo <todoId>\`
|
|
92
|
+
- 여러 값·특수 문자가 섞이면 \`--input -\` 에 JSON 객체를 넣는 편이 안전하다(셸 따옴표 문제 없음)
|
|
93
|
+
- 시각은 오프셋을 붙인 ISO 8601(\`+09:00\` 또는 \`Z\`)
|
|
94
|
+
- 같은 일을 다시 보낼 수 있는 자동화면 \`dedupeKey\` 를 준다(\`create_timeline_event\`·\`add_record_trace\` — 같은 키 = 한 번만 기록)
|
|
95
|
+
|
|
96
|
+
## 출력과 종료 코드
|
|
97
|
+
|
|
98
|
+
- stdout 은 결과 JSON(파이프면 한 줄), stderr 는 안내·오류. 이미지를 돌려주는 도구는 파일로 저장하고 \`{"images":[{"path":…}]}\` 를 준다.
|
|
99
|
+
- \`0\` 성공 · \`1\` 도구 오류(메시지를 읽고 고쳐 다시 — 틀린 파라미터면 서버가 맞는 이름을 알려 준다) · \`2\` 사용법 오류 ·
|
|
100
|
+
\`3\` 로그인 필요(사람의 일) · \`4\` 네트워크(잠시 뒤 재시도)
|
|
101
|
+
- \`-o text\` 는 서버가 만든 요약 텍스트, \`-o raw\` 는 MCP 결과 전체.
|
|
102
|
+
|
|
103
|
+
## 지켜야 할 것
|
|
104
|
+
|
|
105
|
+
${CORE_RULES}
|
|
106
|
+
|
|
107
|
+
${instructionsSection(input)}
|
|
108
|
+
`;
|
|
109
|
+
}
|
|
110
|
+
/** AGENTS.md·CLAUDE.md·GEMINI.md·Cursor 규칙 등에 붙일 짧은 절 — 기계마다 다른 계정 정보는 싣지 않는다. */
|
|
111
|
+
export function renderSnippet() {
|
|
112
|
+
return `## Odyssey / Odyssey365 (\`odyssey\` CLI)
|
|
113
|
+
|
|
114
|
+
**Odyssey60**(할일·메모·루틴·기록·일정·타임라인·보드) · **Odyssey30**(스냅샷·컬렉션) 데이터는 \`odyssey\` CLI(\`@odyssey365/cli\`)로 읽고 쓴다.
|
|
115
|
+
|
|
116
|
+
- **작업을 시작할 때 \`odyssey agent-guide\` 를 실행해 읽는다** — 사용법·로그인된 계정·최신 서버 지침·**실사용 사례**(감시 에이전트·자동 기록 등)가 나온다.
|
|
117
|
+
- 도구: \`odyssey tools\` → \`odyssey describe <도구>\` → \`odyssey <도구> --파라미터 값\`(또는 \`--input -\` 에 JSON). 결과는 JSON.
|
|
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\`. 디스패처는 배달만, 답글은 깨운 세션 몫.
|
|
121
|
+
${CORE_RULES}
|
|
122
|
+
`;
|
|
123
|
+
}
|
|
124
|
+
/** Claude Code·Codex 스킬 파일(SKILL.md). */
|
|
125
|
+
export function renderSkill() {
|
|
126
|
+
return `---
|
|
127
|
+
name: odyssey
|
|
128
|
+
description: Odyssey365 / Odyssey60 / Odyssey30 / OdysseyCLI — 할일·메모·보드·스냅샷과 감시 에이전트(watch-agent)·활동 자동 기록을 \`odyssey\` CLI(\`@odyssey365/cli\`)로 다룬다. Odyssey 데이터·태그/멘션 배달 에이전트·다계정(-p) 작업 시 사용.
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
${renderSnippet()}`;
|
|
132
|
+
}
|