문서 · BoltLynx

빠른 시작

에이전트가 동작을 수행할 컴퓨터 또는 격리 환경을 설정합니다. 하나의 로컬 클라이언트에서 여러 에이전트를 사용할 수 있습니다.

로컬 클라이언트를 설치합니다.
로컬 클라이언트를 시작하고 브라우저에서 페어링 페이지를 확인합니다.
웹 앱을 열고 에이전트를 만들거나 선택합니다.
에이전트가 사용할 수 있는 프로젝트 폴더를 선택합니다.

Windows용 로컬 클라이언트

Windows 런처를 다운로드하세요:

계속 보관할 영구 폴더(예: C:\BoltLynx)를 만들고 ZIP의 모든 파일을 그 폴더에 압축 해제하세요. 포터블 버전이므로 설치 프로그램은 필요하지 않습니다.

ZIP 압축 파일 창에서 boltlynx-desktop.exe를 직접 실행하지 마세요. Windows가 임시 폴더에서 실행할 수 있어 나중에 런처와 로컬 파일을 찾기 어려울 수 있습니다.

압축을 푼 폴더를 열고 boltlynx-desktop.exe를 두 번 클릭하세요.Windows 런처는 로컬 클라이언트를 관리하는 도구이며 에이전트와 대화하는 화면이 아닙니다. 클라이언트를 시작하거나 중지하고 페어링 페이지를 열거나 복사할 때 사용합니다.

초기 데스크톱 버전은 아직 서명되지 않아 Windows에서 Microsoft Defender SmartScreen 경고를 표시할 수 있습니다. 공식 버튼으로 다운로드했다면 More info, Run anyway 순서로 선택하세요.

백신이 Windows 런처를 위협으로 탐지한 경우

로컬 클라이언트는 사용자가 허용한 시스템, 명령 및 파일 작업을 실행할 수 있습니다. 따라서 서명되지 않은 버전은 Trojan:Win32/Sprisky.U!cl 같은 휴리스틱 백신 탐지를 유발할 수 있습니다. 경고를 바로 허용하지 마세요.

먼저 ZIP을 위의 공식 다운로드 버튼에서 받았는지, 탐지된 파일이 실제로 C:\BoltLynx\boltlynx-desktop.exe인지 확인하세요. 출처, 파일 이름 또는 탐지된 파일이 일치하지 않으면 삭제하고 공식 버튼에서 다시 다운로드하세요.
모두 일치하면 Windows 보안 → 바이러스 및 위협 방지 → 보호 기록을 열고 해당 탐지 항목에서 디바이스에서 허용을 선택하세요. 파일이 격리되었다면 복원을 선택하세요. Windows 버전에 따라 명칭이 조금 다를 수 있습니다.
확인된 파일을 Defender가 반복해서 격리하면 바이러스 및 위협 방지 설정 → 설정 관리 → 제외 → 제외 추가 또는 제거를 열고 폴더를 선택한 다음 C:\BoltLynx만 추가하세요.

실시간 보호를 끄거나 다운로드, 전체 사용자 폴더 또는 전체 드라이브를 제외하지 마세요.

Microsoft 안내: 보호 기록 및 폴더 제외.

페어링 후에는 로컬 클라이언트를 백그라운드에서 계속 실행하세요. 웹 앱을 열어 에이전트와 대화하고 사용할 수 있는 프로젝트 폴더를 선택합니다.

업데이트가 있으면 Windows 런처에서 새 로컬 클라이언트를 다운로드할 수 있습니다. 포터블 버전이므로 로컬 파일은 실행 파일을 시작한 폴더 안에 저장됩니다.

Linux 명령줄

로컬 클라이언트를 설치합니다:

curl -fsSL https://boltlynx.com/install.sh | bash

설치 프로그램은 boltlynx 바이너리를 ~/.boltlynx/bin/에 두고 PATH에 추가합니다. 터미널을 다시 시작한 다음 로컬 클라이언트를 시작하세요. 처음 실행하면 명령이 페어링 페이지 링크를 표시합니다. 브라우저에서 열어 확인하면 로컬 클라이언트가 백그라운드에서 계속 실행됩니다. 별도의 페어링 명령은 필요하지 않습니다.

boltlynx start

클라이언트 상태는 언제든 확인할 수 있습니다:

boltlynx status

macOS 명령줄

로컬 클라이언트를 설치합니다:

curl -fsSL https://boltlynx.com/install.sh | bash

boltlynx start

클라이언트 상태는 언제든 확인할 수 있습니다:

boltlynx status

로컬 클라이언트가 실행되고 페어링되면 웹 앱을 열어 에이전트를 만들거나 선택하고, 에이전트가 사용할 수 있는 프로젝트 폴더를 선택합니다.

웹 앱 열기

로컬 클라이언트 업데이트

업데이트 후:

Windows: 런처에서 로컬 클라이언트를 업데이트한 다음 클라이언트 커널을 재시작합니다.
Linux / macOS: 터미널에서 로컬 클라이언트를 재시작합니다.

로컬 클라이언트 재시작

boltlynx restart

핵심 개념

웹 앱

에이전트와 대화하고, 작업을 만들고 관리하며, 다음에 할 일을 결정합니다. 웹 앱은 브라우저에서 실행됩니다.

로컬 클라이언트

클라이언트는 사용자 기기에서 실행됩니다. 승인된 에이전트가 로컬 파일, 명령, 데이터 분석, 코드 검색, 비공개 스킬에 접근할 수 있게 합니다.

클라이언트 하나가 에이전트 하나를 뜻하지는 않습니다. 클라이언트는 기기, 컨테이너 또는 별도 OS 사용자로 격리된 실행 환경입니다. 환경마다 한 번 설치하면 여러 에이전트를 실행할 수 있습니다.

에이전트

에이전트는 대화와 작업 환경을 결합한 것입니다. 대화 기록, 작업 디렉터리, 메모리, 활성화된 스킬, 자체 지침을 가집니다.

스킬

스킬은 에이전트에 도메인 능력을 더합니다. 이 안내서는 소프트웨어 작업을 위한 Code와 운영 및 데이터베이스 안전 규칙을 위한 Ops를 다룹니다.

워커 에이전트

메인 에이전트는 전문 워커 에이전트에게 업무를 위임할 수 있습니다. 각 워커는 자체 모델, 작업 디렉터리, 스킬, 역할을 가질 수 있습니다.

에이전트 설정

각 에이전트를 특정 프로젝트나 업무에 맞게 설정할 수 있습니다.

이름, 설명, 작업 디렉터리	에이전트를 식별하고 작업할 수 있는 루트 폴더를 지정합니다.
스킬	Code나 Ops 같은 도메인 능력을 활성화합니다.
모델	업무에 사용할 모델과 추론 수준을 선택합니다.
파일 권한	허용, 쓰기 가능, 차단할 경로를 설정합니다.
명령 권한	`git *`는 허용하고 파괴적 명령은 차단하는 식으로 패턴을 설정합니다.
지침과 메모리	대화를 넘어 유지되는 장기 업무 규칙과 편집 가능한 메모를 제공합니다.
워커 에이전트	더 큰 업무를 위한 전문 협업 에이전트를 설정합니다.
트리거와 알림	예약 점검, Webhook 기반 워크플로, 완료 및 경고 알림을 설정합니다.

일상 사용

웹 앱을 엽니다.프로젝트를 담당하는 에이전트를 선택하고 대화를 이어가거나 다음 작업을 맡깁니다.
업무를 설명합니다. 단순한 프롬프트가 아니라 실제 작업을 전달합니다.
실행하도록 둡니다. 승인된 환경에서 파일 읽기와 쓰기, 명령 실행, 코드 검색, 데이터 분석을 수행할 수 있습니다.
민감한 작업을 승인합니다. 확인이 필요한 작업은 먼저 사람의 승인을 요청합니다.
알림을 받습니다. 업무 완료, 이상 발생, 예약 작업의 결과를 BoltLynx가 알려 줄 수 있습니다.

안전 모델

BoltLynx는 명확한 경계를 중심으로 설계되었습니다. 에이전트는 사용자가 설정한 디렉터리와 명령 권한 안에서 작업합니다.

파일 접근은 작업 디렉터리와 추가 허용·차단 규칙으로 관리됩니다.
민감한 명령에는 사람의 승인을 요구할 수 있습니다.
비공개 스킬은 서버 도구로 업로드하지 않고 로컬 클라이언트를 통해 실행합니다.
알림으로 완료, 실패, 예약 보고서를 확인할 수 있습니다.

데이터 경계

BoltLynx는 로컬 접근과 데이터 전송을 최소화하도록 설계되었습니다. 워크스페이스 전체를 복제하거나 현재 작업과 무관한 파일을 탐색해 업로드하지 않습니다.

작업 내용은 모델 추론, 작업을 계속하는 데 필요한 액션 결과, 사용자가 선택한 온라인 서비스, 또는 서비스 운영과 보호에 필요한 진단을 위해서만 클라이언트 밖으로 전송됩니다.

로컬 클라이언트를 설치하고 작업을 시작하세요.