User Intent → Execution Path Quick Reference
| User says | Path | Login required? |
|---|---|---|
| "Generate roadbook link" / "Help me plan a route" / share a travel plan | → Go to Generate Roadbook Flow(Step A) | Required cyeam login |
| "View roadbook list" | → Go to List Roadbooks Flow(Step B) | Required cyeam login |
| "Login" / "Log in to roadbook" | → Go to Login Flow(Step C) | — |
| "View details of a certain roadbook" | → Go to View Roadbook Flow(Step D) | Not required |
Install
# macOS Apple Silicon
curl -L https://github.com/mnhkahn/cyeam-cli/releases/latest/download/cyeam_Darwin_arm64.tar.gz | tar xz && chmod +x cyeam && sudo mv cyeam /usr/local/bin/
# macOS Intel
curl -L https://github.com/mnhkahn/cyeam-cli/releases/latest/download/cyeam_Darwin_x86_64.tar.gz | tar xz && chmod +x cyeam && sudo mv cyeam /usr/local/bin/
curl -L https://github.com/mnhkahn/cyeam-cli/releases/latest/download/cyeam_Linux_x86_64.tar.gz | tar xz && chmod +x cyeam && sudo mv cyeam /usr/local/bin/
检查安装：`which cyeam && cyeam version`
## 命令
cyeam roadbook list List all roadbooks from OneDrive cyeam roadbook share <file.json> Share a local roadbook JSON, returning the id and shareable URL cyeam roadbook get View details of a shared roadbook cyeam roadbook csv Read CSV text from stdin to generate a roadbook (requires cyeam login)
## 输出
`list` 以表格显示：
Title Modified Time Link ────────────── ──────────── ───────── Kyoto Three-Day Trip 2026-03-15 Link
`share` 和 `csv` 返回 JSON：`{"id":"xxx","url":"https://www.cyeam.com/tool/roadbook?id=xxx"}`
---
## ⚠️ 执行流程（模型请严格按步骤执行）
### 步骤 A：生成路书链接（用户说"生成路书" / 分享旅行计划时使用）
直接按以下步骤执行：
**A1. 检查登录**
```bash
cyeam whoami
If the output contains "Not logged in", first go to Step C to log in, then continue.
A2. Organize itinerary information If the user has already provided a complete itinerary (places, days, order), skip directly to A3 to organize the CSV. When information is insufficient, only ask about the missing items.Do not ask unnecessary questions.
A3. Organize CSV
One place per line, 5 columns separated by commas:名称,地址,类型,日期,备注
- Type: attraction/dining/accommodation/starting point/other
- Date: Day1 / Day2... or 5.1 / 5.2...
A4. Execute command
Use printf piped to cyeam roadbook csv，Do not create temporary files：
printf "%s\n" \
"故宫博物院,北京市东城区景山前街4号,景点,Day1,上午" \
"国家博物馆,北京市东城区东长安街16号,景点,Day1,下午" \
| cyeam roadbook csv --title "北京行" --pretty
The command does three things in sequence:
- Save the roadbook JSON to OneDrive
路书folder - Call the
/api/roadbook/shareAPI to generate a short share link - Return the JSON result
A5. Return result
The output contains the url field; reply directly to the user:
The roadbook has been generated. Click the link to view the complete itinerary map:https://www.cyeam.com/tool/roadbook?id=xxx
A6. Check output
- If a "Not logged in" error is reported, go to Step C to log in
- If another error is reported, tell the user the error message
Step B: List roadbooks (user says "list roadbooks" / "my roadbooks")
B1. Check login status
cyeam whoami
If the output contains "Not logged in", go to Step C to have the user log in first.
B2. List roadbooks
cyeam roadbook list --pretty
B3. Return to the user Display the title and modified time in table form.
Step C: Log in (the user says "log in" or not being logged in is detected in B1)
C1. Perform login
cyeam login
The command will print an authorization link and a verification code: when a desktop environment is available, it automatically tries to open a browser; on a remote server (SSH, etc., with no desktop environment), the browser will silently fail, so just complete authorization in any browser using the printed link and verification code, and the CLI will automatically obtain the token.
C2. Inform the user Tell the user:
Please visit the displayed link in your browser (https://microsoft.com/devicelogin），输入验证码完成登录。登录后回到这里继续。
C3. Run the command and wait After running the command, the CLI will wait for the user to complete authorization in the browser. Wait for the command output result.
C4. Verify login
cyeam whoami
Confirm that the "logged in" status is displayed.
Step D: View route book details (the user says "view a certain route book")
Execute directly:
cyeam roadbook get <id> --pretty
Return the route book data in JSON format. Display the content to the user.
Notes
csv、listRequirescyeam login(Microsoft OneDrive login)get、shareNo login required, operates through the cyeam.com APIcsvCommand flow: log in → parse CSV → save to OneDrive路书folder → call share API → return short link- Route book data is stored in the OneDrive
路书folder + Redis share snapshot (valid for 30 days)