VibeJourney

English | 中文

你深夜 debug 的每一行代码，都在送你的 buddy 去看更远的世界。你在凌晨两点和一个 bug 较劲的时候，它正在巴塞罗那看日落。等你终于 ship 了那个 feature，它已经到了东京，还给你带了纪念品。

像旅行青蛙，但粮食来自你的 Claude Code token。你写代码，它去旅行。你回来看，它有了新故事。

快速开始

# 用你喜欢的包管理器全局安装
npm install -g vibejourney
pnpm add -g vibejourney
bun add -g vibejourney

# 然后运行
vibejourney

工作原理

你每天在 Claude Code 中消耗的 token 变成 buddy 的粮食预算：

• 你写代码 → buddy 有粮食（今天的 token）
• buddy 探索 → 参观当前城市的地标
• buddy 旅行 → 用剩余 token 走向下一座城市
• 今天没写代码 → buddy 休息

buddy 自己选目的地（你不控制它去哪）。它优先去没去过的城市。参观完一座城市的所有地标后，buddy 带上特产出发去下一站。

打开 VibeJourney，你会看到 buddy 趁你写代码的时候做了什么：

  ══════════════════════════════════════════════════
  📬 While you were coding...
  ══════════════════════════════════════════════════

  📸 Visited Shibuya Crossing  (3 more to see)
     "Sconce looked around with wide, curious eyes."
  📸 Visited Tokyo Tower  (2 more to see)
  📸 Visited Senso-ji Temple  (1 more to see)
  🍣 Picked up a souvenir: sushi set
  ✈️  Finished exploring Tokyo, heading to Seoul!
  🍃 Sconce shared tea with a friendly local
  🚶 On the road to Seoul — 892 km to go (18%)

  💬 "I heard the next city has great street food. Can't wait!"

  ══════════════════════════════════════════════════

特性

• 29 座城市 覆盖 6 大洲，每座城市有独特地标和特产
• 旅行青蛙机制 — 每日 token = 粮食预算，buddy 自己选路线
• Token 预算制 — 探索消耗 token，剩余预算转换为旅行距离
• 特产收藏 — buddy 从每座城市带回纪念品
• 里程碑成就 — 解锁城市、里程、特产相关的成就
• 随机旅途事件 — 发现隐藏小径、遇到当地人、发现稀有物品
• 旅程统计 — 查看总距离、城市数、特产、里程碑
• Braille 世界地图 Unicode 渲染 + buddy 精灵动画 + 实时位置追踪
• 18 种旅伴物种 性格驱动的旅途评论
• 叙事日志 — 基于地形、天气和 buddy 性格的旅行故事
• 离线支持 — 首次下载后地图本地缓存

城市、地标与特产

29 座城市，116 个地标，58 件特产。buddy 自己挑顺序，你只管写代码。

🌏 亚洲 (8)

| 城市 | 地标 | 特产 | |---|---|---| | Beijing | the Great Wall · the Forbidden City · Tiananmen Square · the Temple of Heaven | 🧧 jade bracelet · 🪭 silk fan | | Tokyo | Shibuya Crossing · Tokyo Tower · Senso-ji Temple · Mount Fuji in the distance | 🍣 sushi set · 🌸 sakura bookmark | | Seoul | Gyeongbokgung Palace · Bukchon Hanok Village · Namsan Tower · street food in Myeongdong | 🍵 ceramic teacup · 🎵 K-pop album | | Hong Kong | Victoria Peak · the Star Ferry · Temple Street Night Market · neon signs reflecting in puddles | 🥮 egg tart box · 💎 jade pendant | | Bangkok | the Grand Palace · Wat Arun at sunset · floating markets · tuk-tuks weaving through traffic | 🙏 golden Buddha charm · 🌶️ spicy sauce set | | Singapore | Marina Bay Sands · Gardens by the Bay · the Merlion · hawker stalls on every corner | 🌺 orchid pin · 🦁 Merlion figurine | | Mumbai | the Gateway of India · Marine Drive at night · Dharavi's colorful streets · Bollywood billboards everywhere | ☕ chai spice blend · 🧣 silk scarf | | Dubai | the Burj Khalifa · the Palm Jumeirah · the Dubai Mall · desert dunes at sunset | 🌴 golden dates box · 🧴 oud perfume |

🌍 欧洲 (9)

| 城市 | 地标 | 特产 | |---|---|---| | Istanbul | the Hagia Sophia · the Grand Bazaar · the Bosphorus at dawn · a cup of Turkish tea | 🍬 Turkish delight box · 🧿 evil eye charm | | Moscow | Red Square · St. Basil's Cathedral · the Kremlin walls · the Moscow Metro | 🪆 matryoshka doll · 💍 amber ring | | Prague | Charles Bridge · Prague Castle · the Astronomical Clock · a quiet beer garden | 🥂 crystal glass · 🎭 marionette puppet | | Berlin | the Brandenburg Gate · remnants of the Berlin Wall · Museum Island · currywurst from a street stand | 🧱 Wall fragment · 🥨 pretzel magnet | | Amsterdam | canals lined with bicycles · the Rijksmuseum · Anne Frank House · tulips at a flower market | 🌷 tulip bulb set · 🏠 Delft tile | | London | Big Ben · Tower Bridge · the British Museum · a red phone booth | 🫖 Earl Grey tea tin · 🚌 red bus model | | Paris | the Eiffel Tower · the Louvre · Montmartre at sunset · a fresh croissant | 🗼 tiny Eiffel Tower · 🧁 macaron box | | Barcelona | the Sagrada Familia · Park Guell · La Rambla · tapas at a tiny bar | 🎨 Gaudi mosaic tile · 🍷 sangria mix | | Rome | the Colosseum · the Trevi Fountain · the Vatican · gelato on the Spanish Steps | 🏛️ Colosseum snow globe · 🫒 truffle oil bottle |

🌍 非洲 (4)

| 城市 | 地标 | 特产 | |---|---|---| | Cairo | the Pyramids of Giza · the Sphinx · the Nile at dusk · Khan el-Khalili bazaar | 🏺 miniature pyramid · 📜 papyrus scroll | | Nairobi | Nairobi National Park · giraffes walking past the skyline · the Karen Blixen Museum · Kenyan coffee at a local cafe | ☕ Kenyan coffee beans · 📿 Maasai beads | | Marrakech | Jemaa el-Fnaa square · the Majorelle Garden · the Medina's winding alleys · mint tea on a rooftop | 🫒 argan oil bottle · 🧶 Berber rug swatch | | Cape Town | Table Mountain · the Cape of Good Hope · penguins at Boulders Beach · vineyards stretching to the hills | 🫖 rooibos tea tin · 🐧 penguin figure |

🌎 北美洲 (4)

| 城市 | 地标 | 特产 | |---|---|---| | New York | the Statue of Liberty · Times Square · Central Park · a New York slice | ☕ I♥NY mug · 🪙 subway token | | Los Angeles | the Hollywood sign · Santa Monica Pier · Venice Beach · palm trees lining the boulevard | ⭐ Hollywood star badge · 🕶️ sunglasses | | San Francisco | the Golden Gate Bridge · Alcatraz Island · cable cars on steep hills · fog rolling over the bay | 🔔 cable car bell · 🍞 sourdough starter | | Mexico City | the Zocalo · Frida Kahlo's Blue House · Chapultepec Castle · tacos al pastor from a street cart | 🪨 obsidian mirror · 🍫 hot chocolate mix |

🌎 南美洲 (2)

| 城市 | 地标 | 特产 | |---|---|---| | Buenos Aires | La Boca's colorful houses · Plaza de Mayo · a tango show on the street · steak sizzling at a parrilla | 🧉 mate gourd · 💃 tango music box | | Rio | Christ the Redeemer · Sugarloaf Mountain · Copacabana Beach · samba music in the streets | 🪇 samba shaker · 🫐 açaí bowl recipe |

🌏 大洋洲 (2)

| 城市 | 地标 | 特产 | |---|---|---| | Sydney | the Opera House · Harbour Bridge · Bondi Beach · the Blue Mountains | 🪃 boomerang keychain · 💠 opal stone | | Auckland | the Sky Tower · Rangitoto Island · sailing boats in the harbour · a hangi feast | 🟢 pounamu pendant · 🥝 kiwi plush |

命令

vibejourney                # 主界面：叙事 + 动画地图
vibejourney --journal      # 查看所有日志
vibejourney --journal last # 查看最近一条
vibejourney --collection   # 查看特产收藏
vibejourney --stats        # 查看旅程统计
vibejourney --reset        # 重置旅程（重新开始）
vibejourney --help         # 查看帮助信息

交互按键（地图界面）

| 按键 | 功能 | |------|------| | j | 打开日志 | | c | 打开特产收藏 | | s | 打开旅程统计 | | r | 刷新（检查新 token） | | q / ESC | 退出 |

地图图例

• ★ 已访问城市
• ◆ 当前目的地
• ● buddy 当前位置（旅行中）

城市会随着 buddy 的探索逐渐出现在地图上。每种物种有自己的食物（🔋 机器人吃电池、🥕 兔子吃胡萝卜等）。

开发

bun test              # 运行 35 个测试
src/config.ts         # 调整游戏平衡（token 消耗、旅行比例）

数据存储

所有数据存储在本地：

| 路径 | 内容 | |------|------| | ~/.vibejourney/state.json | 旅程状态（当前城市、地标、特产、里程碑） | | ~/.vibejourney/journal.jsonl | 到达和探索日志 | | ~/.vibejourney/cache/ | 缓存的 GeoJSON 地图数据 |

环境要求

• Node.js 18+ / Bun / pnpm
• 已安装 Claude Code（用于读取 ~/.claude/projects/ 下的 JSONL token 日志）
• Claude Code companion 已启用（可选，用于 buddy 评论）

许可证

MIT