Airgap Assistant | Airgap Studio

개요

AIRGAP Assistant는 로컬 AI 엔진(Qwen3:8b) 기반 코딩 어시스턴트입니다. 파일 생성·편집, 터미널 명령 실행, 멀티파일 리팩토링까지 AI가 직접 수행합니다. 인라인 코드 자동완성(Autocomplete)이 내장되어 추가 VRAM 없이 19개 언어에서 실시간 코드 제안을 받을 수 있습니다.

채팅 인터페이스

Activity Bar의 Assistant 아이콘을 클릭하여 채팅 패널을 엽니다.

코드 생성 및 편집

자연어로 코드 작업을 요청합니다. AI가 파일을 직접 생성하고 편집합니다.

"handleSubmit 함수에 null 체크를 추가해줘"
"새로운 UserProfile 컴포넌트를 만들어줘"
"이 함수를 TypeScript로 변환해줘"

파일 생성

AI가 새로운 파일을 생성할 수 있습니다. 프로젝트 구조에 맞게 적절한 경로에 파일을 만듭니다.

터미널 명령

터미널 명령어 실행을 요청하면 AI가 명령을 생성하고 실행합니다.

"현재 프로젝트의 의존성을 설치해줘"
"TypeScript 컴파일 오류를 확인해줘"

Diff 미리보기

AI가 파일을 수정할 때 변경 사항을 Diff 형식으로 미리 보여줍니다.

승인 — 변경 사항을 파일에 적용
거부 — 변경 사항을 취소

Auto-approve가 기본으로 활성화되어 있어, 파일 읽기/쓰기가 자동 승인됩니다. 망분리 환경에서는 네트워크 격리로 안전이 보장됩니다. 설정에서 변경할 수 있습니다.

인라인 코드 자동완성

코드를 입력하는 동안 AI가 실시간으로 코드 완성을 제안합니다.

지원 언어

JavaScript, TypeScript, Python, Java, C, C++, C#, Go, Rust, HTML, CSS, SQL, PHP, Ruby, Swift, Kotlin, Dart, Shell, Lua — 총 19개 언어를 지원합니다.

동작 방식

항목	값
디바운스	300ms
타임아웃	3초
캐시	LRU 50 엔트리
추가 VRAM	0 (기존 Qwen3:8b 인스턴스 공유)

상태바에서 자동완성 상태를 실시간으로 확인할 수 있습니다: 준비 · 처리 중 · 오프라인

슬래시 커맨드

대화창에서 슬래시(/)로 시작하는 명령을 사용할 수 있습니다.

커맨드	설명
`/newtask`	새 작업 시작, 대화 맥락 초기화
`/smol`	간결 모드, 짧은 응답
`/newrule`	프로젝트 규칙 추가
`/deep-planning`	심층 계획 수립
`/explain-changes`	변경사항 상세 설명

프로젝트 규칙

프로젝트 루트에 .airgaprules 파일을 생성하여 AI의 행동 규칙을 정의할 수 있습니다. 코딩 컨벤션, 금지 패턴, 응답 형식 등을 자연어로 작성하면 AI가 이를 준수합니다.

# .airgaprules 예시
- TypeScript를 사용한다. JavaScript 파일을 생성하지 않는다.
- 외부 CDN 링크를 사용하지 않는다.
- 주석은 한국어로 작성한다.

자세한 내용은 Rules (규칙) 문서를 참고하세요.

커스텀 워크플로우

.airgapworkflows/ 디렉터리에 반복적인 작업 단계를 자동화 체인으로 정의할 수 있습니다.

자세한 내용은 Workflows (워크플로우) 문서를 참고하세요.

Auto Compact

대화가 길어지면 컨텍스트 창이 부족해질 수 있습니다. Auto Compact 기능이 기본으로 활성화되어 있어 자동으로 대화를 요약하고 맥락을 유지합니다.

프로바이더 설정

기본 로컬 AI(Qwen3:8b) 외에 Anthropic, OpenAI, Google Gemini 등 외부 프로바이더로 전환할 수 있습니다. 네트워크가 허용되는 환경에서만 사용 가능합니다.

자세한 내용은 프로바이더 설정 문서를 참고하세요.

한국어 인터페이스

UI와 AI 응답 모두 한국어를 기본으로 제공합니다. 슬래시 커맨드, 상태 메시지, 오류 안내 등이 한국어로 표시됩니다.

개요