문서 · BoltLynx

빠른 시작

BoltLynx가 작업할 환경에 맞는 클라이언트를 선택하세요. 하나의 클라이언트에서 여러 에이전트를 실행할 수 있습니다.

Windows 포터블 데스크톱

Windows 데스크톱 런처를 다운로드하세요:

관리할 수 있는 폴더에 압축을 풉니다. 포터블 버전이므로 설치 프로그램은 필요하지 않습니다.

boltlynx-desktop.exe를 더블클릭합니다. 데스크톱 앱은 로컬 클라이언트를 위한 작은 런처입니다. 클라이언트를 시작하거나 중지하고, 페어링 URL을 표시하거나 브라우저에서 열고 복사할 수 있습니다.

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

페어링이 끝나면 브라우저에서 BoltLynx를 계속 사용하고, 에이전트가 작업하도록 허용할 프로젝트 폴더를 선택합니다.

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

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

브라우저에서 BoltLynx에 로그인하고, 에이전트를 만든 뒤 작업을 허용할 프로젝트 폴더를 선택하세요.

BoltLynx 로그인

핵심 개념

에이전트

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

로컬 클라이언트

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

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

스킬

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

워커 에이전트

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

에이전트 설정

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

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

일상 사용

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

안전 모델

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

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

클라이언트를 설치하고 실제 업무를 실행하세요.