mgh3326

Scopefuel — AI skill for Claude Code

AI community

Scope-aware headroom gauge for AI coding agent plans — what is actually blocked (account/model/group) and when it refills.

How to install Scopefuel

This entry records only its repository, not the path inside it, so there is no exact command to give. Open mgh3326/scopefuel and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Scopefuel does

Scope-aware headroom gauge for AI coding agent plans — what is actually blocked (account/model/group) and when it refills.

Alternatives in AI

Launch An AI Feature — Workflow recipe — take an AI/LLM feature from a probabilistic-aware PRD to a launch-ready model card by chaini 1.3k ★
Botmux — Bridge Feishu/Lark to AI coding CLIs — Claude Code, Codex, Gemini, OpenCode… every DM, group or topic spawns i 1.2k ★
Pilotfish — Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper models execute, verificati 688 ★

README

scopefuel

**Scope-aware headroom gauge for AI coding agent plans.** 여러 AI 코딩 플랜(Claude Code, OpenAI Codex, Google Antigravity …)의 남은 한도를 한 번에 조회하되, **무엇이 실제로 막히는지**를 구분해서 보여줍니다. 사람이 보는 표와 에이전트가 읽는 JSON을 같은 데이터로 제공합니다.

$ scopefuel
claude [max]  [CRIT] 지금(5h급) 6% · 이번주 97%
  now  5h                          6%   reset 07-25 13:09
  week 7d all                     97%   reset 07-25 17:59
  week 7d Fable                  100%   reset 07-25 17:59  [active, 이 모델만]
  ! Fable 소진(100%, reset 07-25 17:59) — 다른 모델은 계정 한도 범위에서 사용 가능

codex [pro]  [WARN] 지금(5h급) ? · 이번주 82%
  week 7d                         82%   reset 07-29 02:31
  week GPT-5.3-Codex-Spark 7d      0%   reset 08-01 12:05  [이 모델만]

agy  [ok] 그룹별 독립: 3p 57.3% / gemini 7.4%
  week gemini weekly             2.1%   reset 07-29 06:00
  now  gemini 5h                 7.4%   reset 07-25 15:53
  week 3p weekly                19.1%   reset 08-01 11:03
  now  3p 5h                    57.3%   reset 07-25 16:03

왜 또 하나의 쿼타 도구인가

이미 좋은 도구들이 있습니다([cclimits](https://github.com/cruzanstx/cclimits), [CodexBar](https://github.com/steipete/CodexBar) 등). scopefuel이 다르게 하는 것은 **두 축의 분리**뿐입니다.

scope — 무엇이 막히는가: account(계정 전체) / model(그 모델만) / group(그 모델 그룹만). 하나의 최대값으로 뭉개면 "특정 모델 하나 소진"을 "계정 차단"으로 오독합니다. 위 예시의 Fable 100%가 정확히 그 경우이고, Opus·Sonnet은 계정 한도(97%) 범위에서 여전히 쓸 수 있습니다.
horizon — 언제의 이야기인가: now(5시간급 창) / week(주간급 창). "지금 워커를 띄울 수 있나"와 "이번 주 예산이 남았나"는 다른 질문이고, 라우팅 결정도 갈립니다.

이 도구는 **읽기 전용**입니다. 토큰을 갱신하거나 한도를 조작하지 않습니다.

설치

uv tool install git+https://github.com/mgh3326/scopefuel     # 또는
uvx --from git+https://github.com/mgh3326/scopefuel scopefuel

의존성 0(stdlib만)입니다. `scopefuel` / `sfuel` 두 이름으로 설치됩니다.

사용법

scopefuel                          # 표
scopefuel --brief                  # 한 줄 (pane/statusline/알림용)
scopefuel --brief --horizon now    # "지금 띄울 수 있나"만
scopefuel --json                   # 에이전트 계약 (schema=scopefuel.v1)
scopefuel --raw