wk42worldworld/cybercode
整合 Claude Code 编程能力与 Hermes Agent 自进化能力的智能体 / An AI agent combining Claude Code coding capabilities with Hermes Agent self-evolution.
CyberCode – 로컬에서 실행되는 클라우드 스타일의 코딩 어시스턴트
무엇인가요 – CyberCode는 Claude Code 상호작용 모델을 기반으로 한 오픈소스 AI 에이전트 플랫폼입니다. 귀하의 머신에서 완전히 실행되며, Anthropic 호환 API(예: MiniMax, OpenRouter 등)와 통신 가능하며, 단순한 채팅을 훨씬 넘어서는 기능을 제공합니다.
| 기능 | 제공되는 기능 |
|---|---|
| 영구 메모리 및 자가 진화 | 과거 프로젝트를 기억하고, 안정적인 "스킬"을 추출하여 편집하거나 삭제할 수 있습니다. |
| 다중 모달 UI | 전체 화면 TUI(Ink), 크로스플랫폼 데스크톱 GUI(Tauri + React), 그리고 Telegram, Feishu(또는 Discord)를 통한 원격 제어. |
| 컴퓨터 사용 | macOS 또는 Windows GUI를 제어하고, 터미널 명령어 실행, 파일 편집, Git worktree 관리가 가능합니다. |
| 모델 독립성 | Anthropic 호환 엔드포인트, OpenAI 호환 서비스, 또는 로컬 모델을 자유롭게 연결할 수 있습니다. 모델 라우팅, 상태 체크, 로컬 WebSearch로 자동 백업 기능이 내장되어 있습니다. |
| 컨텍스트 최적화 | 자동 토큰 예산 관리(정리, 스마트 클리핑, 압축 레이어)와 추정 절약량을 시각화하는 UI가 제공됩니다. |
| 로컬 코드 그래프 | 심볼, 임포트, 호출 관계를 인덱싱하고, 에이전트가 이 그래프를 질의하여 간결하고 관련성 높은 코드 컨텍스트를 제공합니다. |
| 스케줄링 및 백그라운드 작업 | 한 번 또는 반복 작업을 수행할 수 있으며, 귀하가 떠나 있어도 실행 가능하며, CI 파이프라인용 "헤드리스" --print 모드도 지원합니다. |
| 확장성 | 플러그인, 스킬, 멀티에이전트 오케스트레이션, 사용자 정의 도구용 MCP 서버. |
빠른 시작 (CLI)
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/wk42worldworld/cybercode/main/scripts/install-cli.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/wk42worldworld/cybercode/main/scripts/install-cli.ps1 | iex
설치 스크립트는 최신 안정 버전 바이너리를 다운로드하고, 필요 시 Bun을 설치하며, PATH에 cybercode 명령어를 추가합니다(관리자 권한 필요 없음).
일반적인 명령어:
| 명령어 | 목적 |
|---|---|
cybercode |
현재 프로젝트 폴더에서 인터랙티브 세션 시작 |
cybercode "Explain this repo" |
단일 작업 실행 후 종료 |
cybercode -p "Fix failing test" |
헤드리스 모드, JSON 친화적 출력 |
cybercode -c |
가장 최근 세션을 계속 |
cybercode -r |
저장된 세션 중 하나를 선택하여 복원 |
cybercode --model <model> |
이 실행에서 특정 모델 선택 |
cybercode -w <feature-name> |
세션용 고립된 Git worktree 생성 |
cybercode plugin … |
플러그인 관리 |
cybercode doctor |
환경 문제 진단 |
데스크톱 애플리케이션
Built with Tauri 2 + React. 릴리스 페이지에서 적절한 설치 파일을 다운로드하세요 (macOS Apple Silicon, macOS Intel, Windows x64, Linux x64). GUI에서는 다음과 같은 기능을 제공합니다:
- 프로젝트 선택기 및 멀티세션 탭
- 프로바이더 및 모델 선택 패널
- 코드 그래프 탐색기 (심볼 검색, 아키텍처 보기, 파일 인덱싱)
- 토큰 최적화 대시보드
- 스케줄된 작업 관리자
- 파일 편집 또는 명령 실행에 대한 실시간 권한 요청
원격 제어
Telegram 및 Feishu 어댑터를 통해 동일한 에이전트를 서버에서 헤드리스로 실행하고, 채팅 클라이언트에서 제어할 수 있습니다. 장시간 리팩터링이나 작업장에서 떠나 있을 때 CI 스타일 자동화에 매우 유용합니다.
확장성
- 스킬 – 재사용 가능한 사용자 정의 툴킷으로, 에이전트가 호출할 수 있습니다.
- 플러그인 – 새로운 명령어나 UI 패널을 추가하는 즉시 설치형 패키지.
- MCP 서버 – 로컬 에이전트를 OpenAI/Anthropic 호환 엔드포인트(
cc_…노드 키)로 노출하여 다른 도구가 호출할 수 있도록 합니다. - 에이전트 팀 – 여러 하위 에이전트를 병렬로 오케스트레이션할 수 있습니다.
소스에서 시작하기
소스에서 실행하고 싶은 경우 (예: 데스크톱 UI 개발):
# Bun (런타임 및 패키지 매니저) 설치
curl -fsSL https://bun.sh/install | bash # macOS/Linux
# 또는 Homebrew: brew install bun
# Windows PowerShell: powershell -c "irm bun.sh/install.ps1 | iex"
bun install # 종속성 설치
cp .env.example .env # API 키 추가
./bin/cybercode # TUI 모드로 시작
# 또는 개발용 서버 + 데스크톱 UI 시작
SERVER_PORT=3456 bun run src/server/index.ts
cd desktop && bun run dev --host 127.0.0.1 --port 2024
문서(README 내부 링크 포함)는 각 기능, 환경 변수 설정, 마이그레이션 및 포터블 USB 워크플로우를 단계별로 안내합니다.
누구에게 적합한가요?
- 개인 개발자 – 세션 간에 코드베이스를 기억하는 AI 파트너가 필요한 사람.
- 팀 – 자체 호스팅, 벤더 독립적인 어시스턴트가 필요한 사람 (Anthropic에 종속되지 않음).
- 연구자 – 실제 코딩 워크플로우에서 기억, 자가 진화, 멀티에이전트 오케스트레이션을 탐구하고 싶은 사람.
- 자동화 엔지니어 – 코드 유지보수 작업을 스케줄링하거나 AI를 CI 파이프라인에 통합하고 싶은 사람.
더 알아보기
- 전체 문서 사이트: https://wk42worldworld.github.io/cybercode/
- 중국어 지원 커뮤니티 QQ 그룹 (ID 463169230)
- 기여 가이드, 로드맵, 런치 킷은 모두 리포지토리에 있습니다 (초보자용).
결론 – CyberCode는 Claude 스타일의 채팅 인터페이스와 영구 메모리, 크로스플랫폼 GUI, 모델 독립 백엔드, 풍부한 확장성 레이어를 갖춘 종합적인 오픈소스 코딩 어시스턴트이며, 모두 로컬에서 실행 가능합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트