Skip to content

README.md

Latest commit

 

History

History
210 lines (155 loc) · 6.17 KB

README.md

File metadata and controls

210 lines (155 loc) · 6.17 KB

AI Dev OS CLI

CI npm version License: MIT

하나의 명령으로 **AI Dev OS**를 설정, 업데이트, 진단합니다.

npx ai-dev-os init --rules typescript --plugin claude-code

무엇을 할 수 있나?

수동 설정 CLI 사용 시
git submodule add x 3개 저장소 npx ai-dev-os init (하나의 명령)
수동 템플릿 복사 자동 복사
수동 hooks.json 병합 자동 병합 (백업 포함)
수동 submodule 상태 확인 npx ai-dev-os doctor
수동 submodule 업데이트 npx ai-dev-os update

빠른 시작

대화형 모드

npx ai-dev-os init

CLI가 규칙 프리셋과 플러그인 선택을 안내합니다:

  AI Dev OS Setup
  ───────────────

  ? Select rules preset:
  ❯ TypeScript (Next.js)
    Python (FastAPI)

  ? Select plugin:
  ❯ Claude Code
    Kiro
    Cursor

  ✔ Added submodule: .ai-dev-os/core
  ✔ Added submodule: .ai-dev-os/rules
  ✔ Added submodule: .ai-dev-os/plugin
  ✔ Copied template → CLAUDE.md
  ✔ Merged hooks → .claude/settings.json
  ✔ Created .ai-dev-os.yaml

  Done! Next steps:
    1. Edit CLAUDE.md to customize for your project
    2. Run /ai-dev-os-init in Claude Code to generate L1/L2
    3. See: https://github.com/yunbow/ai-dev-os#quick-start

비대화형 모드

npx ai-dev-os init --rules typescript --plugin claude-code -y

명령어

명령어 설명
ai-dev-os init submodule 추가, 템플릿 복사, hooks 병합
ai-dev-os update submodule을 최신 또는 지정 버전으로 업데이트
ai-dev-os doctor 설치 상태 건강 검진 (7개 항목)
명령어 상세

Update

# 모든 submodule을 최신으로 업데이트
npx ai-dev-os update

# 적용하지 않고 업데이트 확인
npx ai-dev-os update --check

# 특정 버전으로 고정
npx ai-dev-os update --ref v1.3.0

Doctor

npx ai-dev-os doctor

검사 항목:

  • Git 저장소 유효성
  • .ai-dev-os.yaml 설정
  • submodule 초기화 (core, rules, plugin)
  • 템플릿 파일 존재 여부
  • hooks 통합 상태
옵션 
Usage: ai-dev-os init [options]

Options:
  --rules <name>   규칙 프리셋 (typescript | python)
  --plugin <name>  플러그인 (claude-code | kiro | cursor)
  --ref <tag>      특정 버전 태그로 고정 (기본값: "latest")
  --no-hooks       hooks.json 병합 건너뛰기
  --dry-run        실행하지 않고 내용만 표시
  -y, --yes        대화형 프롬프트 건너뛰기, 기본값 사용
설정 파일

CLI는 프로젝트 루트에 .ai-dev-os.yaml을 생성합니다:

version: "1.0"
core:
  repo: https://github.com/yunbow/ai-dev-os
  ref: latest
  path: .ai-dev-os/core
rules:
  name: typescript
  repo: https://github.com/yunbow/ai-dev-os-rules-typescript
  ref: latest
  path: .ai-dev-os/rules
plugin:
  name: claude-code
  repo: https://github.com/yunbow/ai-dev-os-plugin-claude-code
  ref: latest
  path: .ai-dev-os/plugin
hooks:
  merged: true
  mergedAt: "2026-03-20T10:00:00Z"
사용 가능한 프리셋

규칙

ID 이름 저장소
typescript TypeScript (Next.js) ai-dev-os-rules-typescript
python Python (FastAPI) ai-dev-os-rules-python

플러그인

ID 이름 저장소 템플릿 Hooks
claude-code Claude Code ai-dev-os-plugin-claude-code CLAUDE.md Yes
kiro Kiro ai-dev-os-plugin-kiro AGENTS.md --
cursor Cursor ai-dev-os-plugin-cursor .cursorrules --
설계 결정

CLI가 하는 것

CLI는 전달 메커니즘입니다 — git submodule 설정, 템플릿 복사, hooks 병합을 수행합니다. 규칙이나 플러그인의 내용은 포함하지 않습니다.

CLI가 하지 않는 것

결정 이유
rules/plugin 내용을 CLI 패키지에 포함 투명성과 포크 가능성이 사라짐
git submodule을 npm 의존성으로 대체 비 Node.js 프로젝트에서 사용 불가
CLI를 필수로 만들기 "CLI 없이도 사용 가능"이 핵심 설계 원칙
plugin 저장소 폐지 CLI는 "배달원"이지 "콘텐츠"가 아님
GitHub App / OAuth 연동 추가 과도함. git 작업만으로 충분

핵심 원칙

CLI는 git submodule add와 cp로 수동으로 할 수 있는 것을 자동화합니다. CLI가 사라져도 AI Dev OS의 모든 기능은 수동 설정으로 사용 가능합니다.

관련

저장소 설명
ai-dev-os 코어 프레임워크
rules-typescript TypeScript / Next.js 가이드라인
rules-python Python / FastAPI 가이드라인
plugin-claude-code Claude Code 통합
plugin-kiro Kiro 통합
plugin-cursor Cursor 통합
benchmark 정량적 벤치마크 — 가이드라인 영향 데이터

라이선스

MIT

언어: English | 日本語 | 简体中文 | 한국어 | Español