[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-sirmalloc--ccstatusline":3,"tool-sirmalloc--ccstatusline":64},[4,18,26,39,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,2,"2026-04-10T01:20:03",[13,14,15,16],"插件","Agent","图像","开发框架","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[13,16],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":10,"last_commit_at":32,"category_tags":33,"status":17},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",85092,"2026-04-10T11:13:16",[15,34,35,13,14,36,37,16,38],"数据工具","视频","其他","语言模型","音频",{"id":40,"name":41,"github_repo":42,"description_zh":43,"stars":44,"difficulty_score":45,"last_commit_at":46,"category_tags":47,"status":17},7525,"codex","openai\u002Fcodex","Codex 是 OpenAI 推出的一款轻量级编程智能体，专为在终端环境中高效运行而设计。它允许开发者直接在命令行界面与 AI 交互，完成代码生成、调试、重构及项目维护等任务，无需频繁切换至浏览器或集成开发环境，从而显著提升了编码流程的连贯性与专注度。\n\n这款工具主要解决了传统 AI 辅助编程中上下文割裂的问题。通过将智能体本地化运行，Codex 能够更紧密地结合当前工作目录的文件结构，提供更具针对性的代码建议，同时支持以自然语言指令驱动复杂的开发操作，让“对话即编码”成为现实。\n\nCodex 非常适合习惯使用命令行的软件工程师、全栈开发者以及技术研究人员。对于追求极致效率、偏好键盘操作胜过图形界面的极客用户而言，它更是理想的结对编程伙伴。\n\n其独特亮点在于灵活的部署方式：既可作为全局命令行工具通过 npm 或 Homebrew 一键安装，也能无缝对接现有的 ChatGPT 订阅计划（如 Plus 或 Pro），直接复用账户权益。此外，它还提供了从纯文本终端到桌面应用的多形态体验，并支持基于 API 密钥的深度定制，充分满足不同场景下的开发需求。",75220,1,"2026-04-14T14:40:34",[37,14,13],{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":17},6520,"openai-cookbook","openai\u002Fopenai-cookbook","openai-cookbook 是 OpenAI 官方提供的一套实用代码示例与指南合集，旨在帮助开发者快速上手并掌握 OpenAI API 的核心用法。面对大模型应用中常见的提示词工程、函数调用、数据嵌入及复杂任务编排等挑战，新手往往难以找到标准化的实现路径。openai-cookbook 通过提供经过验证的代码片段和详细教程，有效解决了“如何从零开始构建应用”以及“如何最佳实践特定功能”的痛点。\n\n这套资源主要面向软件开发者和 AI 技术研究人员，同时也适合希望深入理解大模型能力的技术爱好者。虽然示例代码主要以 Python 编写，但其背后的设计思路和技术逻辑具有通用性，可轻松迁移至其他编程语言。其独特亮点在于内容紧跟官方最新特性更新，覆盖了从基础文本生成到高级代理（Agent）构建的全场景需求，且所有示例均支持在本地环境直接运行调试。作为开源项目，它采用宽松的 MIT 许可证，鼓励社区贡献与二次开发，是学习大模型应用开发不可或缺的实战手册。",72659,"2026-04-10T21:55:21",[37,13],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":17},51,"gstack","garrytan\u002Fgstack","gstack 是 Y Combinator CEO Garry Tan 亲自开源的一套 AI 工程化配置，旨在将 Claude Code 升级为你的虚拟工程团队。面对单人开发难以兼顾产品战略、架构设计、代码审查及质量测试的挑战，gstack 提供了一套标准化解决方案，帮助开发者实现堪比二十人团队的高效产出。\n\n这套配置特别适合希望提升交付效率的创始人、技术负责人，以及初次尝试 Claude Code 的开发者。gstack 的核心亮点在于内置了 15 个具有明确职责的 AI 角色工具，涵盖 CEO、设计师、工程经理、QA 等职能。用户只需通过简单的斜杠命令（如 `\u002Freview` 进行代码审查、`\u002Fqa` 执行测试、`\u002Fplan-ceo-review` 规划功能），即可自动化处理从需求分析到部署上线的全链路任务。\n\n所有操作基于 Markdown 和斜杠命令，无需复杂配置，完全免费且遵循 MIT 协议。gstack 不仅是一套工具集，更是一种现代化的软件工厂实践，让单人开发者也能拥有严谨的工程流程。",72039,"2026-04-14T11:09:58",[14,13],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":78,"owner_location":79,"owner_email":80,"owner_twitter":78,"owner_website":78,"owner_url":81,"languages":82,"stars":91,"forks":92,"last_commit_at":93,"license":94,"difficulty_score":10,"env_os":95,"env_gpu":96,"env_ram":96,"env_deps":97,"category_tags":102,"github_topics":103,"view_count":10,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":114,"updated_at":115,"faqs":116,"releases":146},7579,"sirmalloc\u002Fccstatusline","ccstatusline","🚀 Beautiful highly customizable statusline for Claude Code CLI with powerline support, themes, and more.","ccstatusline 是一款专为 Claude Code CLI 打造的命令行状态栏美化工具。它能在终端顶部实时展示模型信息、Git 分支状态、Token 消耗量及生成速度等关键指标，将原本单调的交互界面变得直观且富有信息量。\n\n对于频繁使用 Claude Code 进行开发的用户而言，它解决了在复杂工作流中难以快速获取上下文状态（如代码变更详情、账户信息及令牌余量）的痛点，无需切换窗口或输入额外命令即可掌握全局动态。这款工具特别适合开发者、AI 工程师以及任何希望提升终端工作效率的技术人员。\n\n其技术亮点在于极高的可定制性与强大的兼容性。用户不仅可以自由选择预设主题或深度自定义布局，还能利用新增的 Git PR 链接、多粒度 Token 速率统计（支持滚动时间窗口）以及极简模式来适配个人习惯。此外，它对 Powerline 符号的完美支持、智能的组件搜索功能以及跨平台（含 Windows）的稳定性，使其成为优化 Claude Code 体验的得力助手，让命令行操作更加优雅高效。","\u003Cdiv align=\"center\">\n\n\u003Cpre>\n              _        _             _ _            \n  ___ ___ ___| |_ __ _| |_ _   _ ___| (_)_ __   ___ \n \u002F __\u002F __\u002F __| __\u002F _` | __| | | \u002F __| | | '_ \\ \u002F _ \\\n| (_| (__\\__ \\ || (_| | |_| |_| \\__ \\ | | | | |  __\u002F\n \\___\\___|___\u002F\\__\\__,_|\\__|\\__,_|___\u002F_|_|_| |_|\\___|\n                                                     \n\u003C\u002Fpre>\n\n# ccstatusline\n\n**🎨 A highly customizable status line formatter for Claude Code CLI**\n*Display model info, git branch, token usage, and other metrics in your terminal*\n\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fccstatusline.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fccstatusline)\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fccstatusline.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fccstatusline)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fblob\u002Fmain\u002FLICENSE)\n[![Node.js Version](https:\u002F\u002Fimg.shields.io\u002Fnode\u002Fv\u002Fccstatusline.svg)](https:\u002F\u002Fnodejs.org)\n[![install size](https:\u002F\u002Fpackagephobia.com\u002Fbadge?p=ccstatusline)](https:\u002F\u002Fpackagephobia.com\u002Fresult?p=ccstatusline)\n[![Maintenance](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMaintained%3F-yes-green.svg)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fgraphs\u002Fcommit-activity)\n\n[![Mentioned in Awesome Claude Code](https:\u002F\u002Fawesome.re\u002Fmentioned-badge.svg)](https:\u002F\u002Fgithub.com\u002Fhesreallyhim\u002Fawesome-claude-code)\n[![ClaudeLog - A comprehensive knowledge base for Claude](https:\u002F\u002Fclaudelog.com\u002Fimg\u002Fclaude_log_badge.svg)](https:\u002F\u002Fclaudelog.com\u002F)\n\n\n![Demo](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_f56cfeed491e.gif)\n\n\u003C\u002Fdiv>\n\u003Cbr \u002F>\n\n## 📚 Table of Contents\n\n- [Recent Updates](#-recent-updates)\n- [Features](#-features)\n- [Localizations](#-localizations)\n- [Quick Start](#-quick-start)\n- [Windows Support](docs\u002FWINDOWS.md)\n- [Usage](docs\u002FUSAGE.md)\n- [Development](docs\u002FDEVELOPMENT.md)\n- [Contributing](#-contributing)\n- [License](#-license)\n- [Related Projects](#-related-projects)\n\n\u003Cbr \u002F>\n\n## 🆕 Recent Updates\n\n### v2.2.8 - Git widgets, smarter picker search, and minimalist mode\n\n- **🔀 New Git PR widget** - Added a `Git PR` widget with clickable PR links plus optional status and title display for the current branch.\n- **🧰 Major Git widget expansion** - Added `Git Status`, `Git Staged`, `Git Unstaged`, `Git Untracked`, `Git Ahead\u002FBehind`, `Git Conflicts`, `Git SHA`, `Git Origin Owner`, `Git Origin Repo`, `Git Origin Owner\u002FRepo`, `Git Upstream Owner`, `Git Upstream Repo`, `Git Upstream Owner\u002FRepo`, `Git Is Fork`, `Git Worktree Mode`, `Git Worktree Name`, `Git Worktree Branch`, `Git Worktree Original Branch`, and `Custom Symbol`.\n- **👤 Claude Account Email widget** - Added a session widget that reads the signed-in Claude account email from `~\u002F.claude.json` while respecting `CLAUDE_CONFIG_DIR`.\n- **🧼 Global Minimalist Mode** - Added a global toggle in `Global Overrides` that forces widgets into raw-value mode for a cleaner, label-free status line.\n- **🔎 Smarter widget picker search** - The add\u002Fchange widget picker now supports substring, initialism, and fuzzy matching, with ranked results and live match highlighting.\n- **📏 Better terminal width detection** - Flex separators and right-alignment now work more reliably when ccstatusline is launched through wrapper processes or nested PTYs.\n- **🎨 Powerline theme continuity** - Built-in Powerline themes can now continue colors cleanly across multiple status lines instead of restarting each line.\n\n### v2.2.0 - v2.2.6 - Speed, widgets, links, and reliability updates\n\n- **🚀 New Token Speed widgets** - Added three widgets: **Input Speed**, **Output Speed**, and **Total Speed**.\n  - Each speed widget supports a configurable window of `0-120` seconds in the widget editor (`w` key).\n  - `0` disables window mode and uses a full-session average speed.\n  - `1-120` calculates recent speed over the selected rolling window.\n- **🧩 New Skills widget controls (v2.2.1)** - Added configurable Skills modes (last\u002Fcount\u002Flist), optional hide-when-empty behavior, and list-size limiting with most-recent-first ordering.\n- **🌐 Usage API proxy support (v2.2.2)** - Usage widgets honor the uppercase `HTTPS_PROXY` environment variable for their direct API call to Anthropic.\n- **🧠 New Thinking Effort widget (v2.2.4)** - Added a widget that shows the current Claude Code thinking effort level.\n- **🍎 Better macOS usage lookup reliability (v2.2.5)** - Improved reliability when loading usage API tokens on macOS.\n- **⌨️ New Vim Mode widget (v2.2.5)** - Added a widget that shows the current vim mode, with ASCII and optional Nerd Font icon display.\n- **🔗 Git widget link modes (v2.2.6)** - `Git Branch` can render clickable GitHub branch links, and `Git Root Dir` can render clickable IDE links for VS Code and Cursor.\n- **🤝 Better subagent-aware speed reporting** - Token speed calculations continue to include referenced subagent activity so displayed speeds better reflect actual concurrent work.\n\n\u003Cbr \u002F>\n\u003Cdetails>\n\u003Csummary>\u003Cb>Older updates (v2.1.10 and earlier)\u003C\u002Fb>\u003C\u002Fsummary>\n\n### v2.1.0 - v2.1.10 - Usage widgets, links, new git insertions \u002F deletions widgets, and reliability fixes\n\n- **🧩 New Usage widgets (v2.1.0)** - Added **Session Usage**, **Weekly Usage**, **Block Reset Timer**, and **Context Bar** widgets.\n- **📊 More accurate counts (v2.1.0)** - Usage\u002Fcontext widgets now use new statusline JSON metrics when available for more accurate token and context counts.\n- **🪟 Windows empty file bug fix (v2.1.1)** - Fixed a Windows issue that could create an empty `c:\\dev\\null` file.\n- **🔗 New Link widget (v2.1.3)** - Added a new **Link** widget with clickable OSC8 rendering, preview parity, and raw mode support.\n- **➕ New Git Insertions widget (v2.1.4)** - Added a dedicated Git widget that shows only uncommitted insertions (e.g., `+42`).\n- **➖ New Git Deletions widget (v2.1.4)** - Added a dedicated Git widget that shows only uncommitted deletions (e.g., `-10`).\n- **🧠 Context format fallback fix (v2.1.6)** - When `context_window_size` is missing, context widgets now infer 1M models from long-context labels such as `[1m]` and `1M context` in model identifiers.\n- **⏳ Weekly reset timer split (v2.1.7)** - Added a separate `Weekly Reset Timer` widget.\n- **⚙️ Custom config file flag (v2.1.8)** - Added `--config \u003Cpath>` support so ccstatusline can load\u002Fsave settings from a custom file location.\n- **🔣 Unicode separator hex input upgrade (v2.1.9)** - Powerline separator hex input now supports 4-6 digits (full Unicode code points up to `U+10FFFF`).\n- **🌳 Bare repo worktree detection fix (v2.1.10)** - `Git Worktree` now correctly detects linked worktrees created from bare repositories.\n\n### v2.0.26 - v2.0.29 - Performance, git internals, and workflow improvements\n\n- **🧠 Memory Usage widget (v2.0.29)** - Added a new widget that shows current system memory usage (`Mem: used\u002Ftotal`).\n- **⚡ Block timer cache (v2.0.28)** - Cache block timer metrics to reduce JSONL parsing on every render, with per-config hashed cache files and automatic 5-hour block invalidation.\n- **🧱 Git widget command refactor (v2.0.28)** - Refactored git widgets to use shared git command helpers and expanded coverage for failure and edge-case tests.\n- **🪟 Windows UTF-8 piped output fix (v2.0.28)** - Sets the Windows UTF-8 code page for piped status line rendering.\n- **📁 Git Root Dir widget (v2.0.27)** - Added a new Git widget that shows the repository root directory name.\n- **🏷️ Session Name widget (v2.0.26)** - Added a new widget that shows the current Claude Code session name from `\u002Frename`.\n- **🏠 Current Working Directory home abbreviation (v2.0.26)** - Added a `~` abbreviation option for CWD display in both preview and live rendering.\n- **🧠 Context model suffix fix (v2.0.26)** - Context widgets now recognize the `[1m]` suffix across models, not just a single model path.\n- **🧭 Widget picker UX updates (v2.0.26)** - Improved widget discovery\u002Fnavigation and added clearer, safer clear-line behavior.\n- **⌨️ TUI editor input fix (v2.0.26)** - Prevented shortcut\u002Finput leakage into widget editor flows.\n- **📄 Repo docs update (v2.0.26)** - Migrated guidance from `CLAUDE.md` to `AGENTS.md` (with symlink compatibility).\n\n### v2.0.16 - Add fish style path abbreviation toggle to Current Working Directory widget\n\n### v2.0.15 - Block Timer calculation fixes\n\n- Fix miscalculation in the block timer\n\n### v2.0.14 - Add remaining mode toggle to Context Percentage widgets\n\n- **Remaining Mode** - You can now toggle the Context Percentage widgets between usage percentage and remaining percentage when configuring them in the TUI by pressing the 'u' key.\n\n### v2.0.12 - Custom Text widget now supports emojis\n\n- **👾 Emoji Support** - You can now paste emoji into the custom text widget. You can also turn on the merge option to get emoji labels for your widgets like this:\n  \n![Emoji Support](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_492caa56c568.png)\n\n### v2.0.11 - Unlimited Status Lines\n\n- **🚀 No Line Limit** - Configure as many status lines as you need - the 3-line limitation has been removed\n\n### v2.0.10 - Git Updates\n\n- **🌳 Git Worktree widget** - Shows the active worktree name when working with git worktrees\n- **👻 Hide 'no git' message toggle** - Git widgets now support hiding the 'no git' message when not in a repository (toggle with 'h' key while editing the widget)\n\n### v2.0.8 - Powerline Auto-Alignment\n\n![Powerline Auto-Alignment](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_41c26ecbca89.png)\n\n- **🎯 Widget Alignment** - Auto-align widgets across multiple status lines in Powerline mode for a clean, columnar layout (toggle with 'a' in Powerline Setup)\n\n### v2.0.7 - Current Working Directory & Session Cost\n\n![Current Working Directory and Session Cost](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_f0ea7c179f82.png)\n\n- **📁 Current Working Directory** - Display the current working directory with configurable segment display\n  - Set the number of path segments to show (e.g., show only last 2 segments: `...\u002FPersonal\u002Fccstatusline`)\n  - Supports raw value mode for compact display\n  - Automatically truncates long paths with ellipsis\n- **💰 Session Cost Widget** - Track your Claude Code session costs (requires Claude Code 1.0.85+)\n  - Displays total session cost in USD\n  - Supports raw value mode (shows just `$X.YZ` vs `Cost: $X.YZ`)\n  - Real-time cost tracking from Claude Code session data\n  - Note: Cost may not update properly when using `\u002Fresume` (Claude Code limitation)\n- **🐛 Bug Fixes**\n  - Fixed Block Timer calculations for accurate time tracking across block boundaries\n  - Improved widget editor stability with proper Ctrl+S handling\n  - Enhanced cursor display in numeric input fields\n\n### v2.0.2 - Block Timer Widget\n\n![Block Timer](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_d3a242714d66.png)\n\n- **⏱️ Block Timer** - Track your progress through 5-hour Claude Code blocks\n  - Displays time elapsed in current block as hours\u002Fminutes (e.g., \"3hr 45m\")\n  - Progress bar mode shows visual completion percentage\n  - Two progress bar styles: full width (32 chars) or compact (16 chars)\n  - Automatically detects block boundaries from transcript timestamps\n\n### v2.0.0 - Powerline Support & Enhanced Themes\n- **⚡ Powerline Mode** - Beautiful Powerline-style status lines with arrow separators and customizable caps\n- **🎨 Built-in Themes** - Multiple pre-configured themes that you can copy and customize\n- **🌈 Advanced Color Support** - Basic (16), 256-color (with custom ANSI codes), and truecolor (with hex codes) modes\n- **🔗 Widget Merging** - Merge multiple widgets together with or without padding for seamless designs\n- **📦 Easy Installation** - Install directly with `npx` or `bunx` - no global package needed\n- **🔤 Custom Separators** - Add multiple Powerline separators with custom hex codes for font support\n- **🚀 Auto Font Install** - Automatic Powerline font installation with user consent\n\n\u003C\u002Fdetails>\n\n\u003Cbr \u002F>\n\n## ✨ Features\n\n- **📊 Real-time Metrics** - Display model name, git branch, token usage, session duration, block timer, and more\n- **🎨 Fully Customizable** - Choose what to display and customize colors for each element\n- **⚡ Powerline Support** - Beautiful Powerline-style rendering with arrow separators, caps, and custom fonts\n- **📐 Multi-line Support** - Configure multiple independent status lines\n- **🖥️ Interactive TUI** - Built-in configuration interface using React\u002FInk\n- **🔎 Fast Widget Picker** - Add\u002Fchange widgets by category with search and ranked matching\n- **⚙️ Global Options** - Apply consistent formatting across all widgets (padding, separators, bold, minimalist mode, and color overrides)\n- **🚀 Cross-platform** - Works seamlessly with both Bun and Node.js\n- **🔧 Flexible Configuration** - Supports custom Claude Code config directory via `CLAUDE_CONFIG_DIR` environment variable\n- **📏 Smart Width Detection** - Automatically adapts to terminal width with flex separators\n- **⚡ Zero Config** - Sensible defaults that work out of the box\n\n\u003Cbr \u002F>\n\n## 🌐 Localizations\n\nThe localizations in this section are third-party forks maintained outside this repository. They are not maintained, reviewed, or endorsed by this repository, so review their code and releases before using them.\n\n- 🌏 **中文版 (Chinese):** [ccstatusline-zh](https:\u002F\u002Fgithub.com\u002Fhuangguang1999\u002Fccstatusline-zh)\n\n\u003Cbr \u002F>\n\n## 🚀 Quick Start\n\n### No installation needed! Use directly with npx or bunx:\n\n```bash\n# Run the configuration TUI with npm\nnpx -y ccstatusline@latest\n\n# Or with Bun (faster)\nbunx -y ccstatusline@latest\n```\n\n\u003Cbr \u002F>\n\u003Cdetails>\n\u003Csummary>\u003Cb>Configure ccstatusline\u003C\u002Fb>\u003C\u002Fsummary>\n\nThe interactive configuration tool provides a terminal UI where you can:\n- Configure multiple separate status lines\n- Add\u002Fremove\u002Freorder status line widgets\n- Customize colors for each widget\n- Configure flex separator behavior\n- Edit custom text widgets\n- Install\u002Funinstall to Claude Code settings\n- Preview your status line in real-time\n\n> 💡 **Tip:** Your settings are automatically saved to `~\u002F.config\u002Fccstatusline\u002Fsettings.json`\n\n> 🔧 **Custom Claude Config:** If your Claude Code configuration is in a non-standard location, set the `CLAUDE_CONFIG_DIR` environment variable:\n> ```bash\n> # Linux\u002FmacOS\n> export CLAUDE_CONFIG_DIR=\u002Fcustom\u002Fpath\u002Fto\u002F.claude\n> ```\n\n> 🌐 **Usage API proxy:** Usage widgets honor the uppercase `HTTPS_PROXY` environment variable for their direct API call to Anthropic.\n\n> 🪟 **Windows Support:** PowerShell examples, installation notes, fonts, troubleshooting, WSL, and Windows Terminal configuration are in [docs\u002FWINDOWS.md](docs\u002FWINDOWS.md).\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Claude Code settings.json format\u003C\u002Fb>\u003C\u002Fsummary>\n\nWhen you install from the TUI, ccstatusline writes a `statusLine` command object to your Claude Code settings:\n\n```json\n{\n  \"statusLine\": {\n    \"type\": \"command\",\n    \"command\": \"npx -y ccstatusline@latest\",\n    \"padding\": 0\n  }\n}\n```\n\nOther supported command values are:\n- `bunx -y ccstatusline@latest`\n- `ccstatusline` (for self-managed\u002Fglobal installs)\n\n\u003C\u002Fdetails>\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature\u002Famazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature\u002Famazing-feature`)\n5. Open a Pull Request\n\n\n## Support\n\nIf ccstatusline is useful to you, consider buying me a coffee:\n\n\u003Ca href=\"https:\u002F\u002Fwww.buymeacoffee.com\u002Fsirmalloc\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fcdn.buymeacoffee.com\u002Fbuttons\u002Fv2\u002Fdefault-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" >\u003C\u002Fa>\n\n\n## 📄 License\n\n[MIT](LICENSE) © Matthew Breedlove\n\n\n## 👤 Author\n\n**Matthew Breedlove**\n\n- GitHub: [@sirmalloc](https:\u002F\u002Fgithub.com\u002Fsirmalloc)\n\n\n## 🔗 Related Projects\n\n- [tweakcc](https:\u002F\u002Fgithub.com\u002FPiebald-AI\u002Ftweakcc) - Customize Claude Code themes, thinking verbs, and more.\n- [ccusage](https:\u002F\u002Fgithub.com\u002Fryoppippi\u002Fccusage) - Track and display Claude Code usage metrics.\n- [codachi](https:\u002F\u002Fgithub.com\u002Fvincent-k2026\u002Fcodachi) - A tamagotchi-style statusline pet that grows with your context window.\n\n\n## 🙏 Acknowledgments\n\n- Built for use with [Claude Code CLI](https:\u002F\u002Fclaude.ai\u002Fcode) by Anthropic\n- Powered by [Ink](https:\u002F\u002Fgithub.com\u002Fvadimdemedes\u002Fink) for the terminal UI\n- Made with ❤️ for the Claude Code community\n\n\u003Cbr \u002F>\n\n## Star History\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#sirmalloc\u002Fccstatusline&Timeline\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_55257a320f43.png&theme=dark\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_55257a320f43.png\" \u002F>\n   \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_55257a320f43.png\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n\u003Cdiv align=\"center\">\n\n### 🌟 Show Your Support\n\nGive a ⭐ if this project helped you!\n\n[![GitHub stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fsirmalloc\u002Fccstatusline?style=social)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fstargazers)\n[![GitHub forks](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002Fsirmalloc\u002Fccstatusline?style=social)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fnetwork\u002Fmembers)\n[![GitHub watchers](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fwatchers\u002Fsirmalloc\u002Fccstatusline?style=social)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fwatchers)\n\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fccstatusline.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fccstatusline)\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fccstatusline.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fccstatusline)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fblob\u002Fmain\u002FLICENSE)\n[![Made with Bun](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMade%20with-Bun-000000.svg?logo=bun)](https:\u002F\u002Fbun.sh)\n\n[![Issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fsirmalloc\u002Fccstatusline)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fissues)\n[![Pull Requests](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues-pr\u002Fsirmalloc\u002Fccstatusline)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fpulls)\n[![Contributors](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fsirmalloc\u002Fccstatusline)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fgraphs\u002Fcontributors)\n\n### 💬 Connect\n\n[Report Bug](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fissues) · [Request Feature](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fissues) · [Discussions](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fdiscussions)\n\n\u003C\u002Fdiv>\n","\u003Cdiv align=\"center\">\n\n\u003Cpre>\n              _        _             _ _            \n  ___ ___ ___| |_ __ _| |_ _   _ ___| (_)_ __   ___ \n \u002F __\u002F __\u002F __| __\u002F _` | __| | | \u002F __| | | '_ \\ \u002F _ \\\n| (_| (__\\__ \\ || (_| | |_| |_| \\__ \\ | | | | |  __\u002F\n \\___\\___|___\u002F\\__\\__,_|\\__|\\__,_|___\u002F_|_|_| |_|\\___|\n                                                     \n\u003C\u002Fpre>\n\n# ccstatusline\n\n**🎨 针对 Claude Code CLI 的高度可定制状态栏格式化工具**\n*在终端中显示模型信息、Git 分支、Token 使用情况及其他指标*\n\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fccstatusline.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fccstatusline)\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fccstatusline.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fccstatusline)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fblob\u002Fmain\u002FLICENSE)\n[![Node.js Version](https:\u002F\u002Fimg.shields.io\u002Fnode\u002Fv\u002Fccstatusline.svg)](https:\u002F\u002Fnodejs.org)\n[![install size](https:\u002F\u002Fpackagephobia.com\u002Fbadge?p=ccstatusline)](https:\u002F\u002Fpackagephobia.com\u002Fresult?p=ccstatusline)\n[![Maintenance](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMaintained%3F-yes-green.svg)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fgraphs\u002Fcommit-activity)\n\n[![Mentioned in Awesome Claude Code](https:\u002F\u002Fawesome.re\u002Fmentioned-badge.svg)](https:\u002F\u002Fgithub.com\u002Fhesreallyhim\u002Fawesome-claude-code)\n[![ClaudeLog - A comprehensive knowledge base for Claude](https:\u002F\u002Fclaudelog.com\u002Fimg\u002Fclaude_log_badge.svg)](https:\u002F\u002Fclaudelog.com\u002F)\n\n\n![Demo](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_f56cfeed491e.gif)\n\n\u003C\u002Fdiv>\n\u003Cbr \u002F>\n\n## 📚 目录\n\n- [近期更新](#-recent-updates)\n- [功能特性](#-features)\n- [本地化支持](#-localizations)\n- [快速入门](#-quick-start)\n- [Windows 支持](docs\u002FWINDOWS.md)\n- [使用方法](docs\u002FUSAGE.md)\n- [开发指南](docs\u002FDEVELOPMENT.md)\n- [贡献说明](#-contributing)\n- [许可证](#-license)\n- [相关项目](#-related-projects)\n\n\u003Cbr \u002F>\n\n## 🆕 近期更新\n\n### v2.2.8 - Git 小部件、更智能的选取器搜索及极简模式\n\n- **🔀 新增 Git PR 小部件** - 添加了一个带有可点击 PR 链接的 `Git PR` 小部件，并可选择性显示当前分支的状态和标题。\n- **🧰 大幅扩展 Git 小部件** - 新增了 `Git Status`、`Git Staged`、`Git Unstaged`、`Git Untracked`、`Git Ahead\u002FBehind`、`Git Conflicts`、`Git SHA`、`Git Origin Owner`、`Git Origin Repo`、`Git Origin Owner\u002FRepo`、`Git Upstream Owner`、`Git Upstream Repo`、`Git Upstream Owner\u002FRepo`、`Git Is Fork`、`Git Worktree Mode`、`Git Worktree Name`、`Git Worktree Branch`、`Git Worktree Original Branch` 以及 `Custom Symbol`。\n- **👤 Claude 账户邮箱小部件** - 增加了一个会话小部件，它会从 `~\u002F.claude.json` 中读取已登录的 Claude 账户邮箱，同时尊重 `CLAUDE_CONFIG_DIR` 环境变量。\n- **🧼 全局极简模式** - 在 `Global Overrides` 中新增了一个全局切换开关，可将所有小部件强制设置为原始值模式，从而实现更简洁、无标签的状态栏。\n- **🔎 更智能的小部件选取器搜索** - 添加小部件或更改现有小部件的选取器现在支持子字符串、首字母缩写词和模糊匹配，结果会按排名排序，并实时高亮匹配项。\n- **📏 改进的终端宽度检测** - 当 ccstatusline 通过包装进程或嵌套 PTY 启动时，柔性分隔符和右对齐功能现在可以更可靠地工作。\n- **🎨 Powerline 主题延续性** - 内置的 Powerline 主题现在可以在多行状态栏之间平滑地延续颜色，而无需每行重新开始。\n\n### v2.2.0 - v2.2.6 - 速度、小部件、链接及可靠性更新\n\n- **🚀 新增 Token 速度小部件** - 添加了三个小部件：**Input Speed**、**Output Speed** 和 **Total Speed**。\n  - 每个速度小部件都支持在小部件编辑器（`w` 键）中配置 `0-120` 秒的窗口。\n  - 设置为 `0` 时，禁用窗口模式，使用整个会话的平均速度。\n  - 设置为 `1-120` 时，则计算所选滚动窗口内的近期速度。\n- **🧩 新技能小部件控制选项（v2.2.1）** - 增加了可配置的技能模式（最后一条\u002F数量\u002F列表）、空时不显示行为以及按最新优先顺序限制列表大小的功能。\n- **🌐 使用量 API 代理支持（v2.2.2）** - 使用量小部件在直接调用 Anthropic API 时会尊重大写的 `HTTPS_PROXY` 环境变量。\n- **🧠 新增思考力度小部件（v2.2.4）** - 添加了一个显示当前 Claude Code 思考力度水平的小部件。\n- **🍎 提升 macOS 上使用量查询的可靠性（v2.2.5）** - 改进了在 macOS 上加载使用量 API token 时的可靠性。\n- **⌨️ 新 Vim 模式小部件（v2.2.5）** - 添加了一个显示当前 Vim 模式的小部件，支持 ASCII 字符和可选的 Nerd Font 图标显示。\n- **🔗 Git 小部件链接模式（v2.2.6）** - `Git Branch` 可以渲染可点击的 GitHub 分支链接，而 `Git Root Dir` 则可以渲染针对 VS Code 和 Cursor 的可点击 IDE 链接。\n- **🤝 更好的子代理感知速度报告** - Token 速度计算将继续包含引用的子代理活动，以便显示的速度更能反映实际的并发工作。\n\n\u003Cbr \u002F>\n\u003Cdetails>\n\u003Csummary>\u003Cb>旧版更新（v2.1.10 及更早版本）\u003C\u002Fb>\u003C\u002Fsummary>\n\n### v2.1.0 - v2.1.10 - 使用量小部件、链接、新的 Git 插入\u002F删除小部件以及可靠性修复\n\n- **🧩 新使用量小部件（v2.1.0）** - 添加了 **Session Usage**、**Weekly Usage**、**Block Reset Timer** 和 **Context Bar** 小部件。\n- **📊 更准确的计数（v2.1.0）** - 使用量\u002F上下文小部件现在会在可用时使用新的状态栏 JSON 指标，以获得更准确的 token 和上下文计数。\n- **🪟 Windows 空文件错误修复（v2.1.1）** - 修复了一个可能导致在 `c:\\dev\\null` 创建空文件的 Windows 问题。\n- **🔗 新链接小部件（v2.1.3）** - 添加了一个新的 **Link** 小部件，支持可点击的 OSC8 渲染、预览一致性以及原始模式。\n- **➕ 新 Git 插入小部件（v2.1.4）** - 添加了一个专门用于显示未提交插入内容的 Git 小部件（例如 `+42`）。\n- **➖ 新 Git 删除小部件（v2.1.4）** - 添加了一个专门用于显示未提交删除内容的 Git 小部件（例如 `-10`）。\n- **🧠 上下文格式回退修复（v2.1.6）** - 当 `context_window_size` 缺失时，上下文小部件现在会根据长上下文标签（如 `[1m]` 和模型标识中的 `1M context`）推断出 1M 模型。\n- **⏳ 周重置计时器拆分（v2.1.7）** - 添加了一个独立的 `Weekly Reset Timer` 小部件。\n- **⚙️ 自定义配置文件标志（v2.1.8）** - 增加了 `--config \u003Cpath>` 支持，使 ccstatusline 能够从自定义文件路径加载和保存设置。\n- **🔣 Unicode 分隔符十六进制输入升级（v2.1.9）** - Powerline 分隔符的十六进制输入现在支持 4-6 位数字（完整的 Unicode 代码点可达 `U+10FFFF`）。\n- **🌳 裸仓库工作树检测修复（v2.1.10）** - `Git Worktree` 现在能够正确检测由裸仓库创建的关联工作树。\n\n### v2.0.26 - v2.0.29 - 性能、Git 内部机制及工作流改进\n\n- **🧠 内存使用小部件（v2.0.29）** - 新增一个显示当前系统内存使用情况的小部件（`Mem: used\u002Ftotal`）。\n- **⚡ 块计时器缓存（v2.0.28）** - 缓存块计时器指标，以减少每次渲染时的 JSONL 解析负担；每个配置都有哈希化的缓存文件，并自动在 5 小时后失效。\n- **🧱 Git 小部件命令重构（v2.0.28）** - 重构了 Git 小部件，使其使用共享的 Git 命令辅助函数，并扩展了失败和边缘情况的测试覆盖范围。\n- **🪟 Windows UTF-8 管道输出修复（v2.0.28）** - 设置 Windows 的 UTF-8 代码页，用于管道状态行的渲染。\n- **📁 Git 根目录小部件（v2.0.27）** - 新增了一个显示仓库根目录名称的 Git 小部件。\n- **🏷️ 会话名称小部件（v2.0.26）** - 新增了一个显示来自 `\u002Frename` 的当前 Claude Code 会话名称的小部件。\n- **🏠 当前工作目录的家目录缩写（v2.0.26）** - 在预览和实时渲染中，为 CWD 显示新增了 `~` 缩写选项。\n- **🧠 上下文模型后缀修复（v2.0.26）** - 上下文小部件现在可以识别跨模型的 `[1m]` 后缀，而不仅限于单一模型路径。\n- **🧭 小部件选择器 UX 更新（v2.0.26）** - 改进了小部件的发现与导航，并添加了更清晰、更安全的清行行为。\n- **⌨️ TUI 编辑器输入修复（v2.0.26）** - 防止快捷键\u002F输入泄露到小部件编辑器流程中。\n- **📄 仓库文档更新（v2.0.26）** - 将指导内容从 `CLAUDE.md` 迁移到 `AGENTS.md`（同时保持符号链接兼容性）。\n\n### v2.0.16 - 为当前工作目录小部件添加鱼式路径缩写切换功能\n\n### v2.0.15 - 块计时器计算修复\n\n- 修复了块计时器中的计算错误。\n\n### v2.0.14 - 为上下文百分比小部件添加剩余模式切换功能\n\n- **剩余模式** - 现在可以在 TUI 中通过按 `u` 键，在配置上下文百分比小部件时，切换其显示方式：使用百分比或剩余百分比。\n\n### v2.0.12 - 自定义文本小部件现支持表情符号\n\n- **👾 表情符号支持** - 现在可以将表情符号粘贴到自定义文本小部件中。你还可以开启合并选项，为你的小部件添加表情符号标签，如下所示：\n\n![表情符号支持](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_492caa56c568.png)\n\n### v2.0.11 - 无限状态行\n\n- **🚀 无行数限制** - 可以根据需要配置任意数量的状态行——3 行的限制已被移除。\n\n### v2.0.10 - Git 更新\n\n- **🌳 Git 工作树小部件** - 在使用 Git 工作树时，显示当前活动的工作树名称。\n- **👻 隐藏“无 Git”消息切换** - Git 小部件现在支持在不在仓库时隐藏“无 Git”消息（在编辑小部件时按 `h` 键进行切换）。\n\n### v2.0.8 - Powerline 自动对齐\n\n![Powerline 自动对齐](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_41c26ecbca89.png)\n\n- **🎯 小部件对齐** - 在 Powerline 模式下，自动对齐多条状态行上的小部件，形成整洁的列状布局（在 Powerline 设置中按 `a` 键切换）。\n\n### v2.0.7 - 当前工作目录与会话成本\n\n![当前工作目录与会话成本](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_f0ea7c179f82.png)\n\n- **📁 当前工作目录** - 可配置显示当前工作目录的段落：\n  - 设置要显示的路径段落数量（例如仅显示最后 2 段：“...\u002FPersonal\u002Fccstatusline”）；\n  - 支持原始值模式以实现紧凑显示；\n  - 自动用省略号截断过长的路径。\n- **💰 会话成本小部件** - 跟踪你的 Claude Code 会话成本（需 Claude Code 1.0.85 或更高版本）：\n  - 以美元显示会话总成本；\n  - 支持原始值模式（仅显示 `$X.YZ` 而非“Cost: $X.YZ”）；\n  - 实时从 Claude Code 会话数据中追踪成本；\n  - 注意：使用 `\u002Fresume` 时，成本可能无法正确更新（Claude Code 的限制）。\n- **🐛 错误修复**\n  - 修复了块计时器的计算，确保跨块边界的时间跟踪准确；\n  - 改善了小部件编辑器的稳定性，正确处理 Ctrl+S 操作；\n  - 优化了数字输入字段中的光标显示。\n\n### v2.0.2 - 块计时器小部件\n\n![块计时器](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_d3a242714d66.png)\n\n- **⏱️ 块计时器** - 跟踪你在 5 小时 Claude Code 块中的进度：\n  - 以小时和分钟形式显示当前块已用时间（如“3hr 45m”）；\n  - 进度条模式显示视觉完成百分比；\n  - 提供两种进度条样式：全宽（32 个字符）或紧凑型（16 个字符）；\n  - 自动根据转录本中的时间戳检测块边界。\n\n### v2.0.0 - Powerline 支持与增强主题\n- **⚡ Powerline 模式** - 美丽的 Powerline 风格状态行，带有箭头分隔符和可定制的帽饰。\n- **🎨 内置主题** - 多个预配置的主题，你可以复制并自定义。\n- **🌈 高级颜色支持** - 支持基本色（16 色）、256 色（带自定义 ANSI 代码）以及真彩色（带十六进制代码）模式。\n- **🔗 小部件合并** - 可以将多个小部件合并在一起，带或不带填充，以实现无缝设计。\n- **📦 简单安装** - 可直接使用 `npx` 或 `bunx` 安装，无需全局包。\n- **🔤 自定义分隔符** - 可添加多种 Powerline 分隔符，使用自定义十六进制代码以支持字体。\n- **🚀 自动字体安装** - 经用户同意后自动安装 Powerline 字体。\n\n\u003C\u002Fdetails>\n\n\u003Cbr \u002F>\n\n## ✨ 功能\n\n- **📊 实时指标** - 显示模型名称、Git 分支、Token 使用量、会话时长、块计时器等信息。\n- **🎨 完全可定制** - 选择要显示的内容，并为每个元素自定义颜色。\n- **⚡ Powerline 支持** - 以箭头分隔符、帽饰和自定义字体呈现美丽的 Powerline 风格。\n- **📐 多行支持** - 可配置多条独立的状态行。\n- **🖥️ 交互式 TUI** - 使用 React\u002FInk 构建的内置配置界面。\n- **🔎 快速小部件选择器** - 按类别添加\u002F更改小部件，支持搜索和排名匹配。\n- **⚙️ 全局选项** - 对所有小部件应用一致的格式化设置（填充、分隔符、加粗、极简模式和颜色覆盖）。\n- **🚀 跨平台** - 与 Bun 和 Node.js 均无缝兼容。\n- **🔧 灵活配置** - 支持通过 `CLAUDE_CONFIG_DIR` 环境变量指定自定义 Claude Code 配置目录。\n- **📏 智能宽度检测** - 自动适应终端宽度，使用弹性分隔符。\n- **⚡ 零配置** - 提供合理的默认设置，开箱即用。\n\n\u003Cbr \u002F>\n\n## 🌐 本地化\n\n本节中的本地化版本是由第三方在本仓库之外维护的分支。这些版本不由本仓库维护、审查或认可，因此在使用之前请仔细检查其代码和发布内容。\n\n- 🌏 **中文版:** [ccstatusline-zh](https:\u002F\u002Fgithub.com\u002Fhuangguang1999\u002Fccstatusline-zh)\n\n\u003Cbr \u002F>\n\n## 🚀 快速开始\n\n### 无需安装！直接使用 npx 或 bunx 即可：\n\n```bash\n# 使用 npm 运行配置 TUI\nnpx -y ccstatusline@latest\n\n# 或者使用 Bun（更快）\nbunx -y ccstatusline@latest\n```\n\n\u003Cbr \u002F>\n\u003Cdetails>\n\u003Csummary>\u003Cb>配置 ccstatusline\u003C\u002Fb>\u003C\u002Fsummary>\n\n交互式配置工具提供了一个终端用户界面，您可以在其中：\n- 配置多个独立的状态栏\n- 添加\u002F删除\u002F重新排序状态栏小部件\n- 自定义每个小部件的颜色\n- 配置 flex 分隔符的行为\n- 编辑自定义文本小部件\n- 安装\u002F卸载到 Claude Code 设置中\n- 实时预览您的状态栏\n\n> 💡 **提示：** 您的设置会自动保存到 `~\u002F.config\u002Fccstatusline\u002Fsettings.json`\n\n> 🔧 **自定义 Claude 配置：** 如果您的 Claude Code 配置位于非标准位置，请设置 `CLAUDE_CONFIG_DIR` 环境变量：\n> ```bash\n> # Linux\u002FmacOS\n> export CLAUDE_CONFIG_DIR=\u002Fcustom\u002Fpath\u002Fto\u002F.claude\n> ```\n\n> 🌐 **使用 API 代理：** 使用情况小部件在直接调用 Anthropic API 时会尊重大写的 `HTTPS_PROXY` 环境变量。\n\n> 🪟 **Windows 支持：** PowerShell 示例、安装说明、字体、故障排除、WSL 以及 Windows Terminal 配置等内容，请参阅 [docs\u002FWINDOWS.md](docs\u002FWINDOWS.md)。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Claude Code settings.json 格式\u003C\u002Fb>\u003C\u002Fsummary>\n\n当您通过 TUI 安装时，ccstatusline 会将一个 `statusLine` 命令对象写入您的 Claude Code 设置中：\n\n```json\n{\n  \"statusLine\": {\n    \"type\": \"command\",\n    \"command\": \"npx -y ccstatusline@latest\",\n    \"padding\": 0\n  }\n}\n```\n\n其他支持的命令值包括：\n- `bunx -y ccstatusline@latest`\n- `ccstatusline`（用于自管理或全局安装）\n\n\u003C\u002Fdetails>\n\n## 🤝 贡献\n\n欢迎贡献！请随时提交 Pull Request。\n\n1. 分支仓库\n2. 创建您的功能分支 (`git checkout -b feature\u002Famazing-feature`)\n3. 提交更改 (`git commit -m '添加一些令人惊叹的功能'`)\n4. 推送到分支 (`git push origin feature\u002Famazing-feature`)\n5. 打开 Pull Request\n\n\n## 支持\n\n如果 ccstatusline 对您有帮助，请考虑请我喝杯咖啡：\n\n\u003Ca href=\"https:\u002F\u002Fwww.buymeacoffee.com\u002Fsirmalloc\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fcdn.buymeacoffee.com\u002Fbuttons\u002Fv2\u002Fdefault-yellow.png\" alt=\"请我喝杯咖啡\" style=\"height: 60px !important;width: 217px !important;\" >\u003C\u002Fa>\n\n\n## 📄 许可证\n\n[MIT](LICENSE) © Matthew Breedlove\n\n\n## 👤 作者\n\n**Matthew Breedlove**\n\n- GitHub：[@sirmalloc](https:\u002F\u002Fgithub.com\u002Fsirmalloc)\n\n\n## 🔗 相关项目\n\n- [tweakcc](https:\u002F\u002Fgithub.com\u002FPiebald-AI\u002Ftweakcc) - 自定义 Claude Code 主题、思考动词等。\n- [ccusage](https:\u002F\u002Fgithub.com\u002Fryoppippi\u002Fccusage) - 跟踪并显示 Claude Code 的使用指标。\n- [codachi](https:\u002F\u002Fgithub.com\u002Fvincent-k2026\u002Fcodachi) - 一款养成类状态栏宠物，会随着您的上下文窗口增长而成长。\n\n\n## 🙏 致谢\n\n- 专为与 Anthropic 的 [Claude Code CLI](https:\u002F\u002Fclaude.ai\u002Fcode) 一起使用而构建\n- 使用 [Ink](https:\u002F\u002Fgithub.com\u002Fvadimdemedes\u002Fink) 构建终端 UI\n- 由 ❤️ 为 Claude Code 社区打造\n\n\u003Cbr \u002F>\n\n## 星标历史\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#sirmalloc\u002Fccstatusline&Timeline\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_55257a320f43.png&theme=dark\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_55257a320f43.png\" \u002F>\n   \u003Cimg alt=\"星标历史图表\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_readme_55257a320f43.png\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n\u003Cdiv align=\"center\">\n\n### 🌟 表达您的支持\n\n如果这个项目对您有帮助，请给它一颗星！\n\n[![GitHub 星标](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fsirmalloc\u002Fccstatusline?style=social)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fstargazers)\n[![GitHub 分支](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002Fsirmalloc\u002Fccstatusline?style=social)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fnetwork\u002Fmembers)\n[![GitHub 关注](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fwatchers\u002Fsirmalloc\u002Fccstatusline?style=social)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fwatchers)\n\n[![npm 版本](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fccstatusline.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fccstatusline)\n[![npm 下载量](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fccstatusline.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fccstatusline)\n[![许可证：MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fblob\u002Fmain\u002FLICENSE)\n[![由 Bun 制作](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMade%20with-Bun-000000.svg?logo=bun)](https:\u002F\u002Fbun.sh)\n\n[![问题](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fsirmalloc\u002Fccstatusline)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fissues)\n[![拉取请求](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues-pr\u002Fsirmalloc\u002Fccstatusline)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fpulls)\n[![贡献者](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002Fsirmalloc\u002Fccstatusline)](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fgraphs\u002Fcontributors)\n\n### 💬 联系我们\n\n[报告 bug](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fissues) · [请求功能](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fissues) · [讨论区](https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fdiscussions)\n\n\u003C\u002Fdiv>","# ccstatusline 快速上手指南\n\n`ccstatusline` 是一款专为 **Claude Code CLI** 设计的高度可定制状态栏格式化工具。它能在终端中实时显示模型信息、Git 分支、Token 用量、会话成本等关键指标，并支持 Powerline 风格主题。\n\n## 🛠️ 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**：macOS、Linux 或 Windows (需配置 UTF-8 环境)。\n*   **运行时依赖**：已安装 [Node.js](https:\u002F\u002Fnodejs.org\u002F) (建议最新 LTS 版本) 或 [Bun](https:\u002F\u002Fbun.sh\u002F)。\n*   **核心工具**：已安装并配置好 `claude` (Claude Code CLI)。\n    *   检查命令：`claude --version`\n*   **可选优化**：为了获得最佳的 Powerline 箭头符号和图标显示效果，建议终端字体支持 **Nerd Fonts**。\n\n## 📦 安装步骤\n\n推荐使用 `npx` 直接运行，无需全局安装即可体验；若需长期使用，也可全局安装。\n\n### 方式一：直接使用 (推荐)\n无需安装，每次通过 `npx` 调用。这是最轻量且能自动获取最新版本的方式。\n\n```bash\nnpx ccstatusline\n```\n\n### 方式二：全局安装\n如果你希望将其作为系统命令使用：\n\n```bash\nnpm install -g ccstatusline\n# 或者使用 bun\nbun install -g ccstatusline\n```\n\n> **国内加速提示**：如果 npm 下载缓慢，建议使用国内镜像源进行安装：\n> ```bash\n> npm install -g ccstatusline --registry=https:\u002F\u002Fregistry.npmmirror.com\n> ```\n\n## 🚀 基本使用\n\n### 1. 启动与配置\n在终端中运行以下命令启动交互式配置界面（TUI）：\n\n```bash\nnpx ccstatusline\n```\n\n*   **首次运行**：工具会自动检测当前的 Claude Code 会话，并引导你进入配置界面。\n*   **添加组件**：在界面中按下 `a` 键打开组件选择器（Widget Picker），支持模糊搜索（如输入 \"git\", \"token\", \"cost\"）。\n*   **自定义布局**：使用方向键调整组件顺序，按 `Enter` 确认，按 `q` 退出配置。\n\n### 2. 集成到 Claude Code\n配置完成后，你需要让 Claude Code 调用此状态栏。通常有两种方式：\n\n**方法 A：通过别名 (Alias)**\n在你的 Shell 配置文件（如 `~\u002F.zshrc`, `~\u002F.bashrc` 或 PowerShell 配置文件）中添加别名，将 `claude` 命令包装起来：\n\n```bash\n# 示例：将 claude 命令重定向为带状态栏的模式\nalias claude='npx ccstatusline -- claude'\n```\n*(注：具体集成方式可能随 Claude Code 版本更新而变化，请参考工具运行时的提示或官方 USAGE 文档)*\n\n**方法 B：直接在支持钩子的环境中调用**\n如果你的终端多路复用器（如 tmux）或 Shell 提示符支持动态命令，可直接调用：\n\n```bash\n# 简单测试输出\nnpx ccstatusline --render\n```\n\n### 3. 常用功能速览\n配置界面中支持以下核心功能（通过快捷键操作）：\n*   **w**: 编辑选中组件的详细参数（如 Token 速度计算窗口时间）。\n*   **t**: 切换内置主题（Themes），包含多种 Powerline 配色方案。\n*   **h**: 在 Git 组件中隐藏“非仓库目录”的提示信息。\n*   **u**: 在上下文组件中切换“已用百分比”与“剩余百分比”模式。\n*   **Global Minimalist Mode**: 在全局设置中开启，可移除所有标签文字，仅显示原始数值，打造极简状态栏。\n\n现在，你可以在享受 Claude Code 强大能力的同时，通过底部的状态栏实时监控开发进度和资源消耗了！","资深后端工程师正在使用 Claude Code CLI 进行微服务架构的重构，需要频繁切换分支并监控 AI 生成的代码质量与 Token 消耗。\n\n### 没有 ccstatusline 时\n- **上下文割裂**：终端只显示基础提示符，无法直观看到当前 Git 分支、未暂存文件或 PR 状态，必须反复输入 `git status` 或 `gh pr view` 打断心流。\n- **成本黑盒**：在长对话中完全不知道 Token 消耗速度和剩余额度，往往直到报错“超出限制”才发现已浪费大量预算。\n- **效率盲区**：无法感知模型当前的生成速度（Tokens\u002Fs），难以判断是网络卡顿还是模型推理缓慢，导致无谓等待。\n- **身份混淆**：在多账号协作环境下，容易忘记当前会话绑定的是哪个 Claude 账户，存在误用个人账号处理公司代码的风险。\n\n### 使用 ccstatusline 后\n- **全景可视**：状态栏实时展示 Git 分支、冲突数、PR 链接及上游仓库信息，代码变更状态一目了然，无需额外命令即可掌控全局。\n- **成本透明**：通过新增的 Token 速度组件（Input\u002FOutput\u002FTotal Speed），实时监控生成速率与会话总用量，随时调整提示词策略以优化成本。\n- **性能洞察**：动态显示的生成速度让工程师能立即识别性能瓶颈，快速决定是继续等待还是重新发起请求，大幅提升调试效率。\n- **安全确权**：专属的 Claude 账户邮箱组件直接显示当前登录身份，彻底杜绝因账号切换疏忽导致的数据合规风险。\n\nccstatusline 将原本分散的运维指标与开发上下文聚合于终端一行之内，让开发者在保持专注的同时实现对代码环境与 AI 成本的精细化掌控。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsirmalloc_ccstatusline_492caa56.png","sirmalloc","Matthew Breedlove","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fsirmalloc_43a705c6.jpg",null,"Charlotte, NC","sirmalloc@gmail.com","https:\u002F\u002Fgithub.com\u002Fsirmalloc",[83,87],{"name":84,"color":85,"percentage":86},"TypeScript","#3178c6",98.4,{"name":88,"color":89,"percentage":90},"JavaScript","#f1e05a",1.6,7294,311,"2026-04-14T16:48:34","MIT","Linux, macOS, Windows","未说明",{"notes":98,"python":96,"dependencies":99},"该工具是基于 Node.js 开发的 Claude Code CLI 状态栏格式化器，通过 npm 或 bunx 安装运行。无需 GPU 或大量内存。支持 Windows、macOS 和 Linux。部分功能（如 Usage API）可能需要配置 HTTPS_PROXY。Git 相关功能依赖本地安装的 Git。",[100,101],"Node.js (版本需参考 npm badge)","Claude Code CLI",[13],[104,105,106,107,108,109,110,111,112,113],"ai-tools","claude-code","cli","developer-tools","git","powerline","statusbar","statusline","terminal","themeing","2026-03-27T02:49:30.150509","2026-04-15T07:10:21.557690",[117,122,127,132,137,142],{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},33957,"为什么升级到 Claude Code 2 后，上下文剩余百分比不再递减或显示不准确？","这可能是由于新版本中引入了“自动压缩缓冲区”（autocompact buffer）和 MCP 工具计数未被正确统计导致的。例如，有用户发现 `\u002Fcontext` 显示使用了 122K，而插件仅显示 75.4K，差异可能正是未计入的 45K 缓冲区和 1.3K 工具数据。维护者曾尝试通过提交修复（commit da32593），但如果问题依旧，建议检查是否已安装最新版本，或者考虑暂时使用其他替代方案直到官方完全适配。","https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fissues\u002F93",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},33958,"如何在状态栏中显示 Claude Code 2 的实时用量图表（\u002Fusage 功能）？","虽然原生支持仍在审查中（主要涉及 Windows 兼容性），但你可以安装社区维护的分叉版本来立即获得此功能。该版本可以显示会话和每周用量限制。安装命令如下：\n从以下地址安装：https:\u002F\u002Fgithub.com\u002Fpcvelz\u002Fccstatusline-usage\n安装后，状态栏将显示类似格式：\nSession: [████░░░░░░░░░░░] 27.0% | Weekly: [████████████░░░] 86.0% | 1:56 hr | Model: Opus 4.6","https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fissues\u002F94",{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},33959,"在 Windows PowerShell 或 Mac 上的 Nushell\u002FPowerShell 中，为什么计时器块（block timer）一直显示为 0？","这是一个已知问题，维护者已经定位并修复了该 Bug。请确保你已将插件更新到包含修复补丁的最新版本（参考 PR #102）。如果你仍在使用旧版本，块计时器可能无法在不同 Shell 环境下正确获取时间数据。运行更新命令重新安装插件通常能解决此问题。","https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fissues\u002F74",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},33960,"运行 ccstatusline 时导致 CPU 占用率过高（CPU runaway）怎么办？","这通常是由特定版本的 Claude Code（如 v1.0.88）不断重复调用状态行脚本引起的递归消耗问题。该问题已在 Claude Code v1.0.89 及更高版本中修复。\n解决方案：\n1. 运行 `claude update` 将 Claude Code 升级到最新版本（至少 v1.0.89）。\n2. 重启终端或计算机，以确保后台没有卡住的进程在运行。\n3. 确保 ccstatusline 也更新到了最新版本，其中包含了性能增强补丁。","https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fissues\u002F22",{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},33961,"升级 Claude Code 后状态栏突然不显示了，可能的原因是什么？","新版本的 Claude Code 对允许规则（allow rules）进行了更严格的语法检查。如果你的配置中包含格式错误的规则（例如写成了 `Bash(command*)` 而不是正确的 `Bash(command:*)`），会导致整个配置解析失败，从而无法加载状态栏。\n解决方法：\n1. 检查你的 Claude Code 配置文件，修正所有语法错误的允许规则。\n2. 在终端中运行 `\u002Fdoctor` 命令，让系统自动检测并指出具体的配置错误。\n3. 修复配置后，状态栏即可恢复正常显示。","https:\u002F\u002Fgithub.com\u002Fsirmalloc\u002Fccstatusline\u002Fissues\u002F65",{"id":143,"question_zh":144,"answer_zh":145,"source_url":126},33962,"如何在 Linux 上解决获取凭据困难的问题以支持用量显示功能？","对于需要在 Linux 上手动处理凭据缓存以支持用量显示的用户，可以使用以下 Node.js 代码片段来管理缓存文件和锁文件，确保持久化和并发安全：\n```javascript\nimport fs from 'fs';\nimport os from 'os';\nimport path from 'path';\n\nconst HOME = os.homedir();\nconst CACHE_DIR = path.join(HOME, '.cache');\nconst CACHE_FILE = path.join(CACHE_DIR, 'ccstatusline-usage.txt');\nconst LOCK_FILE = path.join(CACHE_DIR, 'ccstatusline-usage.lock');\n\n\u002F\u002F 读取缓存函数示例\nfunction readCache() {\n  try {\n    return fs.readFileSync(CACHE_FILE, 'utf8').trim();\n  } catch {\n    return null;\n  }\n}\n```\n这段代码帮助将用量数据缓存到 `~\u002F.cache\u002Fccstatusline-usage.txt`，避免每次都要重新 fetch 凭据。",[]]