pulse-line 1.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "pulse-line",
+  "owner": {
+    "name": "knqiufan",
+    "email": "knqiufan@gmail.com"
+  },
+  "metadata": {
+    "description": "A highly customizable status bar for Claude Code — 15 modules, 5 themes, i18n (zh/en), third-party API monitoring, and more",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "pulse-line",
+      "source": "./",
+      "description": "Real-time status bar showing model, context usage, git branch, cache, MCP status, account usage, turns, thinking, and more. Supports 5 themes, i18n (Chinese/English), and third-party API monitoring for Zhipu, DeepSeek, and MiniMax.",
+      "category": "monitoring",
+      "tags": ["statusline", "status-bar", "monitoring", "pulse-line", "claude-code", "i18n", "themes"]
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,27 @@
+{
+  "name": "pulse-line",
+  "version": "1.0.0",
+  "description": "A highly customizable status bar plugin for Claude Code with multi-theme support, i18n, and real-time monitoring",
+  "author": {
+    "name": "knqiufan",
+    "url": "https://github.com/knqiufan"
+  },
+  "homepage": "https://github.com/knqiufan/pulse-line",
+  "repository": "https://github.com/knqiufan/pulse-line",
+  "license": "MIT",
+  "keywords": ["claude-code", "statusline", "status-bar", "monitoring", "productivity", "pulse-line"],
+  "commands": [
+    "./commands/install.md",
+    "./commands/theme.md",
+    "./commands/themes.md",
+    "./commands/enable.md",
+    "./commands/disable.md",
+    "./commands/language.md",
+    "./commands/config.md",
+    "./commands/reload.md",
+    "./commands/clear-cache.md",
+    "./commands/debug.md",
+    "./commands/uninstall.md"
+  ],
+  "skills": "./skills/"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Pulse Line Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,316 @@
+# Pulse Line
+
+**English** | [中文](#中文)
+
+A highly customizable status bar plugin for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) with multi-theme support, i18n, and real-time monitoring.
+
+![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)
+![Node.js >=18](https://img.shields.io/badge/node-%3E%3D18-green.svg)
+
+## Installation
+
+### Plugin Marketplace (recommended)
+
+```
+/plugin marketplace add knqiufan/pulse-line
+/plugin install pulse-line
+```
+
+Then restart Claude Code. Pulse Line will auto-initialize on first run.
+
+### npx (zero install)
+
+Set the status bar command in your Claude Code `settings.json`:
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "npx -y pulse-line@latest"
+  }
+}
+```
+
+No global install needed — `npx` fetches and runs the latest version automatically. For a globally installed version, run `npm install -g pulse-line` and use `"command": "pulse-line"` instead.
+
+## Features
+
+- **15 Modules** — Model, Git branch, Context usage, Cache ratio, MCP status, Account usage, Turns, Thinking, and more
+- **5 Built-in Themes** — Dark, Light, Cyberpunk, Forest, Ocean
+- **i18n Support** — English (default) and Chinese, switchable via `/pulse-line:language`
+- **3rd Party API Usage** — Monitor Zhipu (GLM), DeepSeek, MiniMax account balance and quota
+- **Configurable Layout** — Custom module order, 3 segments per row, customizable separators
+- **Slash Commands** — 11 built-in commands for easy management
+
+## Usage
+
+All commands are available as slash commands within Claude Code:
+
+| Command | Description |
+|---------|-------------|
+| `/pulse-line:install` | Initialize configuration |
+| `/pulse-line:theme <name>` | Switch theme (dark, light, cyberpunk, forest, ocean) |
+| `/pulse-line:themes` | List available themes |
+| `/pulse-line:enable <module>` | Enable a module |
+| `/pulse-line:disable <module>` | Disable a module |
+| `/pulse-line:language <zh\|en>` | Switch display language |
+| `/pulse-line:config` | Open config in editor |
+| `/pulse-line:reload` | Reload configuration |
+| `/pulse-line:clear-cache` | Clear all cached data |
+| `/pulse-line:debug` | Toggle debug mode |
+| `/pulse-line:uninstall` | Remove configuration |
+
+CLI commands are also available outside Claude Code:
+
+```bash
+pulse-line enable thinking        # Enable a module
+pulse-line disable cost           # Disable a module
+pulse-line theme cyberpunk        # Switch theme
+pulse-line language zh            # Switch to Chinese
+pulse-line clear-cache            # Clear cache
+```
+
+## Modules
+
+| Module | ID | Default | Description |
+|--------|----|---------|-------------|
+| Model | `model` | On | Current AI model name |
+| Git Branch | `git` | On | Branch name and ahead/behind count |
+| Workspace | `workspace` | On | Current project name |
+| Context Usage | `context` | On | Context window usage with progress bar |
+| Cache | `cacheRatio` | On | Cached token count (K/M format) |
+| MCP | `mcpStatus` | On | Number of active MCP servers |
+| Account | `accountUsage` | On | 3rd-party API quota and balance |
+| Turns | `turns` | On | Conversation turn count |
+| Thinking | `thinking` | On | Extended thinking status |
+| Cost | `cost` | Off | Session cost in USD |
+| Duration | `duration` | Off | Session duration |
+| Rate Limits | `rateLimits` | Off | Anthropic API rate limit (5h window) |
+| Weekly Quota | `weeklyQuota` | Off | Anthropic API weekly quota |
+| Output Style | `outputStyle` | Off | Current output style |
+| Third-party API | `thirdPartyApi` | Off | Async API provider query |
+
+## 3rd Party Account Usage
+
+Pulse Line can monitor account balance and quota for third-party API providers:
+
+| Provider | Env Variables | Display |
+|----------|---------------|---------|
+| Zhipu (GLM) | `ZHIPU_API_KEY`, `ZHIPU_BASE_URL` | Usage % with countdown |
+| DeepSeek | `DEEPSEEK_API_KEY` | Balance in CNY |
+| MiniMax | `MINIMAX_API_KEY`, `MINIMAX_GROUP_ID` | Usage % with countdown |
+
+Providers are auto-detected from your Claude Code settings. You can also configure manually:
+
+```bash
+pulse-line config  # Edit providers array in accountUsage module
+```
+
+> [!NOTE]
+> Account usage data is obtained from third-party provider APIs. If the provider does not expose this information via its API, it cannot be displayed. Data shown is for reference only — always refer to the provider's official dashboard for accurate figures.
+
+## Configuration
+
+Config file: `~/.claude/pulse/config.json`
+
+```json
+{
+  "theme": "dark",
+  "language": "en",
+  "iconSet": "text",
+  "separator": " │ ",
+  "padding": 1,
+  "modules": {
+    "model": { "enabled": true, "order": 1, "icon": "[Model]" },
+    "git": { "enabled": true, "order": 2, "icon": "[Git]" },
+    "workspace": { "enabled": true, "order": 3, "icon": "[Workspace]" },
+    "context": { "enabled": true, "order": 4, "barWidth": 12 }
+  },
+  "advanced": {
+    "debugMode": false,
+    "cacheEnabled": true,
+    "cacheTTL": 300
+  }
+}
+```
+
+## Local Development
+
+```bash
+git clone https://github.com/knqiufan/pulse-line.git
+cd pulse-line
+npm install
+npm run build
+npm link
+
+# Load as local plugin in Claude Code
+claude --plugin-dir /path/to/pulse-line
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Claude Code CLI
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+<a id="中文"></a>
+
+# 中文
+
+**[English](#pulse-line)** | 中文
+
+一个高度可定制的 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 状态栏插件，支持多主题、国际化和实时监控。
+
+## 安装
+
+### Plugin Marketplace（推荐）
+
+```
+/plugin marketplace add knqiufan/pulse-line
+/plugin install pulse-line
+```
+
+重启 Claude Code 即可，首次运行 Pulse Line 会自动初始化配置。
+
+### npx（零安装）
+
+在 Claude Code 的 `settings.json` 中设置状态栏命令：
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "npx -y pulse-line@latest"
+  }
+}
+```
+
+无需全局安装 —— `npx` 每次自动拉取最新版执行。如果想全局安装，运行 `npm install -g pulse-line`，然后将 command 设为 `"pulse-line"` 即可。
+
+## 功能特性
+
+- **15 个模块** — 当前模型、Git 分支、上下文使用率、缓存、MCP 状态、账户用量、轮次、思考模式等
+- **5 个内置主题** — Dark、Light、Cyberpunk、Forest、Ocean
+- **国际化支持** — 默认英文，中文可通过 `/pulse-line:language zh` 切换
+- **第三方 API 用量** — 监控智谱 (GLM)、DeepSeek、MiniMax 账户余额和配额
+- **可配置布局** — 自定义模块顺序，每行 3 个指标，可自定义分隔符
+- **斜杠命令** — 11 个内置命令，方便管理
+
+## 使用方法
+
+所有命令均可在 Claude Code 中通过斜杠命令使用：
+
+| 命令 | 说明 |
+|------|------|
+| `/pulse-line:install` | 初始化配置 |
+| `/pulse-line:theme <name>` | 切换主题 (dark, light, cyberpunk, forest, ocean) |
+| `/pulse-line:themes` | 列出可用主题 |
+| `/pulse-line:enable <module>` | 启用模块 |
+| `/pulse-line:disable <module>` | 禁用模块 |
+| `/pulse-line:language <zh\|en>` | 切换显示语言 |
+| `/pulse-line:config` | 在编辑器中打开配置 |
+| `/pulse-line:reload` | 重新加载配置 |
+| `/pulse-line:clear-cache` | 清除所有缓存数据 |
+| `/pulse-line:debug` | 切换调试模式 |
+| `/pulse-line:uninstall` | 移除配置 |
+
+也可以在 Claude Code 外使用 CLI 命令：
+
+```bash
+pulse-line enable thinking        # 启用模块
+pulse-line disable cost           # 禁用模块
+pulse-line theme cyberpunk        # 切换主题
+pulse-line language zh            # 切换为中文
+pulse-line clear-cache            # 清除缓存
+```
+
+## 模块列表
+
+| 模块 | ID | 默认 | 说明 |
+|------|----|------|------|
+| 当前模型 | `model` | 开启 | 当前 AI 模型名称 |
+| Git 分支 | `git` | 开启 | 分支名及领先/落后数 |
+| 工作区 | `workspace` | 开启 | 当前项目名 |
+| 上下文使用率 | `context` | 开启 | 上下文窗口使用率（含进度条） |
+| 缓存 | `cacheRatio` | 开启 | 缓存 token 数量（K/M 格式） |
+| MCP | `mcpStatus` | 开启 | 活跃 MCP 服务器数量 |
+| 账户 | `accountUsage` | 开启 | 第三方 API 配额和余额 |
+| 轮次 | `turns` | 开启 | 对话轮次 |
+| 思考 | `thinking` | 开启 | 扩展思考模式状态 |
+| 费用 | `cost` | 关闭 | 会话费用（美元） |
+| 时长 | `duration` | 关闭 | 会话持续时间 |
+| 限速 | `rateLimits` | 关闭 | Anthropic API 限速（5 小时窗口） |
+| 配额 | `weeklyQuota` | 关闭 | Anthropic API 周配额 |
+| 风格 | `outputStyle` | 关闭 | 当前输出风格 |
+| 第三方 API | `thirdPartyApi` | 关闭 | 异步 API 供应商查询 |
+
+## 第三方账户用量
+
+Pulse Line 可以监控第三方 API 供应商的账户余额和配额：
+
+| 供应商 | 环境变量 | 显示内容 |
+|--------|----------|----------|
+| 智谱 (GLM) | `ZHIPU_API_KEY`、`ZHIPU_BASE_URL` | 使用率百分比及倒计时 |
+| DeepSeek | `DEEPSEEK_API_KEY` | 余额（人民币） |
+| MiniMax | `MINIMAX_API_KEY`、`MINIMAX_GROUP_ID` | 使用率百分比及倒计时 |
+
+供应商会从 Claude Code 设置中自动检测，也可手动配置：
+
+```bash
+pulse-line config  # 编辑 accountUsage 模块的 providers 数组
+```
+
+> [!NOTE]
+> 账户用量数据来源于第三方供应商 API，若官方未提供相关接口则无法显示。显示数据仅供参考，请以供应商官方后台为准。
+
+## 配置
+
+配置文件：`~/.claude/pulse/config.json`
+
+```json
+{
+  "theme": "dark",
+  "language": "en",
+  "iconSet": "text",
+  "separator": " │ ",
+  "padding": 1,
+  "modules": {
+    "model": { "enabled": true, "order": 1, "icon": "[Model]" },
+    "git": { "enabled": true, "order": 2, "icon": "[Git]" },
+    "workspace": { "enabled": true, "order": 3, "icon": "[Workspace]" },
+    "context": { "enabled": true, "order": 4, "barWidth": 12 }
+  },
+  "advanced": {
+    "debugMode": false,
+    "cacheEnabled": true,
+    "cacheTTL": 300
+  }
+}
+```
+
+## 本地开发
+
+```bash
+git clone https://github.com/knqiufan/pulse-line.git
+cd pulse-line
+npm install
+npm run build
+npm link
+
+# 在 Claude Code 中作为本地插件加载
+claude --plugin-dir /path/to/pulse-line
+```
+
+## 系统要求
+
+- Node.js >= 18.0.0
+- Claude Code CLI
+
+## 许可证
+
+[MIT](LICENSE)

package/bin/pulse-line.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+// Route to CLI if arguments present, otherwise render pulse
+
+const args = process.argv.slice(2);
+
+if (args.length === 0 && !process.stdin.isTTY) {
+  // No arguments and stdin provided -> render pulse
+  require('../dist/src/index.js');
+} else {
+  // Has arguments -> CLI mode
+  require('../dist/src/cli.js');
+}

package/commands/clear-cache.md

@@ -0,0 +1,23 @@
+---
+description: Clear all pulse cache files
+---
+
+# Clear Cache
+
+## Command
+
+```
+/pulse-line:clear-cache
+```
+
+## Description
+
+Clear all cached data for the pulse status bar, including API query results and session data. Useful when data appears stale or after configuration changes that don't seem to take effect.
+
+## Instructions
+
+Run the following shell command:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" clear-cache
+```

package/commands/config.md

@@ -0,0 +1,25 @@
+---
+description: Edit node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" configuration in editor
+---
+
+# Edit Configuration
+
+## Command
+
+```
+/pulse-line:config
+```
+
+## Description
+
+Opens `~/.claude/pulse/config.json` in your editor. Changes take effect on save.
+
+## Instructions
+
+Run the following shell command:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" config
+```
+
+The config file will open in the user's default editor. After saving, the new config takes effect immediately.

package/commands/debug.md

@@ -0,0 +1,25 @@
+---
+description: Toggle debug mode on or off
+---
+
+# Toggle Debug Mode
+
+## Command
+
+```
+/pulse-line:debug <on|off>
+```
+
+## Description
+
+Enable or disable debug mode. When enabled, verbose logs are written to stderr (requires `PULSE_DEBUG=1` env var).
+
+## Instructions
+
+Run the following shell command with the mode provided by the user:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" debug <on|off>
+```
+
+If the user did not specify `on` or `off`, ask which mode they want.

package/commands/disable.md

@@ -0,0 +1,27 @@
+---
+description: Disable a status bar module
+---
+
+# Disable Module
+
+## Command
+
+```
+/pulse-line:disable <module>
+```
+
+## Description
+
+Disable a status bar module. Changes take effect immediately on the next status bar render.
+
+Available module IDs: `model`, `context`, `git`, `accountUsage`, `cost`, `duration`, `workspace`, `turns`, `cacheRatio`, `rateLimits`, `weeklyQuota`, `mcpStatus`, `thinking`, `outputStyle`, `thirdPartyApi`.
+
+## Instructions
+
+Run the following shell command with the module name provided by the user:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" disable <module>
+```
+
+If the user did not provide a module name, list the available modules and ask which one they want to disable.

package/commands/enable.md

@@ -0,0 +1,27 @@
+---
+description: Enable a status bar module
+---
+
+# Enable Module
+
+## Command
+
+```
+/pulse-line:enable <module>
+```
+
+## Description
+
+Enable a status bar module. Changes take effect immediately on the next status bar render.
+
+Available module IDs: `model`, `context`, `git`, `accountUsage`, `cost`, `duration`, `workspace`, `turns`, `cacheRatio`, `rateLimits`, `weeklyQuota`, `mcpStatus`, `thinking`, `outputStyle`, `thirdPartyApi`.
+
+## Instructions
+
+Run the following shell command with the module name provided by the user:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" enable <module>
+```
+
+If the user did not provide a module name, list the available modules and ask which one they want to enable.

package/commands/install.md

@@ -0,0 +1,25 @@
+---
+description: Install pulse-line to Claude Code user settings
+---
+
+# Install Pulse Line
+
+## Command
+
+```
+/pulse-line:install
+```
+
+## Description
+
+Initialize pulse-line in your Claude Code user settings. After installation, restart Claude Code to see the status bar.
+
+## Instructions
+
+Run the following shell command:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" install
+```
+
+Then tell the user to restart Claude Code for the status bar to take effect.

package/commands/language.md

@@ -0,0 +1,27 @@
+---
+description: Switch display language (zh, en)
+---
+
+# Switch Language
+
+## Command
+
+```
+/pulse-line:language <lang>
+```
+
+## Description
+
+Switch the display language of the status bar labels. Available languages: `zh` (Chinese, default), `en` (English).
+
+Changes take effect immediately on the next status bar render.
+
+## Instructions
+
+Run the following shell command with the language code provided by the user:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" language <lang>
+```
+
+If the user did not provide a language, ask which one they want: `zh` (Chinese) or `en` (English).

package/commands/reload.md

@@ -0,0 +1,23 @@
+---
+description: Reload pulse-line configuration
+---
+
+# Reload Configuration
+
+## Command
+
+```
+/pulse-line:reload
+```
+
+## Description
+
+Reload the configuration file manually. Useful when you've edited `~/.claude/pulse/config.json` directly.
+
+## Instructions
+
+Run the following shell command:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" reload
+```

package/commands/theme.md

@@ -0,0 +1,27 @@
+---
+description: Switch status bar theme (dark, light, cyberpunk, forest, ocean)
+---
+
+# Switch Theme
+
+## Command
+
+```
+/pulse-line:theme <name>
+```
+
+## Description
+
+Switch the visual theme of the status bar. Available themes: `dark`, `light`, `cyberpunk`, `forest`, `ocean`.
+
+Changes take effect immediately on the next status bar render.
+
+## Instructions
+
+Run the following shell command with the theme name provided by the user:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" theme <name>
+```
+
+If the user did not provide a theme name, ask which theme they want to switch to.

package/commands/themes.md

@@ -0,0 +1,23 @@
+---
+description: List all available status bar themes
+---
+
+# List All Themes
+
+## Command
+
+```
+/pulse-line:themes
+```
+
+## Description
+
+List all available themes for the status bar.
+
+## Instructions
+
+Run the following shell command:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" themes
+```

package/commands/uninstall.md

@@ -0,0 +1,23 @@
+---
+description: Uninstall pulse-line from Claude Code
+---
+
+# Uninstall Pulse Line
+
+## Command
+
+```
+/pulse-line:uninstall
+```
+
+## Description
+
+Uninstall pulse-line. Configuration files are preserved — delete `~/.claude/pulse/` manually to remove everything.
+
+## Instructions
+
+Run the following shell command:
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/bin/pulse-line.js" uninstall
+```

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};