mcpField
G
groove-admin-claude-statusline

groove-admin-claude-statusline

github.com/andreadellacorteAgent 工作流6501 次安装14 周前更新
代码仓库

关于 groove-admin-claude-statusline

此技能为 Claude Code 安装和管理单行状态栏，显示模型、仓库、上下文、用量和活跃循环任务，也提供列出与卸载模式。

主要功能

  1. 01安装 Claude Code 状态栏
  2. 02显示模型、分支和暂存差异
  3. 03呈现上下文与努力级别
  4. 04跟踪活跃的 /loop 定时任务
  5. 05列出或卸载配置

适用场景

  1. 01在每轮 Claude Code 中查看会话信息
  2. 02检查上下文和速率限制用量
  3. 03监控活跃的 /loop 任务
  4. 04检查或移除状态栏配置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/andreadellacorte/groove --skill groove-admin-claude-statusline

安装后在 Claude Code 中输入/groove-admin-claude-statusline确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

scripts/
cron-state-clear.sh
cron-state.sh
statusline.sh

详细介绍

groove-admin-claude-statusline

安装丰富的单行 Claude Code 状态栏。将三个脚本写入 ~/.claude/hooks/，并将配置合并到 ~/.claude/settings.json。

使用 --uninstall 卸载。使用 --list 查看当前状态。

效果

~/.claude/settings.json 中的 statusLine 指向状态栏脚本，并包含用于跟踪活跃 /loop cron 任务的 PostToolUse 和 SessionEnd 钩子。状态栏会在 Claude Code 的每一轮中显示。

状态栏显示内容

claude-sonnet-4-6 | myrepo@main (+3 -1) | 42k/200k (21%) | effort: high | 5h 12% @8:00pm | 7d 3% @mar 16, 9:00am | 2 loops | check deployment @4:10pm
部分说明
Model当前模型的显示名称
Repo@branchCWD 文件夹名称、git 分支、暂存的差异 +N -N
Tokens已用 / 总上下文，使用百分比
Effort当前 effort 级别（low / med / high）
5h / 7d速率限制使用情况及重置时间（缓存 60 秒）
Loops活跃 /loop cron 任务数量 + 最快触发的提示词和时间

步骤

--list

读取 ~/.claude/settings.json。报告是否已设置 statusLine，以及 ~/.claude/hooks/ 中是否存在每个钩子脚本。退出。

--uninstall

从 ~/.claude/settings.json 中移除 statusLine。移除此技能添加的三个 CronCreate|CronDelete / SessionEnd 钩子条目。不要移除钩子脚本（留待手动清理）。报告变更。退出。

默认（安装）

  1. 如果 ~/.claude/hooks/ 不存在，则创建它。

  2. 将以下三个脚本写入 ~/.claude/hooks/。未经展示差异并确认，绝不覆盖现有文件。

  3. 将三个脚本都设为可执行（chmod +x）。

  4. 读取 ~/.claude/settings.json（默认 {}）。合并以下 statusLine 条目和两个钩子条目。保留所有其他键。不要创建重复条目。

  5. 写入 ~/.claude/settings.json。

  6. 报告：

    ✓ statusline.sh         → ~/.claude/hooks/statusline.sh
✓ cron-state.sh         → ~/.claude/hooks/cron-state.sh
✓ cron-state-clear.sh   → ~/.claude/hooks/cron-state-clear.sh
✓ ~/.claude/settings.json updated
Note: restart Claude Code for changes to take effect.

脚本

根据 Agent Skills 规范，三个 shell 脚本位于 scripts/ 中：

脚本安装到用途
scripts/statusline.sh~/.claude/hooks/statusline.sh状态栏主渲染脚本
scripts/cron-state.sh~/.claude/hooks/cron-state.sh在 /tmp/claude/loops.json 中跟踪 /loop cron 任务
scripts/cron-state-clear.sh~/.claude/hooks/cron-state-clear.sh在会话结束时清除循环状态

将 scripts/ 中的每个脚本复制到 ~/.claude/hooks/。未经展示差异并确认，绝不覆盖现有脚本。

~/.claude/settings.json 条目

将这些条目合并到现有设置中。保留所有其他键。不要创建重复项。

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/hooks/statusline.sh"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "CronCreate|CronDelete",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/cron-state.sh",
            "async": true
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/cron-state-clear.sh",
            "async": true
          }
        ]
      }
    ]
  }
}

限制

  • 写入 ~/.claude/hooks/（用户全局目录），而不是 .claude/（项目本地目录）
  • 未经展示差异并确认，绝不覆盖现有脚本
  • 绝不丢弃 ~/.claude/settings.json 中已有的键
  • 需要：jq、curl、python3、git（在 macOS/Linux 上均为标准工具）
  • 5h/7d 使用情况部分需要 Claude Pro/Max OAuth 会话；如果找不到令牌，则会静默省略
  • 安装后：重启 Claude Code，使状态栏和钩子生效

评论

支持 Markdown