stablyai/agent-slack

해결하는 문제

agent-slack는 AI 에이전트가 Slack과 상호작용할 수 있도록 전용으로 설계된 CLI 도구입니다. 복잡한 API 설정이나 Python 종속성 없이도 에이전트가 Slack 통신을 읽고, 쓰고, 관리할 수 있도록, 토큰 효율적이고, 인증이 간편하며, 안전한 방법을 제공합니다.

작동 방식

이 도구는 TypeScript와 Bun으로 구축되어 있으며, 에이전트가 Slack 작업을 수행할 수 있는 명령어 세트를 제공합니다. 세 가지 핵심 원칙에 집중합니다:

• 토큰 효율성: LLM의 비용과 토큰 사용량을 줄이기 위해 null 및 빈 필드를 적극적으로 제거한 JSON을 출력합니다.
• 제로 구성 인증: macOS 및 Windows의 Slack 데스크톱 앱 또는 지원되는 브라우저(Chrome, Brave, Firefox)에서 인증 토큰을 자동으로 추출하여 수동 토큰 관리의 부담을 제거합니다.
• 인간이 개입하는 방식: send, edit, delete 작업을 브라우저 기반 에디터나 하위 문서로 리디렉션하는 "세이프 모드"를 포함하여, 인간의 검토 없이 메시지가 게시되지 않도록 보장합니다.

대상 사용자

Claude Code, Codex, Cursor 등의 프레임워크를 사용하여 AI 에이전트를 개발하는 개발자로, 에이전트가 Slack 채널에 읽기/쓰기 가능하고, 스레드를 관리하며, 워크스페이스 내에서 정보를 검색할 수 있어야 하는 경우.

주요 기능

• 포괄적인 Slack 제어: 메시지 읽기, 스레드 목록 조회, 메시지/파일 검색, 채널 생성, Markdown 형식의 Slack 캔버스 관리 지원.
• 에이전트 친화적 아티팩트: 첨부 파일(스니펫, 이미지)을 자동으로 로컬 경로에 다운로드하여 에이전트가 직접 읽을 수 있도록 합니다.
• 스마트한 작성: 번호 매기기/글머리 기호 목록을 네이티브 Slack 리치 텍스트로 변환하고, Block Kit를 지원하여 구조화된 레이아웃을 제공합니다.
• 네이티브 하위 문서: 사용자의 Slack 클라이언트에서 여러 기기 간에 표시되는 Slack 네이티브 하위 문서를 생성하고 업데이트할 수 있습니다.
• 세이프 모드: 에이전트가 Slack에 직접 게시하는 것을 방지하는 강제적인 도구 수준 보장으로, 대신 하위 문서나 브라우저 에디터로 리디렉션됩니다.