명령줄 (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에 기여해주신 모든 개발자분께 감사드립니다!