본문으로 건너뛰기
cccskills
무료GitHub에 공개

local-bootstrap-cli-auth-debug

Diagnose and repair OpenASE CLI access in local bootstrap mode. Use when protected `openase` commands fail because the CLI is missing a local human session, has a stale `~/.openase/human-session.json`, is missing CSRF state, or needs a fresh `openase auth bootstrap login`.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PacificStudio/openase스타 269(GitHub 269 + cccskills 0)

실행 점수 미검증

설치 방법 보기

포함된 파일(2)

  • SKILL.md3.0 KB
  • scripts/check_local_cli_auth.sh1.0 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Local Bootstrap CLI Auth Debug

Use This When

  • OpenASE is running in local bootstrap mode, not active OIDC.
  • Protected CLI commands return HUMAN_SESSION_REQUIRED, HUMAN_SESSION_INVALID, or CSRF errors.
  • You need to create, inspect, refresh, or clear the CLI human session used by typed openase commands.

Key Facts

  • CLI human session state lives at ~/.openase/human-session.json by default.
  • openase auth bootstrap login creates a fresh local bootstrap authorization, redeems it through /api/v1/auth/local-bootstrap/redeem, and stores the resulting session + CSRF for later commands.
  • Typed and raw API commands automatically reuse that stored session unless a Bearer token is provided.
  • Local bootstrap sessions are tied to the current host context; if the stored session goes stale, re-login from the same machine and shell.

Standard Flow

  1. Verify the service is healthy:
    • curl -fsS http://127.0.0.1:19836/healthz
  2. Run the non-mutating diagnostic helper:
    • .codex/skills/local-bootstrap-cli-auth-debug/scripts/check_local_cli_auth.sh
  3. If the helper reports no valid CLI human session, refresh it:
    • openase auth bootstrap login
  4. Re-check the current principal:
    • openase auth session
  5. Re-run the failing protected command.

Fast Repair Commands

openase auth bootstrap login
openase auth session
openase auth sessions list
openase auth logout
openase auth bootstrap login

Failure Patterns

  • HUMAN_SESSION_REQUIRED
    • The CLI has no usable stored local human session.
    • Fix: run openase auth bootstrap login.
  • HUMAN_SESSION_INVALID
    • The stored session file exists, but the cookie is expired, revoked, or no longer matches the current request context.
    • Fix: openase auth logout then openase auth bootstrap login.
  • CSRF_TOKEN_INVALID or CSRF_ORIGIN_FORBIDDEN
    • The CLI session is present but the request is missing valid CSRF state or origin context.
    • Fix: refresh the stored session with openase auth bootstrap login, then retry from the same machine.
  • LOCAL_BOOTSTRAP_DISABLED
    • The instance is no longer in local bootstrap mode.
    • Stop and switch to the OIDC/browser auth path instead of retrying this skill.

Useful Overrides

  • Alternate session file:
    • --session-file /tmp/openase-human-session.json
    • OPENASE_HUMAN_SESSION_FILE=/tmp/openase-human-session.json
  • Manual session injection:
    • OPENASE_HUMAN_SESSION_TOKEN=...
    • OPENASE_HUMAN_CSRF_TOKEN=...
  • Alternate API base:
    • OPENASE_API_URL=http://127.0.0.1:19836/api/v1

Files

  • Skill helper:
    • .codex/skills/local-bootstrap-cli-auth-debug/scripts/check_local_cli_auth.sh
  • Default stored state:
    • ~/.openase/human-session.json

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

auto-harness

무료

Diagnose and strengthen a repository's harness layer: AGENTS.md rules, knowledge layout, architecture boundaries, lint and type gates, API and generated-client contracts, test scaffolding, structured logging, and technical-debt tracking. Use when Codex needs to audit drift-prone semantics that are repeated across code, docs, schemas, generated artifacts, frontend/backend boundaries, or CI, then design or implement guardrails with progressive disclosure and zero-tolerance contract checks.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PacificStudio/openase2692026년 8월 9일 업데이트

commit

무료

Create a well-formed git commit from current changes using session history for rationale and summary; use when asked to commit, prepare a commit message, or finalize staged work.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PacificStudio/openase2692026년 8월 9일 업데이트

commit

무료

Write concise Conventional Commit messages that match the actual scope of the change.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PacificStudio/openase2692026년 8월 9일 업데이트

create-pr

무료

Prepare a crisp pull request summary with scope, validation, and rollout notes.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PacificStudio/openase2692026년 8월 9일 업데이트

deep-interview

무료

Clarify ambiguous requests with a focused, Socratic interview before planning or implementation.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PacificStudio/openase2692026년 8월 9일 업데이트

deploy-coolify-review-env

무료

Create or update a branch-scoped Coolify review environment with one command, and delete it with one command. Use when a ticket must deploy a preview before human review, while keeping the workflow simple and fast.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

PacificStudio/openase2692026년 8월 9일 업데이트

PacificStudio의 스킬 모두 보기

이 스킬의 문제 신고