oauth ops
- Repo stars 0
- Author repo skills-registry
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tomevault-io · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Required · Vendor-specific
- Operating systems
- macOS · Linux · Windows
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Shell exec
- Network behavior
- External requests
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# OAuth Ops
이 스킬은 Hub LLM OAuth 운영 절차를 표준화한다. Refresh 자동화 자체는 `ai.hub.llm-oauth-monitor` launchd와 Hub 런타임이 담당한다. 스킬은 장애 대응, 재인증 판단, 리포트 해석, 운영자 액션 정리에만 사용한다.
## 기본 원칙
- 원문 토큰, refresh token, authorization header, client secret, API key를 출력하지 않는다.
- `ai.hub.llm-oauth-monitor`는 유지한다. 이 job은 15분 polling과 refresh/reimport를 담당한다.
- `llm-oauth4-master-review`는 daily 또는 on-demand 리포트로 취급한다. 실시간 refresh 책임을 주지 않는다.
- 장애 판단은 Hub selector/provider 상태, token-store expiry, live probe, local reimport 결과를 분리해서 본다.
- Gemini CLI OAuth는 짧은 수명 토큰 특성이 있으므로 live refresh probe와 reimport 결과를 함께 확인한다.
## 빠른 점검
```bash
npm --prefix bots/hub run -s oauth:monitor
npm --prefix bots/hub run -s oauth:runtime-refresh-gate
npm --prefix bots/hub run -s oauth:ops-readiness
```
Hub control tool로 조회할 수 있으면 먼저 read-only tool을 쓴다.
- `oauth.ops.status`: provider별 expiry/healthy 상태 조회
- `oauth.ops.events`: `agent.event_lake`의 `hub_oauth_monitor` 표준 이벤트 조회
- `oauth.ops.lock_janitor_plan`: OAuth refresh lock dry-run janitor 계획 조회
## 장애 대응 기준
- `healthy=false`: provider 인증 자체가 깨진 상태다. refresh/reimport 결과와 error를 확인하고 브라우저 재인증 또는 CLI login을 진행한다.
- `needs_refresh=true`: 만료 임박이다. monitor가 refresh/reimport를 시도했는지 먼저 본다.
- `refresh_ok=true`: Hub token-store refresh는 성공했다. local sync 실패 여부만 별도로 본다.
- `reimport_ok=true` 또는 `post_probe_reimport_ok=true`: 로컬 credential을 token-store에 재반영했다.
- `live_probe_ok=false`: token-store가 있어도 실제 호출 경로가 실패한다. provider cooldown, 권한, 네트워크, CLI 상태를 분리해서 본다.
- `lock_timeout`: refresh lock이 오래 남은 상태일 수 있다. `oauth.ops.lock_janitor_plan` 후 필요 시 별도 승인으로 janitor apply를 진행한다.
## Provider별 재인증 메모
- Claude Code OAuth: Claude CLI login/keychain 상태와 Hub token-store를 분리해서 본다. Sonnet quota 이슈와 OAuth 만료 이슈를 혼동하지 않는다.
- OpenAI Codex OAuth: Codex local auth와 Hub token-store sync를 확인한다. OpenAI public API key는 옵션이며 기본 경로가 아니다.
- Gemini CLI OAuth: CLI가 live refresh를 수행할 수 있으면 만료 임박 local token이어도 즉시 장애로 보지 않는다.
- Gemini OAuth: quota project와 Code Assist service 활성 상태를 함께 본다.
- Groq: 여러 키 pool 상태를 확인하되 OAuth refresh 범위와 분리한다.
## 금지
- 스킬 절차 안에서 토큰 값을 수집하거나 문서화하지 않는다.
- refresh 자동화를 shell hook이나 스킬로 옮기지 않는다.
- monitor job을 끄고 수동 재인증 중심으로 운영하지 않는다.
- provider failure를 모델 교체만으로 숨기지 않는다. 인증/쿼터/네트워크 원인을 별도로 기록한다.
---
> Source: [AlexLee00/ai-agent-system](https://github.com/AlexLee00/ai-agent-system) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
Sections and files
Listed in source order.
sections -> 기본 원칙 → 빠른 점검 → 장애 대응 기준 → Provider별 재인증 메모 → 금지
terms -> 이 스킬은 Hub LLM OAuth 운영 절차를 표준화한다. · - 원문 토큰, refresh token, authorization header, client secret, API key를 출력하지 않는다. · Hub control tool로 조회할 수 있으면 먼저 read-only tool을 쓴다. · - healthy=false: provider 인증 자체가 깨진 상태다. · - Claude Code OAuth: Claude CLI login/keychain 상태와 Hub token-store를 분리해서 본다. · - 스킬 절차 안에서 토큰 값을 수집하거나 문서화하지 않는다. · --- > Source: [AlexLee00/ai-agent-system](https://github.com/AlexLee00/ai-agent-system) — distributed by [TomeVault](https://tomevault.io).
files/cmd -> ai.hub.llm-oauth-monitor · llm-oauth4-master-review · oauth.ops.status · oauth.ops.events · agent.event_lake · hub_oauth_monitor · oauth.ops.lock_janitor_plan · healthy=false
body sha256 -> 20d217cbc18a
기본 원칙
원문 토큰, refresh token, authorization header, client secret, API key를 출력하지 않는다.
ai.hub.llm-oauth-monitor는 유지한다. 이 job은 15분 polling과 refresh/reimport를 담당한다.llm-oauth4-master-review는 daily 또는 on-demand 리포트로 취급한다. 실시간 refresh 책임을 주지 않는다. 장애 판단은 Hub selector/provider 상태, token-store expiry, live probe, local reimport 결과를 분리해서 본다. Gemini CLI OAuth는 짧은 수명 토큰 특성이 있으므로 live refresh probe와 reimport 결과를 함께 확인한다.빠른 점검
Hub control tool로 조회할 수 있으면 먼저 read-only tool을 쓴다.
oauth.ops.status: provider별 expiry/healthy 상태 조회oauth.ops.events:agent.event_lake의hub_oauth_monitor표준 이벤트 조회oauth.ops.lock_janitor_plan: OAuth refresh lock dry-run janitor 계획 조회장애 대응 기준
healthy=false: provider 인증 자체가 깨진 상태다. refresh/reimport 결과와 error를 확인하고 브라우저 재인증 또는 CLI login을 진행한다.needs_refresh=true: 만료 임박이다. monitor가 refresh/reimport를 시도했는지 먼저 본다.refresh_ok=true: Hub token-store refresh는 성공했다. local sync 실패 여부만 별도로 본다.reimport_ok=true또는post_probe_reimport_ok=true: 로컬 credential을 token-store에 재반영했다.live_probe_ok=false: token-store가 있어도 실제 호출 경로가 실패한다. provider cooldown, 권한, 네트워크, CLI 상태를 분리해서 본다.Provider별 재인증 메모
Claude Code OAuth: Claude CLI login/keychain 상태와 Hub token-store를 분리해서 본다. Sonnet quota 이슈와 OAuth 만료 이슈를 혼동하지 않는다. OpenAI Codex OAuth: Codex local auth와 Hub token-store sync를 확인한다. OpenAI public API key는 옵션이며 기본 경로가 아니다. Gemini CLI OAuth: CLI가 live refresh를 수행할 수 있으면 만료 임박 local token이어도 즉시 장애로 보지 않는다. Gemini OAuth: quota project와 Code Assist service 활성 상태를 함께 본다. Groq: 여러 키 pool 상태를 확인하되 OAuth refresh 범위와 분리한다.
금지
스킬 절차 안에서 토큰 값을 수집하거나 문서화하지 않는다. refresh 자동화를 shell hook이나 스킬로 옮기지 않는다. monitor job을 끄고 수동 재인증 중심으로 운영하지 않는다. provider failure를 모델 교체만으로 숨기지 않는다. 인증/쿼터/네트워크 원인을 별도로 기록한다. Source: AlexLee00/ai-agent-system — distributed by TomeVault.