feelfreeai-cli

FeelFree AI CLI

*?�국??친화??AI 코딩 ?�시?�턴?? - llama.cpp?� Gemini�?지?�하??강력??CLI ?�구

??주요 기능

• ?�� **?�중 LLM 지??*: llama.cpp (로컬) �?Gemini API
• ?��?�� **?�벽???�국??지??*: 모든 UI?� ?�답???�국?�로 ?�공
• ?�� ?�?�형 REPL: ?�연?�러???�???�터?�이??
• ?�� ?�일 컨텍?�트: @filename ?�로 ?�일 직접 참조 가??
• ??명령 ?�행: !command �???명령???�행 �?분석
• ?�� **?�션 관�?*: ?�???�??로드 기능
• ?�� ?�전???�행: ?�험 명령???�동 차단
• ?�� ?�트리밍 ?�답: ?�시�??�답 ?�시

?�� ?�치

npm install -g feelfreeai-cli

?? 빠른 ?�작

1. 초기 ?�정

feelfree init

?�?�형 ?�정 마법?��? ?�음???�내?�니??

• LLM ?�로바이???�택 (llama.cpp ?�는 Gemini)
• API ???�정 (Gemini ?�용 ??
• ?�버 ?�드?�인???�정 (llama.cpp ?�용 ??
• 모델 ?�정

2. ?�???�작

REPL 모드 (권장)

feelfree

?�?�형 ?�터?�이?�에??

• ?�연?�럽�?질문?�기
• `@?�일�? ?�로 ?�일 참조
• `!명령?? �???명령 ?�행
• /help �??�용 가?�한 명령???�인

?�일 질문 모드

feelfree -q "???�로?�트??구조�?분석?�줘"

?�일 컨텍?�트?� ?�께

feelfree -q "??코드�?리뷰?�줘" -f src/main.ts -f tests/main.test.ts

?�� ?�용 ?�제

?�일 참조?�기

You: @README.md ???�로?�트가 뭐하??거야?

명령 ?�행?�기

You: !npm test
You: ???�스??결과�?분석?�줘

?�션 ?�??로드

You: /save my-session
You: /sessions
You: /load my-session

멀?�파??분석

You: @src/index.ts @src/config.ts ???�일??관계�? ?�명?�줘

?�� REPL 명령??

명령??	?�명
/help	?��?�??�시
/clear	?�??기록 초기??
/save [?�름]	?�재 ?�션 ?�??
/load [?�름]	?�션 불러?�기
/sessions	?�?�된 ?�션 목록
/files	로드???�일 목록
/context	컨텍?�트 초기??
/exit	종료

?�️ ?�정

?�역 ?�정

?�정 ?�일 ?�치: ~/.config/feelfreeai/config.json

{
  "defaultProvider": "gemini",
  "providers": {
    "gemini": {
      "type": "gemini",
      "apiKey": "YOUR_API_KEY",
      "model": "gemini-pro",
      "temperature": 0.7
    },
    "llamacpp": {
      "type": "llamacpp",
      "endpoint": "http://localhost:8080",
      "model": "llama-3-8b",
      "temperature": 0.7
    }
  },
  "language": "ko",
  "streaming": true
}

?�로?�트�??�정

?�로?�트 루트??FEELFREE.md ?�일 ?�성:

# ?�로?�트 ?�름

???�로?�트??TypeScript�??�성?????�플리�??�션?�니??

## 컨텍?�트
- React?� Node.js ?�용
- Express 백엔??
- PostgreSQL ?�이?�베?�스

## 커스?� 지�?
- 코드????�� TypeScript�??�성
- ESLint 규칙 준??
- Jest�??�스???�성

?�� CLI ?�션

feelfree [options] [command]

Commands:
  init                 ?�정 마법???�작
  login                API ???�정
  update               ?�정 ?�데?�트

Options:
  -q, --query <text>   ?�일 질문
  -f, --file <path>    ?�일 컨텍?�트 추�?
  -p, --prompt <text>  커스?� ?�스???�롬?�트
  -m, --model <name>   ?�용??모델
  --no-stream          ?�트리밍 비활?�화
  -v, --version        버전 ?�시
  -h, --help           ?��?�??�시

?�� ?�스??

# 모든 ?�스???�행
npm test

# ?�위 ?�스?�만
npm run test:unit

# 커버리�? 리포??
npm run test:coverage

# Watch 모드
npm test -- --watch

?�재 ?�스???�태: 70/82 ?�스???�과 (85.4%)

?�� 기여?�기

• Fork the repository
• Create your feature branch (git checkout -b feature/amazing-feature)
• Commit your changes (git commit -m 'Add amazing feature')
• Push to the branch (git push origin feature/amazing-feature)
• Open a Pull Request

개발 ?�경 ?�정

# ?�?�소 ?�론
git clone https://github.com/dhsgud/feelfreeai-cli.git
cd feelfreeai-cli

# ?�존???�치
npm install

# 빌드
npm run build

# 개발 모드 (watch)
npm run dev

# 린트
npm run lint
npm run lint:fix

# ?�맷??
npm run format

?�� ?�구?�항

• Node.js >= 18.0.0
• npm >= 8.0.0

LLM ?�로바이??

**Gemini ?�용 ??*:

• Google AI Studio API ??(발급 받기)

**llama.cpp ?�용 ??*:

• 로컬?�서 ?�행 중인 llama.cpp ?�버
• 기본 ?�드?�인?? http://localhost:8080

?���?보안

• API ?�는 로컬???�전?�게 ?�?�됩?�다
• ?�험??명령???�동 차단 (rm -rf /, fork bomb ??
• 주의 ?�요 명령?�는 ?�용???�인 ?�청

?�� ?�이?�스

MIT License - ?�유�?�� ?�용?�세??

?�� 감사

• llama.cpp - 로컬 LLM ?�행
• Google Gemini - 강력??AI 모델
• Commander.js - CLI ?�레?�워??
• Inquirer.js - ?�?�형 ?�롬?�트

?�� 버그 리포??

?�슈가 ?�으?�면 GitHub Issues???�록?�주?�요.

?�� ?�락�?

• GitHub: @dhsgud
• Email: [e-mail]

Made with ?�️ for Korean Developers