Hanseol (English)

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

What You Can Do

• 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.

Quick Start

# 1. Install
git clone https://github.com/A2G-Dev-Space/Hanseol.git
cd Hanseol
npm install && npm run build

# 2. Run
node dist/cli.js       # or use 'hanseol' after npm link

The endpoint setup wizard launches automatically on first run.

Highlights

Supervised Mode

Request approval before running file modification tools.

Plan & Execute

Automatically turns requests into TODOs and executes them in order.

Automation Extensions

• Browser: PowerShell/Chrome CDP, no external server required.
• Office: PowerShell/COM automation for Excel/Word/PowerPoint.

Commands & Shortcuts

Slash Commands

| Command | Description | |---------|-------------| | /help | 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) |

Keyboard Shortcuts

• Ctrl+C Exit
• ESC Interrupt
• Tab Auto ↔ Supervised
• @ File browser
• / Command autocomplete

Configuration

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: [email protected]

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

# 1. Install
git clone https://github.com/A2G-Dev-Space/Hanseol.git
cd Hanseol
npm install && npm run build

# 2. Run
node dist/cli.js       # 또는 npm link 후 'hanseol'

첫 실행 시 LLM 엔드포인트 설정 마법사가 자동으로 열립니다.

주요 기능 하이라이트

Supervised Mode

파일 수정 도구 실행 전에 승인 요청:

┌─────────────────────────────────────────────────────────────┐
│  🔧 edit_file                                                │
│  ─────────────────────────────────────────────────────────   │
│  📁 file_path: /src/utils/helper.ts                          │
│  📝 diff: + added lines ...                                  │
│  ─────────────────────────────────────────────────────────   │
│  ▸ [1] ✅ Approve                                            │
│    [2] ❌ Reject                                             │
└─────────────────────────────────────────────────────────────┘

• Tab: Auto ↔ Supervised 모드 전환
• 파일 수정 도구만 승인 필요
• Reject 시 피드백을 반영해 재시도

Plan & Execute

요청을 TODO로 분해해 순차 실행:

You: 로깅 시스템 추가해줘

┌────────────────────────────────────────────────┐
│ 📋 TODO List                            1/3    │
│ ████████░░░░░░░░░░░░░░░░░ 33%                  │
│ ├─ ☑ logger.ts 생성                          │
│ ├─ ⣾ 기존 코드에 import 추가                 │
│ └─ ☐ 에러 핸들링 적용                         │
└────────────────────────────────────────────────┘

최신 자동화 확장

• 브라우저 자동화: PowerShell/Chrome CDP 기반, 별도 서버 없음
• Office 자동화: PowerShell/COM 기반, Excel/Word/PowerPoint 직접 제어

명령어 & 단축키

Slash Commands

| Command | 설명 | |---------|------| | /help | 도움말 | | /clear | 대화 초기화 | | /compact | 대화 압축 | | /load | 세션 불러오기 | | /model | 모델 전환 | | /settings | 설정 메뉴 | | /usage | 토큰 사용량 | | /docs | 문서 관리 | | /tool | 선택 기능 토글 (browser/office) |

Keyboard Shortcuts

• Ctrl+C 종료
• ESC 작업 중단
• Tab Auto ↔ Supervised
• @ 파일 브라우저
• / 명령어 자동완성

Configuration

hanseol         # 최초 실행 시 설정 마법사
/settings       # 실행 중 설정 메뉴

OpenAI 호환 API라면 대부분 연결 가능합니다: vLLM, Ollama, LM Studio, Azure OpenAI, 사내 LLM 서버 등.

Requirements

• Node.js v20+
• npm v10+
• Git (문서/리포 사용 시)

문의

Email: [email protected]

Documentation

• Developer Guide
• Logging System
• Testing Guide
• Roadmap

License

MIT License

GitHub: https://github.com/A2G-Dev-Space/Hanseol