statux

[CC] mdl:opus-4.7 │ ctx:[████████░░] 82% │ tok:in:45k out:12k cache:30k │ cost:~0ドル.35 │ time:25m
git:main │ ±5 │ $/min:0ドル.01/min │ rl:42% │ tools:Read→Edit

目录

截图

终端运行界面

功能特性

安装

npm / bun(推荐)

# npm
npm install -g @statux/cli
# bun
bun install -g @statux/cli

独立二进制

# 下载后添加执行权限
chmod +x statux-darwin-arm64
# 移动到 PATH
mv statux-darwin-arm64 /usr/local/bin/statux

sha256sum -c statux-darwin-arm64.sha256

从源码构建

git clone https://github.com/Meteorkid/statux.git
cd statux
bun install
# 多平台构建
bun run build
# 当前平台本地构建
bun run build:local

快速开始

# 使用模拟数据测试
echo '{"model":{"display_name":"opus-4.7"},"context_window":{"used_percentage":42},"cost":{"total_cost_usd":0.35}}' | statux
# 启动 TUI 配置界面
statux --tui
# 检查本地集成状态
statux doctor
# 安装 iTerm2 插件
statux --setup

Claude Code 集成

{
 "statusLine": {
 "type": "command",
 "command": "statux",
 "refreshInterval": 10
 }
}

{
 "statusLine": {
 "type": "command",
 "command": "bun /path/to/statux/src/cli.ts",
 "refreshInterval": 10
 }
}

Codex (OpenAI) 集成

1. SQLite 直接读取(自动)

2. statux-bridge 插件(推荐)

# 插件目录:~/.codex/plugins/statux-bridge/
# hooks.json:SessionStart + Stop hooks
# 数据流:hook → bridge JSON → transcript JSONL → token 指标

# ~/.codex/config.toml
[features]
hooks = true
[plugins."statux-bridge"]
enabled = true

使用方式

# 单次检测(自动识别 Codex 还是 Claude Code)
statux --oneshot
# 轮询模式(持续刷新)
statux --watch 3

指标覆盖对比

iTerm2 集成

自动安装

statux --setup

手动安装

工作原理

statux CLI → OSC 1337 自定义序列 → iTerm2 Python daemon → 状态栏 + 标签颜色

Widget 目录

Core — 核心信息

Context — 上下文

Tokens & Speed — Token 与速度

Git — 版本控制

基础信息

变更统计

文件计数

高级信息

Session — 会话

Usage — 用量统计

History — 历史统计

statux --history 7 # 最近 7 天用量统计
statux --history 30 # 最近 30 天

Efficiency — 效率指标

Custom — 自定义

{
 "type": "custom-command",
 "metadata": {
 "command": "date +%H:%M"
 }
}

{
 "type": "custom-text",
 "metadata": {
 "text": "DEV"
 },
 "color": "red",
 "bold": true
}

Jujutsu — Jujutsu VCS

Layout — 布局

渲染模式

Normal 模式(默认)

mdl:opus-4.7 │ think:high │ Mem:12G/36G │ ctx:[████████░░] 82% │ len:85k

Powerline 模式

 opus-4.7 [████████░░] 82% in:45k out:12k main 0ドル.35 

{
 "renderMode": "powerline",
 "powerline": {
 "theme": "dark"
 }
}

配置参考

默认配置(双行布局)

{
 "version": 1,
 "lines": [
 [
 { "id": "tool", "type": "tool-indicator", "merge": "no-padding" },
 { "id": "s0", "type": "separator", "color": "white", "merge": "no-padding", "metadata": { "separator": " " } },
 { "id": "model", "type": "model", "label": "mdl", "color": "orange", "merge": "no-padding" },
 { "id": "s1", "type": "separator", "color": "white", "merge": "no-padding", "metadata": { "separator": " │ " } },
 { "id": "ctxbar", "type": "context-bar", "merge": "no-padding" },
 { "id": "s2", "type": "separator", "color": "white", "merge": "no-padding", "metadata": { "separator": " │ " } },
 { "id": "tok", "type": "tokens", "label": "tok", "color": "magenta", "merge": "no-padding" },
 { "id": "s3", "type": "separator", "color": "white", "merge": "no-padding", "metadata": { "separator": " │ " } },
 { "id": "cost", "type": "cost", "label": "cost", "color": "green", "merge": "no-padding" },
 { "id": "s4", "type": "separator", "color": "white", "merge": "no-padding", "metadata": { "separator": " │ " } },
 { "id": "clock", "type": "session-clock", "label": "time", "color": "yellow", "merge": "no-padding" }
 ],
 [
 { "id": "branch", "type": "git-branch", "label": "git", "color": "cyan", "merge": "no-padding" },
 { "id": "s5", "type": "separator", "color": "white", "merge": "no-padding", "metadata": { "separator": " │ " } },
 { "id": "changes", "type": "git-changes", "color": "yellow", "merge": "no-padding" },
 { "id": "s6", "type": "separator", "color": "white", "merge": "no-padding", "metadata": { "separator": " │ " } },
 { "id": "crate", "type": "cost-rate", "label": "$/min", "color": "cyan", "merge": "no-padding" },
 { "id": "s7", "type": "separator", "color": "white", "merge": "no-padding", "metadata": { "separator": " │ " } },
 { "id": "rl", "type": "rate-limit", "color": "yellow", "merge": "no-padding" },
 { "id": "s8", "type": "separator", "color": "white", "merge": "no-padding", "metadata": { "separator": " │ " } },
 { "id": "tools", "type": "tool-calls", "label": "tools", "color": "blue", "merge": "no-padding" }
 ]
 ],
 "renderMode": "normal",
 "colorLevel": 3,
 "globalBold": true,
 "minimalistMode": false
}

配置字段

Widget 配置项

TUI 配置界面

statux --tui

快捷键

架构

statux (TypeScript/Bun)
├── src/
│ ├── cli.ts # CLI 入口:statusLine/oneshot/watch/TUI 模式
│ ├── cli/
│ │ ├── args.ts # CLI 参数解析
│ │ ├── doctor.ts # 本地集成诊断
│ │ ├── output.ts # iTerm2 OSC + status.json 输出
│ │ └── session-history.ts # 会话历史输出与记录
│ ├── setup.ts # iTerm2 plugin 安装
│ ├── types/
│ │ ├── StatusJSON.ts # 输入 schema (Zod)
│ │ ├── Widget.ts # Widget 接口定义(含 Tool 枚举)
│ │ ├── Tool.ts # AI 工具进程检测
│ │ └── Config.ts # 配置 schema
│ ├── widgets/ # 72 个 Widget 实现
│ │ ├── registry.ts # Widget 注册表
│ │ ├── tool-indicator.ts # 工具标识 [CC]/[CX]
│ │ └── *.ts # 各 Widget 文件
│ ├── render/
│ │ ├── pipeline.ts # 两阶段渲染
│ │ ├── ansi.ts # ANSI 工具
│ │ └── powerline.ts # Powerline 渲染
│ ├── data/
│ │ ├── render-context.ts # Claude/Codex RenderContext 构建
│ │ ├── widget-requirements.ts # 根据配置判断需要采集的数据
│ │ ├── jsonl.ts # Claude Code JSONL 解析(适配器)
│ │ ├── codex.ts # Codex SQLite + bridge + transcript 解析
│ │ ├── iterm2-status.ts # iTerm2 状态 payload 构建
│ │ ├── transcript.ts # 统一 transcript 解析层(NormalizedEntry)
│ │ ├── claude-session.ts # Claude Code 会话检测
│ │ ├── model-pricing.ts # 双层定价:精选表 + LiteLLM 2200+ 模型
│ │ ├── litellm-fetcher.ts # LiteLLM 定价数据拉取和缓存
│ │ ├── history.ts # SQLite 会话历史存储和查询
│ │ ├── git.ts # Git 状态采集
│ │ ├── jujutsu.ts # Jujutsu 状态采集
│ │ └── usage-api.ts # Anthropic Usage API 客户端
│ ├── config.ts # 配置加载/保存/迁移
│ └── tui/ # Ink TUI 配置界面
│ ├── App.tsx # 主应用组件
│ └── index.tsx # TUI 入口
├── iterm2/
│ └── statux.py # iTerm2 Python Plugin(setup.ts 的单一来源)
└── scripts/
 └── build.ts # 多平台构建脚本

数据流

Claude Code → stdin(StatusJSON) → statux CLI → 解析 JSON + JSONL
 ↓
Codex → SQLite (state_5.sqlite) ↓
 → hooks bridge (codex-bridge.json) ↓
 → transcript JSONL ↓
 ↓
 → Widget 渲染 → stdout(ANSI) → 终端显示
 ↓
 OSC 1337 序列 → iTerm2 → 状态栏 + 标签颜色

从源码构建

前置条件

构建命令

# 安装依赖
bun install
# 类型检查
bun run typecheck
# 当前平台本地构建
bun run build:local
# 多平台构建
bun run build

发布流程

# 更新版本号
# 编辑 package.json 中的 version
# 创建 tag 并推送
git tag v0.2.0
git push origin v0.2.0

与 ccstatusline 的对比

License