이 문서는 9c65bad 기준 README.md의 기계 번역본입니다. 정본은 영어 버전입니다.

Kangentic

카드를 끌어다 놓으면 에이전트가 시작됩니다.
AI 코딩 에이전트를 위한 에이전틱 개발 환경입니다.

라이브 데모 | 빠른 시작 | 문서

English | 中文(简体) | 中文(繁體) | Français | Deutsch | Italiano | Español | 日本語 | 한국어 | Русский | Português (Brasil) | Türkçe | Polski | Čeština | Magyar

기능 소개

코딩 에이전트는 작업 하나를 혼자서 처리할 수 있고, Git 작업 트리를 사용하면 여러 에이전트를 동시에 실행할 수 있습니다. 그러면 한계는 사용자 쪽에 생깁니다. 어떤 에이전트가 프롬프트를 기다리는지, 어떤 에이전트가 끝났는지, 각 분기가 어디로 갔는지 파악해야 합니다. Kangentic은 모든 세션을 하나의 보드에 모으고 사용자가 필요한 세션을 표시합니다.

하나의 보드에서 에이전트 실행

• 하나의 보드, 모든 에이전트. 각 카드에는 모델, 컨텍스트 창 사용량, 에이전트의 마지막 메시지가 표시되며, 사용자가 필요한 카드에는 표시가 붙습니다.
• Kangentic Mobile. 휴대폰을 한 번 페어링하면 자리를 비운 동안에도 에이전트를 확인하고, 에이전트가 멈춘 질문에 답하고, diff를 검토할 수 있습니다. 연결은 Kangentic의 릴레이 또는 직접 호스팅하는 릴레이를 통해 종단 간 암호화됩니다. App Store 또는 Google Play에서 받으세요.
• 15가지 에이전트 CLI. Claude Code로 계획하고 Codex로 구현하거나, 하나의 CLI를 모든 곳에 사용할 수 있습니다. Kangentic은 이미 가지고 있는 CLI를 이미 구성한 자격 증명으로 실행합니다. API 키도, 프록시도, Kangentic 계정도 필요 없습니다.
• 모든 프로젝트를 한곳에서. 각 리포지토리에 자체 보드가 제공되며, 에이전트 모니터에는 모든 리포지토리에서 실행 중인 에이전트가 표시됩니다.
• 보드에서 검토. 변경 내용 패널에는 각 작업의 diff와 커밋 기록이 표시됩니다. GitHub 또는 Azure DevOps의 연결된 끌어오기 요청에는 상태와 병합 준비 여부가 표시됩니다.
• 무료 오픈 소스. AGPL-3.0 라이선스로 제공되며, 모든 기능이 포함되어 있고 유료 요금제가 없습니다.

워크플로 구성

• 열. 보드가 제품을 출시하는 방식과 일치할 때까지 열의 이름을 바꾸고, 열을 추가하고, 다시 연결합니다. 각 열에는 고유한 에이전트, 모델, 노력 수준, 권한 모드가 있습니다. 이 설정은 kangentic.json으로 리포지토리와 함께 커밋되므로 팀원도 같은 보드를 사용하며, 작업과 에이전트 세션은 각자의 컴퓨터에 유지됩니다.
• 자동화. 작업이 열에 들어올 때, 에이전트가 턴을 마칠 때, 작업이 열을 떠날 때 열에서 에이전트에게 메시지나 슬래시 명령을 보내거나, 스크립트를 실행하거나, 웹후크를 호출하거나, 사용자에게 알리거나, 작업을 다음 열로 이동할 수 있습니다. 일상적인 말로 작성한 조건을 에이전트가 확인하여 단계의 실행 여부를 결정합니다.
• 워크플로. 워크플로 에이전트에게 개요를 전달하고, 에이전트가 계획한 연결된 작업을 검토한 다음 시작을 누릅니다. 각 작업은 기다리는 작업이 완료에 도달하면 시작되며, 하나의 워크플로가 여러 프로젝트에 걸칠 수 있습니다.
• 보드를 다루는 에이전트. Kangentic의 MCP 서버를 사용하면 실행 중인 에이전트가 작업을 만들고, 자신의 카드를 이동하고, 이전 대화를 검색하고, 다른 작업의 에이전트에게 메시지를 보낼 수 있으므로 프롬프트에 작성한 규칙으로 작업을 진행시킬 수 있습니다.

나에게 맞는 도구인가요?

다음에 해당한다면 잘 맞습니다.

• 여러 코딩 에이전트를 동시에 실행하면서 어떤 에이전트가 나를 기다리는지 놓치곤 합니다.
• 여러 프로젝트나 클라이언트의 작업을 오가며 모든 에이전트를 한 화면에서 보고 싶습니다.
• 이미 결제 중인 요금제로 Claude Code, Codex, 기타 CLI를 함께 사용하고 싶습니다.
• 여러 단계로 이루어진 워크플로가 있고 프로젝트별로 에이전트와 자동화를 사용자 지정하고 싶습니다.
• 자리를 비웠을 때 휴대폰으로 에이전트에게 답하고 싶습니다.

다음에 해당한다면 맞지 않을 수 있습니다.

• 한 번에 하나의 작업을 처음부터 끝까지 진행하는 방식을 선호합니다.
• 단일 프로젝트에서 작업하며 전환할 일이 거의 없습니다.
• 에이전트 CLI를 사용하지 않거나 Cursor 또는 Claude Desktop 같은 앱을 선호합니다.
• 개발 과정에서 워크플로나 자동화가 필요하지 않습니다.
• 에이전트를 내 컴퓨터가 아닌 클라우드에서 실행하고 싶습니다.

유용해 보인다면 ⭐를 눌러 주세요. 다른 개발자가 Kangentic을 찾는 데 도움이 됩니다.

설치

npx kangentic

이 명령은 사용 중인 플랫폼에 맞는 최신 릴리스를 GitHub 릴리스에서 다운로드하여 설치하고 엽니다. 이후에는 앱이 자동으로 업데이트됩니다. 설치 프로그램을 직접 실행하려면 릴리스 페이지에서도 받을 수 있습니다.

요구 사항

• Windows x64, Apple Silicon 또는 Intel 기반 macOS 13 이상, 또는 Linux x64나 arm64(.deb 또는 .rpm). Intel Mac에서는 지식 그래프를 사용할 수 없습니다.
• npx를 위한 Node.js 20 이상과 Git 2.26 이상.
• 설치하고 로그인한 지원되는 에이전트 CLI 하나 이상.

WSL 사용자는 Windows 버전을 설치하고 WSL 배포판을 터미널 셸로 선택할 수 있습니다. 에이전트는 각 CLI의 Windows 설치본을 실행하므로 배포판 안에만 설치된 CLI는 찾을 수 없습니다. 플랫폼별 내용은 설치 가이드를 참조하세요.

작동 방식

1. 보드를 구성합니다. 기본 열을 그대로 쓰거나 원하는 대로 바꾸고, 각 열에서 실행할 에이전트와 권한 모드를 선택합니다.
2. 작업을 만듭니다. 제목과 프롬프트를 입력하거나 GitHub Issues, GitHub Projects, Azure DevOps, Asana에서 작업을 가져옵니다.
3. 끌어서 실행합니다. Kangentic이 작업 트리를 만들고, 열의 권한 모드를 적용하고, 에이전트를 시작합니다.
4. 코딩 과정을 지켜봅니다. 실시간 터미널에서 에이전트를 따라가고, 에이전트가 물으면 답하고, 작업이 끝나면 카드를 다음 열로 끌어다 놓습니다.

지원되는 에이전트

Claude Code, Codex CLI, Gemini CLI, Cursor CLI, GitHub Copilot CLI, Grok Build, Antigravity CLI, Goose CLI, OpenCode, Aider, Qwen Code, Kimi Code, Factory Droid, Warp (Oz CLI), 그리고 로컬 모델을 단일 턴 채팅으로 실행하는 Ollama.

다시 시작한 후 재개, MCP 보드 도구, 다음 에이전트로 기록 전달은 CLI에 따라 지원 여부가 다릅니다. 에이전트별 지원 기능을 참조하세요.

언어

Kangentic 인터페이스는 이 페이지 상단에 나열된 각 언어로 제공됩니다. Settings > Language에서 변경하면 Kangentic이 해당 언어로 다시 시작됩니다. 번역은 기계 번역이며 검토할 수 있도록 열려 있습니다. 번역을 수정하는 방법은 번역에서 설명합니다.

데이터 및 개인정보

보드, 작업, 대화 기록은 로컬 SQLite 데이터베이스에 저장됩니다. 에이전트 CLI는 터미널에서 실행할 때와 마찬가지로 사용자의 계정으로 각 공급자에 연결합니다.

릴리스 빌드는 기본적으로 익명 사용 이벤트(Aptabase)와 오류 보고서(Sentry)를 전송합니다. 사용 이벤트에는 작업 텍스트, 프롬프트, 코드가 절대 포함되지 않습니다. 둘 다 끄려면 KANGENTIC_TELEMETRY=0을 설정하고, 오류 보고서만 끄려면 KANGENTIC_ERROR_REPORTING=0을 설정합니다. 앱 내 설정은 없습니다. 앱은 업데이트와 공지 사항도 GitHub에서 확인합니다. 전체 목록은 개인정보 처리방침을 참조하세요.

문서

빠른 시작부터 읽은 다음, 열, 자동화, 워크플로, MCP 서버, 구성에 대해서는 문서를 참조하세요.

개발

소스에서 빌드하려면 Node.js 22.14 이상 또는 24 이상이 필요합니다.

git clone https://github.com/Kangentic/kangentic.git
cd kangentic
npm install
npm start

기여

프로젝트 구조, 테스트, 규칙은 CONTRIBUTING.md를 참조하세요. 기여자는 첫 번째 끌어오기 요청이 병합되기 전에 CLA에 서명합니다.

지원

• 질문과 기능 요청은 GitHub Discussions
• 버그 보고는 GitHub Issues
• 공개적으로 게시하고 싶지 않다면 [email protected]

보안 문제를 보고하려면 SECURITY.md를 참조하세요.

라이선스

AGPL-3.0. 상용 라이선스는 [email protected]으로 이메일을 보내 주세요.