{"_id":"@callakrsos/my-ollama-cli","_rev":"2-9c91924831bae622b7438538317b9e45","name":"@callakrsos/my-ollama-cli","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@callakrsos/my-ollama-cli","version":"1.0.0","author":{"name":"callakrsos"},"license":"ISC","_id":"@callakrsos/my-ollama-cli@1.0.0","maintainers":[{"name":"callakrsos","email":"callakrsos@naver.com"}],"bin":{"vCli":"index.js"},"dist":{"shasum":"9f569e8741525d929e3c175bcc1259e280e20c77","tarball":"https://registry.npmjs.org/@callakrsos/my-ollama-cli/-/my-ollama-cli-1.0.0.tgz","fileCount":26,"integrity":"sha512-Iiv3tuvzZlKRxiDkLdlo251vQ0z2FkyN9XbN4xJQPjKL61djGJEO5FTukSCS/lg4lRbTFhP6OtaEzGNxwHKfQA==","signatures":[{"sig":"MEYCIQDwM1cH9He5hq18TqUjwfPddtPCkeD2xzMXTP4rzVlkVwIhAP9du/Weioqm0Zct8zIVVW4v4GQXeJDdFbnwsRruSaog","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":102927},"main":"index.js","type":"module","gitHead":"8528147b9c6ab1a653af6a07efc1a865485df585","scripts":{"test":"echo \"Error: no test specified\" && exit 1","start":"node index.js"},"_npmUser":{"name":"callakrsos","email":"callakrsos@naver.com"},"_npmVersion":"11.8.0","description":"CLI Agent with Ollama/Gemini/OpenAI support","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.23.8","glob":"^11.0.0","chalk":"^5.3.0","dotenv":"^16.4.5","inquirer":"^13.2.2","commander":"^14.0.3","langchain":"^1.2.32","pdf-parse":"^2.4.5","@langchain/core":"^1.1.32","@inquirer/prompts":"^8.2.0","@langchain/ollama":"^1.2.6","@langchain/openai":"^1.2.13","@langchain/langgraph":"^1.2.2","@langchain/mcp-adapters":"^1.1.3"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/my-ollama-cli_1.0.0_1773583184389_0.35998841299485806","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."}},"time":{"created":"2026-03-15T13:59:44.275Z","modified":"2026-04-05T01:51:58.073Z","1.0.0":"2026-03-15T13:59:44.555Z"},"author":{"name":"callakrsos"},"license":"ISC","description":"CLI Agent with Ollama/Gemini/OpenAI support","maintainers":[{"name":"callakrsos","email":"callakrsos@naver.com"}],"readme":"# KYJ CLI Agent (vCli)\r\n\r\nOllama / vLLM 기반 로컬 AI CLI Agent입니다.\r\nAI 사용이 제한된 환경에서 Claude Code 같은 경험을 로컬에서 구현하는 것을 목표로 합니다.\r\n\r\n---\r\n\r\n## 🚀 빠른 시작\r\n\r\n### 1. Ollama 설치 및 모델 다운로드\r\n\r\n```bash\r\n# Windows: https://ollama.ai/download 에서 다운로드\r\n# macOS\r\nbrew install ollama\r\n\r\n# 권장 모델 (cloud 모델 — 원격 추론, 무료)\r\nollama pull kimi-k2.5:cloud\r\n\r\n# 로컬 실행 권장 모델\r\nollama pull qwen2.5:7b\r\nollama pull llama3.1:8b\r\n```\r\n\r\n### 2. 프로젝트 설정\r\n\r\n```bash\r\ngit clone <repo>\r\ncd myOllamacli\r\n\r\nnpm install\r\n\r\n# 환경 변수 설정\r\ncp .env_example .env\r\n# .env 에서 OLLAMA_MODEL 변경 가능\r\n```\r\n\r\n### 3. 실행\r\n\r\n```bash\r\nnpm run start\r\n# 또는\r\nnode index.js\r\n```\r\n\r\n---\r\n\r\n## 📦 권장 모델\r\n\r\n| 모델 | 종류 | 속도 | 품질 | 비고 |\r\n|------|------|------|------|------|\r\n| **kimi-k2.5:cloud** | ☁️ cloud | ⚡⚡⚡ | ⭐⭐⭐⭐⭐ | **기본값** — 원격 추론, 설치 불필요 |\r\n| qwen2.5:7b | 💻 local | ⚡⚡ | ⭐⭐⭐⭐ | 코딩 특화, 로컬 권장 |\r\n| llama3.1:8b | 💻 local | ⚡⚡ | ⭐⭐⭐ | 범용 |\r\n| mistral:7b | 💻 local | ⚡⚡ | ⭐⭐⭐ | 빠른 추론 |\r\n| gemma2:2b | 💻 local | ⚡⚡⚡ | ⭐⭐ | 저사양 PC |\r\n\r\n> **cloud 모델**은 `ollama pull` 만 하면 Ollama가 원격 서버에서 추론합니다.\r\n> 별도 GPU 없이도 고성능 응답이 가능합니다.\r\n\r\n---\r\n\r\n## 🎯 명령어 전체 목록\r\n\r\n| 명령어 | 설명 |\r\n|--------|------|\r\n| `@<검색어>` | 단일 파일 첨부 후 질문 (예: `@index`) |\r\n| `@@<검색어>` | 멀티 파일 첨부 — Space 선택, Enter 확인 |\r\n| `/skill <이름>` | 스킬 실행 (예: `/skill commit`) |\r\n| `/skills` | 사용 가능한 스킬 전체 목록 출력 |\r\n| `/clear` | 터미널 화면 + 대화 기록 초기화 |\r\n| `/list` | 현재 대화 기록 콘솔 출력 |\r\n| `/save` | 대화 기록을 Markdown 파일로 저장 |\r\n| `/log` | 로그 파일 현황 및 오늘 최근 에러 미리보기 |\r\n| `/mcp` | 연결된 MCP 서버 목록 출력 |\r\n| `/baseDir` | 작업 디렉토리 변경 |\r\n| `/help` | 명령어 도움말 출력 |\r\n| `/exit` | 프로그램 종료 |\r\n\r\n> ↑↓ 방향키로 이전 입력 내용을 탐색할 수 있습니다.\r\n\r\n---\r\n\r\n## ✨ 주요 기능\r\n\r\n### AI 내장 도구 (Tools)\r\n\r\n| 도구 | 설명 |\r\n|------|------|\r\n| `read_file` | 파일 읽기 및 분석 (BOM 자동 처리) |\r\n| `write_file` | 파일 생성 / 수정 |\r\n| `execute_shell_command` | 셸 명령어 실행 (PowerShell) |\r\n| `execute_python_code` | Python 코드 작성 후 즉시 실행 |\r\n| `read_pdf` | PDF 텍스트 추출 |\r\n\r\n### Skills 시스템\r\n\r\n자주 쓰는 작업을 슬래시 한 줄로 실행합니다.\r\n\r\n```\r\n/skill commit     → git diff 분석 후 Conventional Commits 메시지 작성\r\n/skill review     → 코드 리뷰 (버그/성능/보안)\r\n/skill explain    → 코드 단계별 설명\r\n/skill test       → 단위 테스트 코드 작성\r\n/skill refactor   → 리팩토링 제안\r\n/skill doc        → JSDoc / README 작성\r\n/skill analyze    → Python으로 데이터 분석\r\n/skill security   → OWASP 기준 보안 취약점 검토\r\n```\r\n\r\n**커스텀 스킬** — `skills.json` 파일을 만들면 스킬을 추가/덮어쓸 수 있습니다.\r\n(`skills.example.json` 참고)\r\n\r\n### 파일 첨부\r\n\r\n```\r\nKYJ_AI > @cli          ← 'cli' 포함 파일 검색 후 단일 선택\r\nKYJ_AI > @@src         ← 'src' 포함 파일 목록에서 복수 선택 (Space)\r\n```\r\n\r\n### 로그\r\n\r\n실행 중 모든 대화와 에러가 `./logs/` 에 날짜별로 기록됩니다.\r\n\r\n```\r\nlogs/\r\n├── chat_2026-03-15.log    ← 입력·응답·소요시간·툴 호출 목록\r\n├── error_2026-03-15.log   ← 에러 메시지 + 스택트레이스\r\n└── system_2026-03-15.log  ← 시작/종료 이벤트\r\n```\r\n\r\n`/log` 명령어로 현황 및 오늘 최근 에러를 바로 확인할 수 있습니다.\r\n\r\n### MCP (Model Context Protocol) 서버 연동\r\n\r\n`settings.json` 에 MCP 서버를 등록하면 AI가 사용할 수 있는 도구가 자동으로 확장됩니다.\r\n\r\n```json\r\n{\r\n  \"mcp\": {\r\n    \"enabled\": true,\r\n    \"mcpServers\": {\r\n      \"chrome-devtools\": {\r\n        \"command\": \"npx\",\r\n        \"args\": [\"-y\", \"chrome-devtools-mcp@latest\"]\r\n      },\r\n      \"비활성서버\": { \"enabled\": false, \"...\": \"enabled: false 로 비활성화\" }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n---\r\n\r\n## ⚙️ 환경 변수 (.env)\r\n\r\n```bash\r\n# Ollama (기본)\r\nOLLAMA_BASE_URL=http://localhost:11434\r\nOLLAMA_MODEL=kimi-k2.5:cloud\r\n\r\n# vLLM (OpenAI 호환 서버)\r\nLLM_PROVIDER=vllm\r\nVLLM_BASE_URL=http://localhost:8000\r\nVLLM_MODEL=meta-llama/Llama-3.2-3B-Instruct\r\n```\r\n\r\n---\r\n\r\n## 🔒 보안\r\n\r\n- 작업 디렉토리 외부 파일 접근 차단\r\n- 위험 명령어 차단: `rm`, `del`, `sudo`, `su`, `shutdown`, `reboot`\r\n- 명령어 히스토리: `~/.kyj_cli_history` (최대 200개)\r\n- 로그 파일은 `.gitignore` 에 포함되어 git에 올라가지 않음\r\n\r\n---\r\n\r\n## 🐛 트러블슈팅\r\n\r\n### npm install 오류\r\n```bash\r\nrm -rf node_modules package-lock.json\r\nnpm install\r\n```\r\n\r\n### Ollama 연결 실패\r\n```bash\r\nollama list       # 설치 확인\r\nollama serve      # 서버 시작\r\n```\r\n\r\n### 모델 응답이 느림\r\n- cloud 모델 사용: `OLLAMA_MODEL=kimi-k2.5:cloud`\r\n- 더 작은 로컬 모델: `gemma2:2b`, `qwen2.5:3b`\r\n\r\n---\r\n\r\n## 📄 라이선스\r\n\r\nApache 2.0 — 제작: 김영준\r\n","readmeFilename":"README.md"}