open-index/open-npm huggingface dataset:
npm package: @jhl8041/nclaude
Description: NHN Agent Skills가 적용된 Claude Code 실행
Latest version: 1.1.1

# nclaude CLI

NHN Agent Skills가 적용된 Claude Code 실행 도구

## 설치

```bash
cd /Users/nhn/repository/team-ai-dashboard/cli
npm install
npm run build
npm install -g .
```

## 사용법

### 초기 설정
```bash
nclaude init
```

다음 정보를 입력:
- API 서버 URL (기본: http://localhost:8080/api)
- GHE Username
- GHE Personal Access Token

### Claude Code 실행
```bash
nclaude [Claude Code 옵션들...]
```

예시:
```bash
nclaude                      # Claude Code 대화형 모드
nclaude "파일 목록 보여줘"     # 직접 명령
nclaude --help              # Claude Code 도움말
```

### 재인증
JWT가 만료되면 자동으로 재인증 프롬프트가 표시되거나, 수동으로:
```bash
nclaude init
```

## 동작 방식

1. API 서버에서 팀 skills 조회 (`GET /me/skills`)
2. Skills를 `~/.claude/CLAUDE.md`에 동기화
3. Skills를 `~/.nclaude/cache/skills.json`에 캐시
4. Claude Code 실행 (동기화된 skills가 자동 적용됨)

## 파일 구조

```
~/.nclaude/
├── config.json          # API URL, username, JWT
└── cache/
    └── skills.json      # Skills 캐시 (API 실패 시 fallback)

~/.claude/
└── CLAUDE.md           # Skills 동기화 대상 (<!-- nclaude:start --> ~ <!-- nclaude:end -->)
```

## 기술 스택

- TypeScript 5.7
- Commander.js 13 (CLI 프레임워크)
- Inquirer.js 12 (대화형 프롬프트)
- Node.js 20+ (내장 fetch 사용)