@cosmicstack/mercury-agent 1.1.4 → 1.1.6

package/README.md

@@ -1,8 +1,8 @@
 <p align="center">
   <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="docs/card-dark.png">
-    <source media="(prefers-color-scheme: light)" srcset="docs/card-light.png">
-    <img alt="Mercury — Soul-Driven AI Agent" src="docs/card-light.png" width="600">
+    <source media="(prefers-color-scheme: dark)" srcset="docs/img/card-dark.png">
+    <source media="(prefers-color-scheme: light)" srcset="docs/img/card-light.png">
+    <img alt="Mercury — Soul-Driven AI Agent" src="docs/img/card-light.png" width="600">
   </picture>
 </p>
 
@@ -39,12 +39,13 @@ npm i -g @cosmicstack/mercury-agent
 mercury
 ```
 
-First run triggers the setup wizard — enter your name, an API key, and optionally a Telegram bot token. Takes 30 seconds.
+First run triggers the setup wizard (name, provider, optional Telegram). After setup, Mercury opens the Ink TUI startup screen and asks for your permission mode (`Ask Me` or `Allow All`) before chat starts.
 
 To reconfigure later (change keys, name, settings):
 
 ```bash
 mercury doctor
+mercury doctor --platform
 ```
 
 ## Why Mercury?
@@ -59,6 +60,8 @@ Every AI agent can read files, run commands, and fetch URLs. Most do it silently
 - **Always on** — Run as a background daemon on any OS. Auto-restarts on crash. Starts on boot. Cron scheduling, heartbeat monitoring, and proactive notifications.
 - **Extensible** — Install community skills with a single command. Schedule skills as recurring tasks. Based on the [Agent Skills](https://agentskills.io) specification.
 
+Mercury now seeds a default `web-search` skill on first run in `~/.mercury/skills/web-search/SKILL.md`.
+
 ## Daemon Mode
 
 **One command to make Mercury persistent:**
@@ -115,7 +118,8 @@ In daemon mode, Telegram becomes your primary channel — CLI is log-only since
 | `mercury restart` | Restart the background process |
 | `mercury stop` | Stop a background process |
 | `mercury logs` | View recent daemon logs |
-| `mercury doctor` | Reconfigure (Enter to keep current values) |
+| `mercury doctor` | Reconfigure setup (name, providers, channels, permissions defaults) |
+| `mercury doctor --platform` | Show cross-platform terminal/daemon compatibility diagnostics |
 | `mercury setup` | Re-run the setup wizard |
 | `mercury status` | Show config and daemon status |
 | `mercury help` | Show full manual |
@@ -149,6 +153,11 @@ Type these during a conversation — they don't consume API tokens. Work on both
 | `/budget reset` | Reset usage to zero |
 | `/budget set <n>` | Change daily token budget |
 | `/permissions` | Change permission mode (Ask Me / Allow All) |
+| `/view` | Toggle progress view (balanced/detailed) |
+| `/view balanced` | Set compact progress view |
+| `/view detailed` | Set full progress view |
+| `/code agent <task>` | Delegate a coding task to a sub-agent in background |
+| `/ws exit` | Exit workspace IDE mode back to general chat |
 | `/tasks` | List scheduled tasks |
 | `/memory` | View and manage second brain memory |
 | `/unpair` | Telegram: reset all access |
@@ -170,9 +179,24 @@ Type these during a conversation — they don't consume API tokens. Work on both
 
 | Channel | Features |
 |---------|----------|
-| **CLI** | Readline prompt, arrow-key command menus, real-time text streaming with markdown re-rendering, permission mode picker |
+| **CLI** | Ink TUI, startup permission mode picker, interactive permission prompts (arrow keys + Enter; Y/N/A shortcuts), progress views (balanced/detailed), real-time streaming |
 | **Telegram** | HTML formatting, editable streaming messages, file uploads, typing indicators, multi-user access with admin/member roles |
 
+### Workspace/Coding Shortcuts (CLI)
+
+- `Ctrl+P` → switch to Plan mode
+- `Ctrl+X` → switch to Execute mode
+- `Esc` or `Ctrl+Q` → exit workspace to general chat
+- `Ctrl+V` → toggle progress view (`/view` is fallback when terminal intercepts Ctrl+V)
+
+### Spotify UI Notes (CLI)
+
+- Spotify deck supports keyboard shortcuts: `N` next, `P` previous, `+/-` volume, `Z` now playing.
+- Inline album art is optional and safe-gated:
+  - Enable with `MERCURY_SPOTIFY_ART=1`
+  - Currently renders only in local iTerm sessions
+  - Automatically falls back to text-only UI in SSH/mobile/light terminals
+
 ### Telegram Access
 
 Mercury uses an **organization access model** with admins and members.

package/README.zh-CN.md

@@ -21,7 +21,7 @@ npm i -g @cosmicstack/mercury-agent
 mercury
 ```
 
-首次运行会启动配置向导。你需要输入姓名、模型 API Key，并可选择配置 Telegram Bot Token。之后如需重新配置：
+首次运行会启动配置向导（姓名、模型、可选 Telegram）。完成后会进入 Ink TUI 启动画面，并在进入聊天前让你选择权限模式（`Ask Me` / `Allow All`）。之后如需重新配置：
 
 ```bash
 mercury doctor
@@ -76,7 +76,7 @@ mercury status       # 查看运行状态
 | `mercury restart` | 重启后台进程 |
 | `mercury stop` | 停止后台进程 |
 | `mercury logs` | 查看近期日志 |
-| `mercury doctor` | 重新配置，回车保留现有值 |
+| `mercury doctor` | 重新配置 Mercury（姓名、Provider、频道、权限默认项） |
 | `mercury setup` | 重新运行配置向导 |
 | `mercury status` | 查看配置和守护进程状态 |
 | `mercury help` | 查看完整手册 |
@@ -110,6 +110,9 @@ mercury status       # 查看运行状态
 | `/budget reset` | 将用量重置为零 |
 | `/budget set <n>` | 修改每日 Token 预算 |
 | `/permissions` | 修改权限模式 |
+| `/view` | 切换进度视图（balanced/detailed） |
+| `/view balanced` | 使用精简进度视图 |
+| `/view detailed` | 使用详细进度视图 |
 | `/tasks` | 列出定时任务 |
 | `/memory` | 查看和管理 Second Brain 记忆 |
 | `/unpair` | Telegram：重置所有访问 |
@@ -131,7 +134,7 @@ mercury status       # 查看运行状态
 
 | 渠道 | 能力 |
 |------|------|
-| CLI | Readline 提示符、方向键命令菜单、实时文本流、Markdown 重渲染、权限模式选择 |
+| CLI | Ink TUI、启动权限模式选择、交互式权限审批（方向键 + Enter，支持 Y/N/A 快捷键）、balanced/detailed 进度视图、实时文本流 |
 | Telegram | HTML 格式化、可编辑流式消息、文件上传、输入状态、多用户访问和管理员/成员角色 |
 
 ### Telegram 访问模型