能力标签
claude-code-statusline MCP工具
🔌
MCP工具

claude-code-statusline MCP工具

基于 Shell · 让 AI 助手直接操作你的系统与工具
英文名:claude-code-statusline
⭐ 446 Stars 🍴 27 Forks 💻 Shell 📄 MIT 🏷 AI 7.8分
7.8AI 综合评分
MCP工具Claude集成状态栏终端增强开源
✦ AI Skill Hub 推荐

AI Skill Hub 推荐使用:claude-code-statusline MCP工具 是一款优质的MCP工具。AI 综合评分 7.8 分,在同类工具中表现稳健。如果你正在寻找可靠的MCP工具解决方案,这是一个值得深入了解的选择。

📚 深度解析

claude-code-statusline MCP工具 是一款基于 MCP(Model Context Protocol)标准协议的 AI 工具扩展。MCP 协议由 Anthropic 开发并开源,旨在建立 AI 模型与外部工具之间的标准化通信接口,目前已被 Claude Desktop、Claude Code、Cursor 等主流 AI 工具采纳。

通过安装 claude-code-statusline MCP工具,你的 AI 助手将获得额外的工具调用能力,可以用自然语言直接操控该工具的功能,无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置,永久增强"——配置完成后,每次与 AI 对话时都可以无缝调用这些工具。

在技术实现上,MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信,工具的功能以"工具列表"的形式暴露给 AI 模型,AI 可以按需调用。claude-code-statusline MCP工具 提供了结构化的工具调用接口,使 AI 模型能够精确地理解和使用每个功能点,显著降低 AI 在工具使用上的错误率。

与传统的 API 集成相比,MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON,即可让 AI 获得全新能力。AI Skill Hub 将 claude-code-statusline MCP工具 评为 AI 评分 7.8 分,属于同类工具中的优质选择。

📋 工具概览

为Claude Code终端提供原子精度状态栏的开源MCP工具。支持实时状态显示、缓存管理和命令行增强功能,适合频繁使用Claude Code的开发者提升终端工作效率。

claude-code-statusline MCP工具 是一款遵循 MCP(Model Context Protocol)标准协议的 AI 工具扩展。通过 MCP 协议,它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务,实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用,都可以通过自然语言在 AI 对话中直接触发,极大提升生产效率。

GitHub Stars
⭐ 446
开发语言
Shell
支持平台
macOS / Linux
维护状态
轻量级项目,按需更新
开源协议
MIT
AI 综合评分
7.8 分
工具类型
MCP工具
Forks
27

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理,如需查看完整原始文档请访问底部「原始来源」。

为Claude Code终端提供原子精度状态栏的开源MCP工具。支持实时状态显示、缓存管理和命令行增强功能,适合频繁使用Claude Code的开发者提升终端工作效率。

claude-code-statusline MCP工具 是一款遵循 MCP(Model Context Protocol)标准协议的 AI 工具扩展。通过 MCP 协议,它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务,实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用,都可以通过自然语言在 AI 对话中直接触发,极大提升生产效率。

📌 核心特色
  • 通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
  • 提供结构化工具调用接口,显著降低 AI 集成复杂度
  • 支持 Claude Desktop 和 Claude Code 无缝接入,开箱即用
  • 可与其他 MCP 工具组合叠加,构建完整 AI 工作站
  • 轻量无侵入设计,不影响现有系统架构
🎯 主要使用场景
  • 在 Claude Desktop 对话中直接调用本地工具,实现 AI 与系统的深度联动
  • 通过自然语言驱动复杂的多步骤自动化任务,代替繁琐手动操作
  • 将多个 MCP 工具组合使用,构建个人专属 AI 工作站
以下安装命令基于项目开发语言和类型自动生成,实际以官方 README 为准。
安装命令
# 方式一:通过 Claude Code CLI 一键安装
claude skill install https://github.com/rz1989s/claude-code-statusline

# 方式二:手动配置 claude_desktop_config.json
{
  "mcpServers": {
    "claude-code-statusline-mcp--": {
      "command": "npx",
      "args": ["-y", "claude-code-statusline"]
    }
  }
}

# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json
📋 安装步骤说明
  1. 确认已安装 Node.js(v18 或以上版本)
  2. 打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
  3. 按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
  4. 保存配置文件并重启 Claude 客户端
  5. 重启后,在对话中即可使用本工具
以下用法示例由 AI Skill Hub 整理,涵盖最常见的使用场景。
常用命令 / 代码示例
# 安装后在 Claude 对话中直接使用
# 示例:
用户: 请帮我用 claude-code-statusline MCP工具 执行以下任务...
Claude: [自动调用 claude-code-statusline MCP工具 MCP 工具处理请求]

# 查看可用工具列表
# 在 Claude 中输入:"列出所有可用的 MCP 工具"
以下配置示例基于典型使用场景生成,具体参数请参照官方文档调整。
配置示例
// claude_desktop_config.json 配置示例
{
  "mcpServers": {
    "claude-code-statusline_mcp__": {
      "command": "npx",
      "args": ["-y", "claude-code-statusline"],
      "env": {
        // "API_KEY": "your-api-key-here"
      }
    }
  }
}

// 保存后重启 Claude Desktop 生效
📑 README 深度解析 真实文档 完整度 87/100 查看 GitHub 原文 →
以下内容由系统直接从 GitHub README 解析整理,保留代码块、表格与列表结构。

简介

███████╗███╗   ██╗██╗  ██╗ █████╗ ███╗   ██╗ ██████╗███████╗██████╗ 
██╔════╝████╗  ██║██║  ██║██╔══██╗████╗  ██║██╔════╝██╔════╝██╔══██╗
█████╗  ██╔██╗ ██║███████║███████║██╔██╗ ██║██║     █████╗  ██║  ██║
██╔══╝  ██║╚██╗██║██╔══██║██╔══██║██║╚██╗██║██║     ██╔══╝  ██║  ██║
███████╗██║ ╚████║██║  ██║██║  ██║██║ ╚████║╚██████╗███████╗██████╔╝
╚══════╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝ ╚═════╝╚══════╝╚═════╝

███████╗████████╗ █████╗ ████████╗██╗ ██╗███████╗██╗ ██╗███╗ ██╗███████╗ ██╔════╝╚══██╔══╝██╔══██╗╚══██╔══╝██║ ██║██╔════╝██║ ██║████╗ ██║██╔════╝ ███████╗ ██║ ███████║ ██║ ██║ ██║███████╗██║ ██║██╔██╗ ██║█████╗ ╚════██║ ██║ ██╔══██║ ██║ ██║ ██║╚════██║██║ ██║██║╚██╗██║██╔══╝ ███████║ ██║ ██║ ██║ ██║ ╚██████╔╝███████║███████╗██║██║ ╚████║███████╗ ╚══════╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚══════╝╚═╝╚═╝ ╚═══╝╚══════╝ </pre>

✨ Features

🛠️ DEVELOPMENT (Stable Development Features)

curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/dev/install.sh | bash -s -- --branch=dev

Check all dependencies (shows 6 feature categories)

curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash -s -- --check-all-deps

Comprehensive dependency analysis + interactive mode

curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash -s -- --check-all-deps --interactive

📋 Prerequisites

Choose your platform and install the required dependencies:

<details> <summary><strong>🍎 macOS</strong></summary>

```bash

Install dependencies via Homebrew

brew install jq coreutils

Install required dependencies

sudo apt update && sudo apt install jq

Install required dependencies

sudo apt update && sudo apt install jq

Enhanced dependency analysis

curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash -s -- --check-all-deps

🚀 Installation (2 minutes)

📋 Platform Requirements: 100% compatible across all major platforms - macOS (12+): brew install jq curl - Ubuntu/Debian: sudo apt install jq curl - Arch Linux: sudo pacman -S jq curl - Fedora/RHEL: sudo dnf install jq curl - Alpine Linux: apk add jq curl - Windows: WSL recommended with Ubuntu distribution

Choose your preferred installation method:

Option 1b: One-Line Install (Trust the Repo)

```bash

Direct install without inspection (for trusted users)

curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash ```

🔍 Enhanced Installer Options

```bash

Interactive installation with user choices

curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash -s -- --interactive

Install from development branch

curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/nightly/install.sh | bash -s -- --branch=nightly

Debug installation issues

STATUSLINE_INSTALL_DEBUG=true curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash ```

Option 2: Manual Install (No script required)

```bash

✅ Verify Installation Success

```bash

Confirm installation success

~/.claude/statusline/statusline.sh --version ls -la ~/.claude/statusline/lib/ # Should show 10+ module files

What Does This Install?

🔍 Transparency First - Here's exactly what happens:

Creates one directory: ~/.claude/statusline/ (in your home folder only) ✅ Downloads 31 text files: Shell scripts from this GitHub repository ✅ Creates one config file: Config.toml with default settings you can edit ✅ No system changes: Everything stays in your home folder

Does NOT: - Modify any system files or PATH - Install packages globally or change your OS - Require admin/sudo permissions - Send data anywhere or phone home - Modify your shell config (.bashrc, .zshrc, etc.)

🔐 Security: All files are downloaded from this public GitHub repository - you can inspect every line of code before running.

---

v1.5.2 - Enhanced Installation & Bug Fixes 🔧

  • 🛠️ Enhanced Installer - Fixed curl failure by ensuring directory creation before download
  • 📁 Improved Path Management - Enhanced installation path handling for better compatibility
  • 🎯 Streamlined Architecture - Simplified version management for easier maintenance
  • 🐛 Bug Fixes - Resolved missing model emojis in statusline display
  • 📋 Updated Documentation - Comprehensive documentation enhancements and project organization
  • ✅ Contributor Ready - Finalized CONTRIBUTING.md with complete development guidelines

🚀 Advanced Setup

For users who want additional installation options, development features, or specific configuration control.

📦 Installation Methods

Method 1: Revolutionary 3-Tier Download System (Recommended) 🚀

Our breakthrough v2.9.0 installer eliminates GitHub rate limits forever with intelligent 3-tier architecture and provides 100% download guarantee:

##### 🎯 Choose Your Experience Level: ```bash

Interactive installation menu

curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash -s -- --interactive

Add the tap and install

brew tap rz1989s/tap brew install claude-code-statusline

Verify installation

claude-statusline --help


> **Note**: The curl installer is still recommended for full automatic setup. Homebrew provides the formula but requires manual settings.json configuration.

<details>
<summary><strong>🚀 Revolutionary 3-Tier Download System Features</strong></summary>

**🎯 3-Tier Architecture (v2.9.0):**
- **Tier 1: Direct Raw URLs** → Unlimited requests, no API usage, fastest method (99% success rate)
- **Tier 2: GitHub API Fallback** → Optional token support (5,000/hour vs 60/hour)  
- **Tier 3: Comprehensive Retry** → Exponential backoff with intelligent verification

**🛡️ 100% Download Guarantee:**
- Either all modules download successfully or clear failure with troubleshooting
- Zero intervention required for normal installations
- Enhanced error handling with actionable guidance

**⚡ Smart System Detection:**
- Automatically detects your OS and package manager (brew, apt, yum, dnf, pacman)
- Provides platform-specific installation commands

**📊 Comprehensive Dependency Analysis:**
- `curl` + `jq` → Core installation and configuration
- 100% native → No external dependencies for cost tracking  
- `bc` → Precise cost calculations
- `python3` → Advanced TOML features and date parsing
- `timeout/gtimeout` → Network operation protection

**User-Friendly Options:**
- **Install now, upgrade later** - Get 67-100% functionality immediately
- **Show commands only** - Copy-paste exact commands for your system
- **Exit to install manually** - For users who prefer full control

**No Package Manager? No Problem:**
- Homebrew installation guidance for macOS users
- Manual installation instructions for restricted environments

</details>

**Quick Download & Inspect:**
bash

Deploy with Stow

cd ~/.dotfiles && stow claude

~/.claude/statusline/examples/Config.modular-compact.toml

~/.claude/statusline/examples/Config.modular-atomic.toml

🎥 Live Demo & Screenshots

Statusline Demo

🎨 Catppuccin Mocha Theme in VS Code Terminal

Beautiful Terminal

</div>

Test with sample input

echo '{"workspace": {"current_dir": "'"$(pwd)"'"}, "model": {"display_name": "Test"}}' | ~/.claude/statusline/statusline.sh ```

📸 Screenshot Showcase

v2.8.0 - Single Source Configuration Revolution 🧹🎯

🎯 REVOLUTIONARY SIMPLIFICATION: SINGLE SOURCE OF TRUTH ARCHITECTURE

Transform your configuration experience with the most significant architectural simplification ever:

  • 🧹 Configuration Breakthrough - Eliminated triple redundancy system:
  • Before: 13 example configs + hardcoded defaults + jq fallbacks = chaos
  • After: ONE comprehensive Config.toml with all 227 settings = clarity
  • 🎯 Zero Hunting - All parameters pre-filled in Config.toml, just edit values
  • 🔧 Zero Code Defaults - No more DEFAULT_CONFIG_* constants scattered in lib/config.sh
  • ⚡ Pure Extraction - No jq fallbacks (// "default"), reads directly from TOML
  • 📁 Simplified Structure - Only examples/Config.toml + README.md (no confusion)

🎯 USER EXPERIENCE TRANSFORMATION ```toml

BEFORE: Hunt for parameter names across 13 config files

AFTER: Edit ONE comprehensive file with ALL settings

~/.claude/statusline/Config.toml (227 settings included!)

theme.name = "catppuccin" # Theme selection display.lines = 5 # Line count (1-9) display.line1.components = ["repo_info", "commits", "version_info"] labels.commits = "Commits:" # Display labels

... ALL 227 settings right here!

```

---

v2.6.0 - Modular Component System & Configurable 1-9 Line Statusline 🧩🎯

🎯 MAJOR ARCHITECTURAL BREAKTHROUGH: MODULAR COMPONENT SYSTEM

  • Complete Component Architecture - 18 individual component modules with standardized interfaces (collect_data(), render(), get_config())
  • Configurable 1-9 Line Display - Flexible line layouts from minimal 1-line to comprehensive 9-line configurations
  • Component Registry System - Advanced component management with dependency tracking and enablement states
  • Mix & Match Flexibility - Arrange any component on any line position (MCP on line 1, prayer times on line 2, etc.)
  • Backward Compatibility - Legacy 5-line system preserved as fallback with seamless migration path

🧩 INDIVIDUAL COMPONENT MODULES

  • repo_info.sh - Repository directory and git status display
  • commits.sh - Commit count (pure atomic)
  • submodules.sh - Submodule tracking (pure atomic)
  • version_info.sh - Claude Code version with intelligent caching
  • time_display.sh - Current time formatting and display
  • model_info.sh - Claude model identification with emoji indicators
  • cost_repo.sh - Repository session cost tracking
  • cost_monthly.sh - 30-day costs (pure atomic)
  • cost_weekly.sh - 7-day costs (pure atomic)
  • cost_daily.sh - Daily costs (pure atomic)
  • cost_live.sh - Live billing block cost monitoring
  • mcp_status.sh - MCP server health and connection status
  • reset_timer.sh - Block reset countdown and timer management
  • prayer_times.sh - Islamic prayer times integration

⚙️ FLEXIBLE TOML CONFIGURATION SYSTEM

```toml

v1.2 - Enhanced Timeout Validation & Configuration Improvements 🚀

  • ✅ Comprehensive Timeout Validation - Enhanced bounds checking with contextual suggestions
  • 🔧 Smart Configuration Validation - Prevents dangerous timeout values (0s, >60s)
  • 📖 Enhanced CLI Documentation - Detailed timeout configuration guidance
  • 🛠️ New Helper Functions - parse_timeout_to_seconds() and validate_timeout_bounds()
  • 💡 Contextual Error Messages - Specific suggestions for optimal timeout ranges
  • 🔄 Backward Compatible - All existing configurations continue to work

v1.1 - Enhanced Directory Structure & TOML Configuration

  • 📋 TOML Configuration Files - Modern, structured configuration with Config.toml
  • 🔧 Rich CLI Interface - Generate, test, validate, and manage configurations
  • 📁 Single Config Location - ~/.claude/statusline/Config.toml (simple and consistent)
  • 🌐 Environment Overrides - ENV_CONFIG_* variables override all settings
  • 🔄 Live Reload - Hot configuration reloading with --watch-config
  • 🎨 Theme System - Built-in themes with full custom color support
  • ✅ Configuration Validation - Built-in testing and error checking with auto-fix suggestions
  • 📦 Migration Tools - Seamless migration from inline configuration
  • ⚡ 100% Backwards Compatible - Existing inline configuration continues to work

In your Config.toml file

prayer.location_mode = "auto" # ⭐ RECOMMENDED: Comprehensive auto-detection prayer.location_mode = "ip_based" # Force IP geolocation only (requires internet) prayer.location_mode = "manual" # Use manual coordinates (disable auto-detection)


#### **🔒 Privacy & Performance**

- **Privacy-First Design** - Location data cached locally, no tracking or data collection
- **IP Geolocation Transparency** - When using auto-detection, your IP address is sent to ip-api.com for location lookup (can be disabled)
- **Local Data Storage** - All location and prayer data stored locally in `~/.cache/claude-code-statusline/` 
- **No Personal Information** - Only coordinates and prayer calculation method are stored, no personal data
- **Manual Override Available** - Set `prayer.location_mode = "manual"` to completely disable IP-based detection
- **Graceful Degradation** - Works offline with timezone/locale fallbacks when internet unavailable
- **Intelligent Caching** - 7-day cache prevents repeated API calls, reduces external requests
- **Ultra-Fast Offline** - Timezone mapping completes in microseconds using local data structures
- **Zero Dependencies** - No external libraries required for offline operation

#### **🎯 Example Auto-Detection Results**
bash

🔧 **Enterprise-Grade Configuration**

  • 📋 TOML Configuration System - Modern structured configuration files
  • 🔧 Rich CLI Tools - Generate, test, validate, and manage configurations
  • 🎛️ Feature Toggles - Enable/disable any display section via TOML
  • 🌐 Environment Overrides - ENV_CONFIG_* variables for dynamic settings
  • 🎨 Advanced Theme System - Theme inheritance, profiles, and custom color schemes
  • 🔄 Live Configuration Reload - Hot reload with file watching capabilities
  • ⏲️ Enhanced Timeout Controls - Comprehensive validation with contextual bounds checking
  • 🏷️ Label Customization - Modify all display text and formats via TOML
  • 😊 Emoji Customization - Personalize status indicators
  • ✅ Configuration Validation - Built-in testing with auto-fix suggestions

---

In your Config.toml file

theme.name = "catppuccin"


**Environment Override:**
bash

Generate Config.toml with catppuccin theme

~/.claude/statusline.sh --generate-config

Then edit ~/.claude/statusline/Config.toml to set theme.name = "catppuccin"

```

In your Config.toml file

theme.name = "garden"


**Environment Override:**
bash

In your Config.toml file

theme.name = "classic"


**Environment Override:**
bash

In your Config.toml file

theme.name = "custom"

Generate base config then customize

~/.claude/statusline.sh --generate-config MyTheme.toml

🚀 DEV6 (Current Development - Settings.json Enhancement)

curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/dev6/install.sh | bash -s -- --branch=dev6 curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/dev6/install.sh | bash -s -- --branch=dev6 --preserve-statusline

Skip settings.json configuration (dev6 feature)

curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/dev6/install.sh | bash -s -- --branch=dev6 --preserve-statusline


#### Method 2: Homebrew (macOS)
bash

See all available options

./install.sh --help

Configure Claude Code (manual JSON editing)

Add to ~/.claude/settings.json:

Configure Claude Code (manual JSON editing)

Add to ~/.claude/settings.json:

Verify Claude Code configuration (check settings.json)

cat ~/

🎨 **Stunning Visual Interface**

Experience three beautifully crafted themes that transform your terminal into a work of art:

  • 🌙 Catppuccin Mocha - Rich, warm colors with excellent contrast
  • 🌿 Garden Theme - Soft pastels for a gentle, soothing aesthetic
  • ⚡ Classic Theme - Traditional terminal colors with modern polish
  • 🎨 Custom Themes - Full RGB/256-color/ANSI color customization

3. Download library modules (automated)

curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash -s -- --modules-only

v2.10.0 - Advanced Block Metrics Integration 🔥📊 **LATEST**

🚀 REVOLUTIONARY BLOCK METRICS SYSTEM - 4 NEW Block Metrics Components - 100% native cost calculation with 75% resource reduction - Unified Data Collection - Single API call feeds all metrics (burn rate, tokens, cache efficiency, projections) - Burn Rate Monitoring - Critical token consumption tracking (🔥3.5k/min $2.10/hr) - Cache Efficiency - Performance optimization insights (Cache: 94% hit) - Cost Projections - Budget planning and limit avoidance (Est: $16.48) - Resource Optimized - Minimal background processes, smart 30s caching

---

v2.7.0 - Atomic Component System ⚛️🎯

🎯 ULTIMATE CUSTOMIZATION: ATOMIC COMPONENT BREAKTHROUGH

Transform your statusline with 28 atomic components that eliminate separator issues and provide maximum control:

  • 🔬 Atomic Components - Single-purpose units for maximum control:
  • commits - Shows ONLY commit count (pure atomic)
  • submodules - Shows ONLY submodule status (pure atomic)
  • cost_monthly - Shows ONLY 30-day costs (pure atomic)
  • cost_weekly - Shows ONLY 7-day costs (pure atomic)
  • cost_daily - Shows ONLY daily costs (pure atomic)
  • 🎨 Clean Visual Separation - No more 30DAY $660.87 7DAY $9.31 DAY $36.10! Now: 30DAY $660.87 │ 7DAY $9.31 │ DAY $36.10
  • 🧩 Maximum Control - Want only commits without submodules? Use commits component only
  • ⚙️ Pure Atomic Architecture - No legacy bundled components, each component shows unique data only
  • 📋 8 Example Configs - Including new Config.modular-atomic.toml showcase

⚛️ ATOMIC CONFIGURATION EXAMPLES ```toml

Pure atomic components

display.line3.components = ["commits", "cost_weekly", "mcp_status"] ```

---

v2.2.0 - Islamic Prayer Times & Hijri Calendar Integration 🕌📅

🕌 MAJOR NEW FEATURE: ISLAMIC PRAYER TIMES

  • Complete Prayer Times Display - All 5 daily Islamic prayers (Fajr, Dhuhr, Asr, Maghrib, Isha) with real-time status indicators
  • AlAdhan API Integration - Accurate prayer time calculations using the trusted AlAdhan API with multiple calculation methods (ISNA, MWL, Makkah, etc.)
  • Visual Status Indicators - ✓ for completed prayers, time remaining display (e.g., "3h 29m") with green highlighting for upcoming prayers, elegant formatting with 🕌 Islamic indicator
  • Intelligent Caching - 1-hour cache duration for optimal performance, location-aware cache keys, automatic refresh

🌙 HIJRI CALENDAR WITH AUTHENTIC ISLAMIC TIMEKEEPING

  • Maghrib-Based Day Changes - Proper Islamic calendar where Hijri date changes at Maghrib (sunset), not midnight - authentic to Islamic tradition
  • Real-Time Hijri Date Display - Current Islamic date with Arabic month names (e.g., "2 Jumādá al-ūlá 1452")
  • Moon Phase Indicator - 🌙 symbol when Islamic day changes at Maghrib time
  • Multiple Calculation Standards - Support for Umm Al-Qura and other Hijri calculation methods

🔧 COMPREHENSIVE CONFIGURATION SYSTEM

  • Full Prayer Customization - Calculation methods (ISNA/MWL/Makkah), Madhab selection (Shafi/Hanafi), manual/auto location modes
  • Location Intelligence - Auto-detection or manual coordinates, timezone override support
  • Display Preferences - 12h/24h time formats, completed indicators, next prayer highlighting, countdown timers
  • Hijri Calendar Options - Arabic month names, weekday display, Maghrib change indicators, manual adjustments

🏗️ ENHANCED ARCHITECTURE

  • New Prayer Module - lib/prayer.sh with 400+ lines of Islamic timekeeping logic following existing modular patterns
  • Modular Display System - Configurable 1-9 line statusline with flexible component arrangement and dedicated Islamic prayer times
  • Comprehensive Testing - Complete unit test suite in tests/unit/test_prayer_functions.bats with edge case coverage
  • Performance Optimized - < 2s execution with intelligent caching, graceful API fallbacks, minimal external dependencies

📈 IMPACT: Muslim developers now have accurate Islamic timekeeping integrated seamlessly into their development workflow with authentic religious observance support.

---

🧩 **Revolutionary Modular Component System (v2.6.0)**

Repository Information

🎯 BREAKTHROUGH: Fully Configurable 1-9 Line Display System

Transform your statusline from a fixed layout to a completely personalized information dashboard! The revolutionary modular system gives you complete control over what information appears where.

🌟 Key Modular Features: - 📐 1-9 Line Flexibility - From ultra-minimal 1-line to comprehensive 9-line displays - 🧩 18 Individual Components - Mix, match, and reorder any component on any line - 🎛️ Component Registry - Advanced management with dependency tracking - ⚡ Real-time Reconfiguration - Change layouts instantly with environment variables - 🔄 Backward Compatible - Legacy 5-line system preserved as fallback

📋 Example Layout Transformations:

Ultra-Minimal (2-line):

display.lines = 2
display.line1.components = ["repo_info", "model_info"]
display.line2.components = ["cost_repo"]

Creative Reordering (6-line):

  
display.lines = 6
display.line1.components = ["mcp_status", "version_info"]      # MCP first!
display.line2.components = ["prayer_times", "time_display"]    # Prayer times priority
display.line3.components = ["repo_info", "model_info"]         # Repository info
display.line4.components = ["commits", "submodules"]               # Atomic git stats
display.line5.components = ["cost_repo", "cost_monthly", "cost_live"]  # All costs together
display.line6.components = ["reset_timer"]                     # Timer when active

📋 Default 5-Line Layout (Customizable):

Line 1: Repository & Environment (Components: repo_info, commits, submodules, version_info, time_display) - Working directory with elegant ~ notation - Git branch with clean/dirty status indicators - Today's commit count tracking - Claude Code version (intelligently cached) - Git submodule count - Current time display

Line 2: Model & Cost Tracking (Components: model_info, cost_repo, cost_monthly, cost_weekly, cost_daily, cost_live) - Current Claude model with emoji indicators - Repository session costs - 30-day, 7-day, and daily spending totals - Live billing block costs with native JSONL calculation - Real-time financial monitoring

MCP Server Monitoring

Line 3: MCP Server Health (Component: mcp_status) - Connected vs total server count - Server names with connection status - Color-coded indicators (🟢 connected, 🔴 disconnected) - Real-time health monitoring

Line 4: Block Reset Timer (Component: reset_timer) - Next reset time display - Countdown to block expiration - Smart detection and tracking

Line 5: Islamic Prayer Times (Component: prayer_times) - All 5 daily Islamic prayers (Fajr, Dhuhr, Asr, Maghrib, Isha) with accurate timing - Real-time Hijri date with authentic Maghrib-based day changes - Visual prayer status indicators (✓ completed, time remaining with green highlighting for upcoming) - AlAdhan API integration with multiple calculation methods - 🕌 Islamic formatting with moon phase indicators 🌙

🧩 **Modular Component System (v2.6.0)**

Available Components: - repo_info - Directory path and git status - commits - Commit count (atomic) - submodules - Submodule status (atomic) - version_info - Claude Code version - time_display - Current time - model_info - Claude model with emoji - cost_repo - Repository session cost - cost_monthly - 30-day costs (atomic) - cost_weekly - 7-day costs (atomic) - cost_daily - Daily costs (atomic) - cost_live - Live block cost - mcp_status - MCP server health - reset_timer - Block reset countdown - prayer_times - Islamic prayer times

Configuration Examples: ```toml

Download main script and all modules

curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/statusline.sh -o ~/.dotfiles/claude/.claude/statusline.sh chmod +x ~/.dotfiles/claude/.claude/statusline.sh

curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/core.sh -o ~/.dotfiles/claude/.claude/lib/core.sh curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/security.sh -o ~/.dotfiles/claude/.claude/lib/security.sh curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/config.sh -o ~/.dotfiles/claude/.claude/lib/config.sh curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/themes.sh -o ~/.dotfiles/claude/.claude/lib/themes.sh curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/git.sh -o ~/.dotfiles/claude/.claude/lib/git.sh curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/mcp.sh -o ~/.dotfiles/claude/.claude/lib/mcp.sh curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/cost.sh -o ~/.dotfiles/claude/.claude/lib/cost.sh curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/display.sh -o ~/.dotfiles/claude/.claude/lib/display.sh

Create lib directory and download all modules

mkdir -p ~/.claude/lib/ curl -L https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/core.sh -o ~/.claude/lib/core.sh curl -L https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/security.sh -o ~/.claude/lib/security.sh curl -L https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/config.sh -o ~/.claude/lib/config.sh curl -L https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/themes.sh -o ~/.claude/lib/themes.sh curl -L https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/git.sh -o ~/.claude/lib/git.sh curl -L https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/mcp.sh -o ~/.claude/lib/mcp.sh curl -L https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/cost.sh -o ~/.claude/lib/cost.sh curl -L https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/lib/display.sh -o ~/.claude/lib/display.sh

🇨🇳 中文文档镜像 AI 翻译 2026-05-29
英文原文章节由系统翻译为中文摘要,便于快速理解。完整原文见上方 "📑 README 深度解析"。
📌 简介

claude-code-statusline 是一款专为提升 Claude Code 使用体验而设计的终端状态栏工具。它通过在终端界面集成实时的状态监控,帮助开发者直观地掌握当前会话的上下文、Token 使用情况及各项运行指标,让 AI 辅助编程过程更加透明且高效。

⚡ 功能介绍

本项目提供强大的实时监控功能,支持对开发过程中的各项指标进行可视化展示。通过集成先进的指标系统,用户可以���时查看 Token 消耗、缓存效率及成本预测。此外,项目支持高度模块化的原子组件设计,允许开发者根据需求灵活定制状态栏内容,实现极致的个性化体验。

📋 环境依赖

在安装之前,请确保您的系统已满足必要的依赖条件。本项目支持 macOS (12+)、Ubuntu/Debian、Arch Linux、Fedora/RHEL 及 Alpine Linux 等主流 Linux 发行版。对于 Windows 用户,强烈建议通过 WSL (Windows Subsystem for Linux) 环境下的 Ubuntu 分发版进行部署。安装前请确保系统中已安装 `jq` 和 `curl` 工具。

🛠 安装步骤(Docker/pip/源码)

安装过程非常简单且快速,预计仅需 2 分钟。推荐使用官方提供的 Quick Install 脚本进行一键安装。为了确保安全性,建议在执行安装命令前先下载 `install.sh` 进行检查。本项目对各大主流操作系统均保持 100% 的兼容性,并提供完善的依赖检查机制,支持交互式模式以帮助用户快速修复环境问题。

🚀 使用教程

安装完成后,您可以通过查看项目提供的示例配置文件来快速上手。项目在 `~/.claude/statusline/examples/` 目录下内置了多种预设配置模板(如 `Config.modular-compact.toml` 和 `Config.modular-atomic.toml`),您可以根据自己的审美和信息密度需求,直接引用或修改这些��板来定制您的终端状态栏。

⚙️ 配置说明(含 MCP / env)

在 v2.8.0 版本中,我们引入了革命性的“单一事实来源 (Single Source of Truth)”架构。彻底告别了以往需要在多个配置文件与硬编码默认值之间反复切换的混乱局面。现在,您只需编辑一个统一的配置文件即可管理所有设置,极大地简化了配置流程,让参数管理变得直观且高效。

🔌 API 说明

本项目提供令人惊艳的视觉界面,内置了多种精心设计的色彩主题,如 Catppuccin Mocha、Garden Theme 以及经典的 Classic Theme。通过高度优化的 API 调用机制,系统能够以极低的资源消耗实现统一的数据采集,确保在展示精美视觉效果的同时,不会对终端性能造成负担。

🔄 工作流/模块

项目采用了先进的原子组件系统 (Atomic Component System),包含 28 个独立的原子组件,能够实现对特定信息的精准控制(如仅显示 Commit 数量)。最新的 v2.10.0 版本引入了革命性的 Block Metrics 系统,通过单次 API 调用即可实现 Burn Rate、Token 消耗及缓存效率的实时监控,资源占用降低了 75%。

🎯 aiskill88 AI 点评 A 级 2026-05-20

活跃的MCP生态工具,专注终端体验优化。446个Star表明社区认可,Shell实现轻量高效,适合集成到现有开发流程。

📚 实用指南(长尾问题)
适合谁
  • 需要让 Claude / Cursor 操作本地工具的 AI 工程师
最佳实践
  • 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC,避免暴露公网
常见错误
  • API key 直接提交到 git 仓库(请用 .env 并加入 .gitignore)
  • MCP 配置路径拼错或权限不足,重启 Claude Desktop 才生效
部署方案
  • 云端托管:可放在 Vercel / Railway / Fly.io 等 PaaS 平台
相关搜索
claude-code-statusline 中文教程claude-code-statusline 安装报错怎么办claude-code-statusline MCP 配置claude-code-statusline 与同类工具对比claude-code-statusline 最佳实践claude-code-statusline 适合谁用

⚡ 核心功能

👥 适合谁
  • 需要让 Claude / Cursor 操作本地工具的 AI 工程师
⭐ 最佳实践
  • 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC,避免暴露公网
⚠️ 常见错误
  • API key 直接提交到 git 仓库(请用 .env 并加入 .gitignore)
  • MCP 配置路径拼错或权限不足,重启 Claude Desktop 才生效

👥 适合人群

Claude Desktop / Claude Code 用户AI 工具开发者需要扩展 AI 能力的专业人士自动化工程师

🎯 使用场景

  • 在 Claude Desktop 对话中直接调用本地工具,实现 AI 与系统的深度联动
  • 通过自然语言驱动复杂的多步骤自动化任务,代替繁琐手动操作
  • 将多个 MCP 工具组合使用,构建个人专属 AI 工作站

⚖️ 优点与不足

✅ 优点
  • +MIT 协议,可免费商用
  • +标准化 MCP 协议,生态互联性强
  • +与 Claude 官方生态无缝对接
  • +即插即用,配置简单快捷
⚠️ 不足
  • 依赖 Claude 客户端,非 Claude 用户无法使用
  • MCP 协议仍在持续演进,接口可能变更
  • 需要一定的配置步骤
⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台,本页面信息基于公开数据整理,不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后,再部署至生产环境,并做好必要的安全评估。

📄 License 说明

✅ MIT 协议 — 最宽松的开源协议之一,可自由商用、修改、分发,仅需保留版权声明。

🔗 相关工具推荐

📚 相关教程推荐
📰 相关 AI 新闻
🍿 AI 圈相关吃瓜
🗺️ 相关解决方案
🧩 你可能还需要
基于当前 Skill 的能力图谱,自动补全的工具组合

❓ 常见问题 FAQ

主要针对Claude Code集成,建议使用最新版本获得最佳体验。
💡 AI Skill Hub 点评

总体来看,claude-code-statusline MCP工具 是一款质量良好的MCP工具,在同类工具中具备一定竞争力。AI Skill Hub 将持续追踪其更新动态,建议收藏备用,结合自身场景选择合适时机引入使用。

⬇️ 获取与下载
⬇ 下载源码 ZIP

✅ MIT 协议 · 可免费商用 · 直接从 aiskill88 服务器下载,无需跳转 GitHub

📚 深入学习 claude-code-statusline MCP工具
查看分步骤安装教程和完整使用指南,快速上手这款工具
🌐 原始信息
原始名称 claude-code-statusline
原始描述 开源MCP工具:Transform your Claude Code terminal with atomic precision statusline. Features f。⭐446 · Shell
Topics MCP工具Claude集成状态栏终端增强开源
GitHub https://github.com/rz1989s/claude-code-statusline
License MIT
语言 Shell
🔗 原始来源
🐙 GitHub 仓库  https://github.com/rz1989s/claude-code-statusline

收录时间:2026-05-17 · 更新时间:2026-05-19 · License:MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。

📺 订阅 AI Skill Hub Daily Telegram 频道
每天 8 条精选 AI Skill、MCP、Agent 与自动化工具推送
加入频道 →