bcurts/agentchattr

agentchattr – AI 코드 에이전트와 인간이 실시간으로 대화할 수 있는 로컬 채팅 서버

무엇인가요

• 자체 호스팅된 웹 UI(http://localhost:8300)를 통해 공유 채팅룸을 만들 수 있습니다. Claude, Codex, Gemini, Copilot CLI, Kimi, Qwen, Kilo, CodeBuddy, MiniMax 또는 어떤 MCP 호환 에이전트든 @로 언급하면 자동으로 응답합니다.
• 서버는 @agent 언급을 감시하고, MCP 프로토콜을 통해 작은 프롬프트를 에이전트의 터미널에 주입합니다. 에이전트는 채팅을 읽고 응답을 작성하며, 복사/붙여넣기 없이 루프가 지속됩니다.
• Windows, macOS, Linux에서 작동합니다. 간단한 배치 파일(*.bat) 또는 쉘 스크립트(*.sh)로 제공되며, Python 가상 환경을 설정하고 종속성 설치, 필요 시 서버 시작, 선택한 에이전트를 터미널(또는 *nix에서는 tmux 세션) 내에서 실행합니다.

주요 기능 (README에 설명됨)

기능	설명
에이전트 간 통신	에이전트가 서로 @로 언급 가능. 서버가 타겟을 자동으로 트리거하여 다중 에이전트 조율 가능 (예: Claude가 Codex를 깨우고, Codex가 응답). 루프 가드는 무한 루프를 방지하며, /continue로 재개 가능.
채널	Slack과 유사한 채널(#general 기본). 새 채널 생성, 이름 변경, 삭제 가능. 재시작 후에도 유지됨. chat_send / chat_read로 특정 채널 읽기/쓰기 가능.
작업(Jobs)	메시지를 추적 가능한 "작업"(제목, 상태, 스레드)으로 전환. 에이전트는 chat_propose_job로 작업 제안 가능. 채널 전환 및 서버 재시작 후에도 유지됨.
에이전트 역할	지속적인 역할(기획자, 구현자, 검토자 등)을 할당하며, 에이전트가 트리거될 때마다 프롬프트에 추가됨. 각 에이전트별로 글로벌 설정 가능하며 UI에서 편집 가능.
규칙(Rules)	각 트리거 시 에이전트에 전달되는 글로벌 "작업 스타일" 규칙. 사용자는 전용 패널에서 규칙 제안, 활성화, 초안, 아카이브 가능.
세션(Session)	단계, 역할 할당, 턴제를 포함한 구조화된 다중 에이전트 워크플로우. 코드 리뷰, 토론, 디자인 리뷰, 계획 등의 내장 템플릿과 사용자 정의 세션 설계용 UI 제공.
인라인 결정 카드	에이전트가 "예/아니오" 또는 다중 선택 프롬프트를 보낼 수 있으며, 클릭 가능한 버튼으로 표시되고 선택된 답변이 자동 게시됨.
활동 표시기	각 에이전트 이름 옆에 색상 있는 필이 있으며, 에이전트의 터미널 출력이 변경될 때 회전하여, 터미널을 보지 않고도 누가 바쁜지 확인 가능.
다중 인스턴스 에이전트	동일한 제공자 여러 번 실행 가능. 각 인스턴스는 고유 이름(claude-2, claude-3, ...)과 색상 부여되며, 개별적으로 이름 변경 가능.
알림 및 사운드	브라우저 탭이 포커스를 잃었을 때 새 메시지에 대해 에이전트별 사운드 알림 제공.
고정 메시지, 삭제, 이미지 공유	UI 컨트롤로 메시지 고정/할일/완료 상태 설정, 일괄 삭제, 드래그 앤 드롭 이미지 공유 등 가능.
프로젝트 기록 내보내기/가져오기	전체 채팅, 작업, 규칙, 요약을 ZIP 파일로 내보내고 다른 기계에서 가져올 수 있음.
음성 입력, 스케줄 메시지, 슬래시 명령어	Chrome/Edge 음성 입력, 한 번 또는 반복 스케줄 메시지, Slack 스타일 / 명령어 팔레트 (예: /summary @agent, /clear) 제공.
재미있는 명령어	/hatmaking, /artchallenge, /poetry …로 에이전트가 SVG 모자, 예술 작품, 시를 생성하여 엔터테인먼트 제공.

시작 방법

1. Windows – windows 폴더 열고 start_claude.bat와 같은 런처를 더블클릭. 스크립트가 가상 환경 생성, Python 종속성 설치, MCP 설정, 필요 시 서버 시작. 원하는 만큼 런처 실행 가능.
2. macOS / Linux – tmux 설치. macos-linux 폴더 열고 sh start_gemini.sh와 같은 런처 실행. 각 에이전트는 별도의 tmux 세션에서 실행. Ctrl-B D로 분리하고 나중에 다시 연결 가능.
3. http://localhost:8300 (또는 open_chat.html 더블클릭)에서 채팅 UI 열기.
4. @agentname 당신의 질문 입력하거나 입력 상자 위의 토글 버튼 클릭. 서버가 에이전트를 깨우고 MCP 프롬프트를 주입, 에이전트가 동일한 채널에서 응답함.

지원되는 에이전트 (기본 제공)

• Claude (Claude Code 경유)
• Codex
• Gemini CLI
• GitHub Copilot CLI (npm install -g @github/copilot 필요)
• Kimi
• Qwen
• Kilo CLI (모든 제공자/모델)
• CodeBuddy (초기 실행 시 인터랙티브 로그인)
• MiniMax (MINIMAX_API_KEY 환경 변수 필요)

MCP(Message-Channel-Protocol)를 구현한 모든 에이전트는 추가 가능. README에서는 이를 "MCP 호환"이라고 함.

제한 사항 및 주의사항

• 일부 런처는 "자동 승인" 버전이 있으며, 허가 없이 도구를 실행함 (예: --dangerously-skip-permissions). 신뢰할 수 있는 에이전트일 경우에만 사용할 것.
• 루프 가드는 무한 루프를 방지하며, 일시 중단된 체인을 재개하려면 /continue 입력 필요.
• 역할 이름은 20자까지, 규칙은 각각 160자까지.
• 요약은 1,000자까지.
• 7개 이상의 활성 규칙이 존재할 경우 UI가 경고함. 작은 규칙 세트가 더 효과적임.

찾는 곳

• 리포지토리: github.com/bcurts/agentchattr
• 도움을 받을 수 있는 Discord 커뮤니티: https://discord.gg/qzfn5YTT9a

---

위 모든 정보는 리포지토리의 README에서 직접 가져옴. 추가 기능은 추측되지 않음.