pulse-configuration

Pulse Configuration Skill

Overview

This skill provides guidance for configuring pulse-line modules and themes to customize the Claude Code status bar according to your workflow needs.

Configuration File

Location: ~/.claude/pulse/config.json

Open in editor:

pulse-line config

Module Configuration

Each module in the modules section has the following properties:

{
  "enabled": true,
  "order": 1,
  "icon": "[M]"
}

Available Modules

Core modules

model — current model; default tag [M].

context — usage bar; default [C].

git — branch plus ↑/↓; default [G].

cost — USD total; default [$].

Advanced (config.json keys)

duration, workspace, turns, cacheRatio, thinking, rateLimits, weeklyQuota, mcpStatus, outputStyle — bracket tags [T] … [S] in defaults (see bundled pulse-config.ts).

accountUsage — Zhipu / DeepSeek quotas via merged settings*.json env + process.env. For Claude Code routed through ANTHROPIC_BASE_URL → *.bigmodel.cn, GLM quotas use ANTHROPIC_AUTH_TOKEN (Anthropic-compat) when classic ZHIPU_* vars are absent.

thirdPartyApi — optional HTTP prefetch; rendered usage primarily via accountUsage cache.

iconSet

• "text" (default): bracket labels + separators safe without Nerd Fonts.
• "nerd": Nerd Font / Powerline symbols; patched terminal font required.

With iconSet: "text", if your config.json still has old Nerd/PUA characters in modules.*.icon or separator, Pulse replaces them with the bundled ASCII defaults so terminals without patched fonts do not show replacement glyphs (tofu).

Config files saved without schemaVersion run a one‑time upgrade first load (iconSet: nerd → text, then schemaVersion: 3 is written). Set iconSet to nerd again only if your terminal ships a patched Nerd Font.

Model name on the status bar

The model segment label resolves as follows (first non-empty wins):