Hanseol - OpenAI-Compatible Coding Agent
npm install hanseol
OpenAI-Compatible CLI Coding Agent
> A developer-focused coding agent for local or on-prem LLM environments.
> Works with vLLM, Ollama, LM Studio, and any OpenAI-compatible API.
https://github.com/user-attachments/assets/77cc96c9-cb22-4411-8744-3a006b00c580
---
- Read/search/edit/create code with safe, file-level changes.
- Plan & Execute: breaks tasks into TODOs and runs them step by step.
- Supervised Mode: approval required before file modifications.
- Browser automation: Chrome/Edge CDP control (navigate, click, screenshot).
- Office automation: PowerShell/COM control for Excel/Word/PowerPoint.
- Session management: save and restore conversation history.
- Auto retry & recovery for failed tool calls.
---
``bash1. Install
git clone https://github.com/A2G-Dev-Space/Hanseol.git
cd Hanseol
npm install && npm run build
The endpoint setup wizard launches automatically on first run.
---
Highlights
$3
Request approval before running file modification tools.$3
Automatically turns requests into TODOs and executes them in order.$3
- Browser: PowerShell/Chrome CDP, no external server required.
- Office: PowerShell/COM automation for Excel/Word/PowerPoint.---
Commands & Shortcuts
$3
| Command | Description |
|---------|-------------|
| | Help |
| /clear | Reset conversation |
| /compact | Compress conversation |
| /load | Load saved session |
| /model | Switch model |
| /settings | Settings menu |
| /usage | Token usage |
| /docs | Docs management |
| /tool | Toggle optional tools (browser/office) |$3
- Ctrl+C Exit
- ESC Interrupt
- Tab Auto ↔ Supervised
- @ File browser
- / Command autocomplete---
Configuration
`bash
hanseol # Setup wizard on first run
/settings # Settings menu while running
`Any OpenAI-compatible API works:
vLLM, Ollama, LM Studio, Azure OpenAI, or internal LLM servers.
---
Requirements
- Node.js v20+
- npm v10+
- Git (for docs/repo usage)
---
Contact
Email: gkstdmgk2731@naver.com
---
Documentation
- Developer Guide
- Logging System
- Testing Guide
- Roadmap
---
License
MIT License
---
GitHub: https://github.com/A2G-Dev-Space/Hanseol
---
Hanseol (한국어)
OpenAI-Compatible CLI Coding Agent
> 로컬/사내 LLM 환경에서 바로 사용할 수 있는 개발자용 코딩 에이전트입니다.
> vLLM, Ollama, LM Studio 등 OpenAI 호환 API를 지원합니다.
이 툴로 할 수 있는 것
- 코드 읽기/검색/수정/생성: 파일 단위로 안전하게 수정합니다.
- Plan & Execute: 작업을 TODO로 분해하고 단계적으로 실행합니다.
- Supervised Mode: 파일 변경 전 사용자 승인 기반 작업.
- 브라우저 자동화: Chrome/Edge CDP 제어(탭 이동, 클릭, 스크린샷 등).
- Office 자동화: PowerShell/COM 기반 Excel/Word/PowerPoint 제어.
- 세션 관리: 대화 및 작업 히스토리 저장/복원.
- 자동 재시도/에러 복구: 도구 호출 실패 시 자동 재시도.
Quick Start
bash
1. Install
git clone https://github.com/A2G-Dev-Space/Hanseol.git
cd Hanseol
npm install && npm run build2. Run
node dist/cli.js # 또는 npm link 후 'hanseol'
`첫 실행 시 LLM 엔드포인트 설정 마법사가 자동으로 열립니다.
---
주요 기능 하이라이트
$3
파일 수정 도구 실행 전에 승인 요청:
┌─────────────────────────────────────────────────────────────┐
│ 🔧 edit_file │
│ ───────────────────────────────────────────────────────── │
│ 📁 file_path: /src/utils/helper.ts │
│ 📝 diff: + added lines ... │
│ ───────────────────────────────────────────────────────── │
│ ▸ [1] ✅ Approve │
│ [2] ❌ Reject │
└─────────────────────────────────────────────────────────────┘
- Tab: Auto ↔ Supervised 모드 전환
- 파일 수정 도구만 승인 필요
- Reject 시 피드백을 반영해 재시도
$3
요청을 TODO로 분해해 순차 실행:
You: 로깅 시스템 추가해줘┌────────────────────────────────────────────────┐
│ 📋 TODO List 1/3 │
│ ████████░░░░░░░░░░░░░░░░░ 33% │
│ ├─ ☑ logger.ts 생성 │
│ ├─ ⣾ 기존 코드에 import 추가 │
│ └─ ☐ 에러 핸들링 적용 │
└────────────────────────────────────────────────┘
$3
- 브라우저 자동화: PowerShell/Chrome CDP 기반, 별도 서버 없음
- Office 자동화: PowerShell/COM 기반, Excel/Word/PowerPoint 직접 제어---
명령어 & 단축키
$3
| Command | 설명 |
|---------|------|
| | 도움말 |
| /clear | 대화 초기화 |
| /compact | 대화 압축 |
| /load | 세션 불러오기 |
| /model | 모델 전환 |
| /settings | 설정 메뉴 |
| /usage | 토큰 사용량 |
| /docs | 문서 관리 |
| /tool | 선택 기능 토글 (browser/office) |$3
- Ctrl+C 종료
- ESC 작업 중단
- Tab Auto ↔ Supervised
- @ 파일 브라우저
- / 명령어 자동완성---
Configuration
`bash
hanseol # 최초 실행 시 설정 마법사
/settings # 실행 중 설정 메뉴
``OpenAI 호환 API라면 대부분 연결 가능합니다:
vLLM, Ollama, LM Studio, Azure OpenAI, 사내 LLM 서버 등.
---
- Node.js v20+
- npm v10+
- Git (문서/리포 사용 시)
---
Email: gkstdmgk2731@naver.com
---
- Developer Guide
- Logging System
- Testing Guide
- Roadmap
---
MIT License
---
GitHub: https://github.com/A2G-Dev-Space/Hanseol