CodeConductor: 명령줄 AI 에이전트를 위한 현대적인 데스크톱/웹 UI

명령줄 (command-line) AI 에이전트를 위한 현대적인 데스크톱/웹 UI

사용자 친화적 | 시각적 인터페이스 | 멀티 모델 지원 | 로컬 우선 데이터

AionUI / Anthropic Cowork의 오픈 소스 강화 포크 (fork)

CodeConductor는 뛰어난 AionUI 기반을 바탕으로, 실제 코딩 에이전트 사용을 위한 워크플로 (workflow) 개선 사항을 추가했습니다.

English | 简体中文 | 日本語 | 공식 웹사이트 | Twitter

포지셔닝 · CodeConductor가 할 수 있는 일 · 이 포크 (fork)에서의 개선 사항 · 핵심 기능 · 빠른 시작 · 문서 · 커뮤니티 및 지원

개선 사항: 향상된 메모리 관리를 위해 Mem0 서비스를 ProcessConfig 및 v2 API를 사용하도록 업데이트.
기능: 지속적인 에이전트 메모리를 위한 Mem0 메모리 서비스 통합 추가.
기능: 간소화된 도구 설정을 위한 CLI 설치 관리 구현.
기능: 이미지 생성 도구 통합 도입.
수정: 빌드 및 릴리스 (build-and-release) 워크플로의 태그 처리 로직 업데이트.
기능: 커스텀 어시스턴트 생성 및 관리 기능 추가.
기능: 가이드 (Guid) 페이지에 에이전트 선택 및 분류 기능 추가.
기능: 스킬 삭제 지원 추가.
수정: 시스템 감지 대신 DEFAULT_THEME를 사용하여 테마 초기화.
기타 작업 (Chore): 새로운 리포지토리 (repository) 소유권에 맞춰 About 모달 링크 업데이트.
기타 작업 (Chore): 개선된 설치 프로그램 동작을 위해 electron-builder 설정 업데이트.
대화 상호작용을 개선하기 위해 ActionToolbar 추가.
CLI 모델 리스트 훅 (hook) 및 수동 선택 구성 처리 추가.
더 쉬운 디버깅을 위해 메시지 처리 및 로깅 개선.
시각적 디자인과 메시지 스타일링을 개선하여 채팅 UI 컴포넌트 강화.
워크플로 관리를 위한 가이드형 에이전트 설정 페이지를 포함한 Superpowers 워크플로 (Workflow) 서비스 도입.
풀 리퀘스트 (pull requests) 시 Jira 설명을 자동으로 동기화하기 위한 GitHub Actions 워크플로 추가.
정교해진 메시지 표시 및 상호작용 패턴으로 협업 UI 개선.
포괄적인 설정 및 명령 관리를 포함한 Superpowers 통합 구현.
Superpowers 모드 및 워크플로(workflows) 구성을 위한 전용 설정 페이지 추가.
Superpowers 프레임워크 통합을 통한 프로젝트 워크플로 기능 강화.
latest.yml 메타데이터 파일을 적절히 생성 및 업로드하여 자동 업데이트(auto-updater) 404 오류 수정.
애플리케이션 자동 업데이트를 위한 업데이트 메커니즘 신뢰성 향상.
대화형 프롬프트 및 확인을 위한 내장 도구로 popup-mcp 통합.
다국어 파일을 통한 국제화 (i18n) 지원 추가.
Claude 및 Codex를 위한 CLI 프로바이더(provider) 설정 UI 및 백엔드 서비스 추가.
스토리지 유틸리티 및 사고 과정 표시 (thought display) 컴포넌트 추가.
CLI 프로바이더 설정 내 ANTHROPIC_MODEL의 기본값 수정.
Guid 컴포넌트 내 중복된 모델 설정 호출 수정.
에이전트의 사고(thoughts)를 표시 가능한 채팅 메시지로 더 잘 변환할 수 있도록 ACP 어댑터 강화.
Codex 및 Claude를 위한 프리셋(presets)과 스토리지가 포함된 CLI 프로바이더 설정 구현.
다중 역할 통신 및 알림 메커니즘을 통한 협업 기능 개선.
더 나은 리소스 처리를 위해 프로세스 관리 및 고아 프로세스(orphaned process) 정리 최적화.
안정성 향상을 위한 IPC 통신 메커니즘 강화.
자동 증분 업데이트를 위한 electron-updater 통합 추가.
GitHub Actions 자동화를 통한 빌드 및 릴리스 파이프라인 개선.
CLI 프로바이더 (Claude Code / Codex) 구성을 위한 설정 페이지 추가.
가독성 향상을 위해 접기 가능한 도구 메시지 배치(tool message batches)를 포함한 CollabChat 뷰 및 MessageList 추가.
터미널 및 프로세스 처리 개선 (PTY 기반 터미널 관리, 에이전트-브라우저 명령 실행, 워커 프로세스 관리).
문서 링크/주소 수정 및 포크(fork) 위치 명확화; Contributor Covenant 행동 강령(Code of Conduct) 추가.
SendBox 컴포넌트에 멘션(mention) 지원 추가 (멘션 옵션, 키보드 네비게이션, 협업 통합).
UI/UX 스타일링 및 테마 일관성 개선 (입력창, 버튼, 모달, 메시지 시각화).
agent-browser를 통한 브라우저 자동화 기능 강화 (IPC 지원 및 슬래시 명령어(slash command) 입력).
빌드/문서/설정(build/docs/config) 템플릿 및 협업 역할 가이드라인 업데이트.

이 저장소는 CodeConductor의 강화된 포크(fork) 버전입니다. 기존의 목표(명령줄 AI 에이전트를 위한 현대적인 UI)를 유지하면서,

AI 도구를 원격으로 제어하세요 - 네트워크상의 어떤 기기에서도 CodeConductor에 접속할 수 있습니다! 로컬의 Claude Code, Codex 및 기타 도구들을 안전하게 제어하며, 데이터는 절대 사용자의 기기를 떠나지 않습니다.

# 기본 시작
CodeConductor --webui
# 원격 접속 (로컬 네트워크의 다른 기기에서 접속 가능)
...

모든 플랫폼에 대한 전체 시작 지침은 WEBUI_GUIDE.md를 참조하세요.

이 포크(fork) 버전은 명령줄 코딩 에이전트(command-line coding agents)를 실제 프로젝트와 일상 업무에서 더 쉽게 사용할 수 있도록 만드는 데 집중합니다:

다중 역할 협업 뷰 (PM/분석가/엔지니어)- 하나의 프로젝트 대화 내에서 구조화된 협업을 가능하게 합니다.
명시적 승인을 통한 더 안전한 고영향 작업- 명령 실행 또는 변경 사항 적용과 같은 작업에 대해 더 명확한 확인 절차와 시각적 신호를 제공합니다.
더 빠른 프로젝트 워크플로우를 위한 슬래시 명령어 (Slash commands)- 프로젝트 채팅 내의 일반적인 작업들을 위해 발견 가능하고 재사용 가능한 단축키를 제공합니다.
워크스페이스 컨텍스트를 포함한 프로젝트 우선 대화- 워크스페이스 컨텍스트(workspace context)를 갖춘, 작업 중심 및 아티팩트(artifact) 지향적인 프로젝트 세션을 제공합니다.
리뷰 친화적인 워크플로우- 리뷰 마찰을 줄이기 위해 미리보기(preview)와 차이점(diff)을 일급 시민(first-class citizens)으로 취급합니다.

멀티 세션 + 독립적 컨텍스트- 여러 채팅을 동시에 열 수 있으며, 각 세션은 독립적인 컨텍스트 메모리를 가져 혼선이 없습니다.
로컬 저장소- 모든 대화는 로컬에 저장되며 유실되지 않습니다.

멀티 플랫폼 지원- Gemini, OpenAI, Claude, Qwen과 같은 주요 모델을 지원하며 유연한 전환이 가능합니다.
로컬 모델 지원- Ollama, LM Studio와 같은 로컬 모델 배포를 지원합니다. Custom 플랫폼을 선택하고 로컬 API 주소(예: http://localhost:11434/v1)를 설정하세요.

파일 트리 브라우징 + 드래그 앤 드롭 업로드- 폴더처럼 파일을 탐색할 수 있으며, 파일이나 폴더를 드래그 앤 드롭하여 클릭 한 번으로 가져오기를 지원합니다.
스마트 정리- AI가 폴더 정리를 돕도록 할 수 있으며, 자동 분류 기능을 제공합니다.

9가지 이상의 형식 미리보기 (Format Preview)- PDF, Word, Excel, PPT, 코드, Markdown, 이미지 등을 지원하며, AI 생성 직후 결과를 즉시 확인할 수 있습니다.
실시간 추적 + 편집 가능 (Real-time Tracking + Editable)- 파일 변경 사항을 자동으로 추적하며, Markdown, 코드, HTML의 실시간 편집 및 디버깅을 지원합니다.

지능형 이미지 생성 (Intelligent Image Generation)- Gemini 2.5 Flash Image Preview, Nano, Banana와 같은 다양한 이미지 생성 모델을 지원합니다.
이미지 인식 및 편집 (Image Recognition & Editing)- AI 기반의 이미지 분석 및 편집 기능을 제공합니다.

교차 기기 접속 (Cross-Device Access)- 브라우저를 통해 네트워크상의 모든 기기에서 접속할 수 있으며, 모바일 기기를 지원합니다.
로컬 데이터 보안 (Local Data Security)- 모든 데이터는 SQLite 데이터베이스에 로컬로 저장되어 서버 배포에 적합합니다.

자신만의 CSS 코드로 커스터마이징하여 인터페이스를 취향에 맞게 설정하세요.

완전한 커스터마이징 가능 (Fully Customizable)- CSS 코드를 통해 인터페이스 색상, 스타일, 레이아웃을 자유롭게 커스터마이징하여 독자적인 경험을 구축할 수 있습니다.

WebUI 시작 가이드:
WEBUI_GUIDE.md
프로젝트 개요 및 아키텍처 노트:
CLAUDE.md
코드 스타일 및 컨벤션:
CODE_STYLE.md

macOS: 10.15 이상
Windows: Windows 10 이상
Linux: Ubuntu 18.04+ / Debian 10+ / Fedora 32+
메모리 (Memory): 4GB 이상 권장
저장 공간 (Storage): 최소 500MB 이상의 여유 공간

CodeConductor 애플리케이션을 다운로드하고 설치합니다.
설정(Settings)에서 AI 제공업체를 구성합니다 (제공업체에 따라 Google 계정 로그인 또는 API Key 사용).
대화를 시작하고 프로젝트 워크스페이스에서 작업을 진행합니다.

npm install
npm start

npm run webui
npm run webui:remote

여러분의 아이디어와 피드백을 환영합니다. 아이디어는 Discussions를, 버그 또는 기능 요청은 Issues를 사용해 주세요.

GitHub Discussions: https://github.com/zhu1090093659/CodeConductor/discussions
Issues: https://github.com/zhu1090093659/CodeConductor/issues
Releases: https://github.com/zhu1090093659/CodeConductor/releases

Issues와 Pull Request 제출을 환영합니다!

이 프로젝트를 Fork 하세요.
기능 브랜치를 생성하세요 (
git checkout -b feature/AmazingFeature

) - 변경 사항을 커밋(Commit)하세요 (
git commit -m 'Add some AmazingFeature'

) - 브랜치로 푸시(Push)하세요 (
git push origin feature/AmazingFeature

) - 풀 리퀘스트(Pull Request)를 생성하세요

이 프로젝트는 Apache-2.0 라이선스 하에 배포됩니다.

CodeConductor에 기여해주신 모든 개발자분께 감사드립니다!

CodeConductor: 명령줄 AI 에이전트를 위한 현대적인 데스크톱/웹 UI

요약

핵심 포인트

댓글