에이전트와 함께 일하는 데스크톱 환경
Linear나 Gmail 같은 외부 서비스와 에이전트를 연결할 때 설정 파일을 직접 수정하거나 복잡한 위자드를 거치지 않아도 됩니다. 에이전트에게 'Linear를 소스로 추가해 줘'라고 말하면 에이전트가 공개 API와 문서를 찾아 자격 증명을 설정하고 모든 것을 구성합니다. Craft Agents는 문서 중심의 워크플로우를 지향하며, 코드를 직접 작성하지 않고 프롬프트만으로 에이전트의 동작을 제어할 수 있는 데스크톱 애플리케이션입니다.
설치와 초기 실행
macOS와 Linux에서는 단 한 줄의 커맨드로 앱을 설치할 수 있습니다. Windows에서는 PowerShell을 통해 동일한 설치가 가능합니다. 설치 후 앱을 실행하면 Anthropic API 키나 Claude Max, Google AI Studio, ChatGPT Plus, GitHub Copilot 중 하나를 선택해 연결합니다. 워크스페이스를 생성하고 필요한 소스를 연결한 뒤 채팅을 시작하면 됩니다. 소스코드에서 빌드하려면 bun install과 bun run electron:start 명령을 사용합니다.
에이전트 네이티브 워크플로우
이 도구의 핵심은 사용자가 원하는 결과를 설명하면 에이전트가 실행 방법을 찾아내는 것입니다. MCP 서버, REST API, 로컬 파일 시스템 등 다양한 소스를 연결할 때 설정 파일 없이 에이전트가 자동으로 처리합니다. Claude Code에서 사용하던 스킬이나 MCP 설정도 에이전트에게 이관을 요청하면 자동으로 가져옵니다. 새로운 스킬을 만들 때도 기능을 설명하고 컨텍스트를 주면 에이전트가 나머지를 처리하며, 변경 사항은 즉시 반영되어 재시작이 필요하지 않습니다.
세션 관리와 권한 제어
세션은 인박스, 아카이브, 플래깅을 통해 워크플로우 상태에 따라 정리됩니다. 상태는 '할 일', '진행 중', '검토 필요', '완료' 등으로 커스터마이징할 수 있습니다. 권한 모드는 '탐색', '편집 승인', '자동' 세 단계로 나뉘며, SHIFT+TAB 키로 채팅 중에도 전환할 수 있습니다. '탐색' 모드는 읽기 전용으로 모든 쓰기 작업을 차단하고, '편집 승인'은 기본값으로 쓰기 전에 승인을 요청합니다. '자동' 모드는 모든 명령을 자동으로 승인합니다.
원격 서버와 CLI 클라이언트
Craft Agents는 헤드리스 서버로 실행되어 원격 머신에서 장시간 세션을 유지하거나 여러 기기에서 접근할 수 있습니다. 데스크톱 앱은 얇은 클라이언트로 동작하며, 세션 로직과 도구 실행, LLM 호출은 원격 서버에서 처리됩니다. 터미널에서 사용하는 CLI 클라이언트는 스크립팅이나 CI/CD 파이프라인에 활용할 수 있으며, run 명령은 서버를 생성하고 프롬프트를 실행한 후 종료되는 자체 포함형 동작을 지원합니다. 네트워크 노출 시에는 TLS 인증서를 설정해 WebSocket 연결을 암호화하는 것이 권장됩니다.
사용 전 확인 사항
이 프로젝트는 Apache 2.0 라이선스로 공개되어 자유롭게 수정하고 재사용할 수 있습니다. 다만 Claude Agent SDK를 사용하므로 Anthropic의 상업적 서비스 약관이 적용됩니다. Google 서비스 연동 시에는 Google Cloud 프로젝트에서 자체 OAuth 자격 증명을 생성하고 설정해야 하며, Slack과 Microsoft는 빌드 시 자격 증명을 포함해야 합니다. 로컬 MCP 서버 실행 시 민감한 환경 변수는 자동으로 필터링되어 자격 증명 유출을 방지합니다. 원격 서버를 네트워크에 노출할 때는 반드시 TLS를 설정하고, 프로덕션 환경에서는 신뢰할 수 있는 CA 인증서를 사용하거나 리버스 프록시 뒤에서 실행해야 합니다.