WittyCode
English | 简体中文 | Wiki
CI
CodeQL
Ask DeepWiki
자체 에이전트 루프를 갖춘 Windows용 코딩 에이전트 데스크톱 앱입니다. 답변이 먼저 나오고, 도구 호출은 한 줄로 통합됩니다.
After a turn: the tool calls folded into one summary line, the answer up front
- 자체 에이전트 루프: WittyCode는 자체적으로 모델을 호출합니다. ChatGPT Plan('Sign in with ChatGPT') 또는 사용자의 API 제공업체를 통해 작동하며, 세 가지 권한 수준에 따라 파일, 검색 및 셸 도구를 실행합니다. 긴 대화는 압축되고, 실패한 요청은 재시도됩니다.
- 모든 모델을 위한 단일 창: ChatGPT Plan, API 제공업체(OpenAI, Anthropic, DeepSeek/OpenRouter/Ollama와 같은 OpenAI 호환 엔드포인트, AWS Bedrock 등), 그리고 선택적으로 Devin 또는 Factory CLI를 지원합니다. 일반적인 대화는 중간에 다른 모델로 전환할 수 있으며, 이전 텍스트 기록은 유지됩니다.
- Fusion 및 Plan: 자체 메인 에이전트는 재사용 가능한 모듈 전문가에게 작업을 위임할 수 있습니다. Plan 기능은 실행 전에 현재 제안에 대한 명시적 승인을 기다립니다. 구성, 예산 및 제한 사항에 대해서는 Fusion 가이드 (중국어)를 참조하세요.
- 작동 중 질문: 승인 요청과 질문은 카드 형태로 나타나며, 한 줄에 하나의 답변이 표시됩니다. 턴(turn)이 진행되는 동안 입력된 메시지는 대기열에 추가되거나 실행 중인 턴으로 전달될 수 있습니다 (steer).
- 슬래시 명령어 및 스킬:
/compact, /plan, /goal <목표>; .wittycode/에서 사용자의 스킬과 커스텀 명령어를 사용할 수 있습니다 (다른 에이전트 앱들이 사용하는 폴더 포함).
- 공유 메모리: 모든 엔진이 읽고 쓰는 단일 로컬 노트 세트를 제공합니다. 노트와 대화는 다른 앱으로부터 가져올 수 있습니다.
- 로컬 우선(Local first): 대화, 메모리 및 캐시는 사용자의 장치에 저장됩니다. 텔레메트리는 전송되지 않습니다.
설정(Settings) → **연결(Connections)**은 로컬 Codex 형식의 Skills, Plugins, command Hooks 및 stdio MCP를 가져오기 미리보기와 명시적 신뢰 설정을 통해 관리합니다. 지원되는 형식과 제한 사항은 connection guide (중국어)를 참조하세요.
다음에 올 기능들은 Roadmap을 확인하세요.
엔진(Engines)
| 엔진(Engine) | 필요한 것(What it needs) |
|---|
| ChatGPT Plan | ChatGPT 계정; 설치할 다른 것은 없음 |
| ... | |
| WittyCode 자체는 다른 에이전트 프로그램에 의존하지 않습니다. 설정되지 않은 엔진은 단순히 메뉴에 모델이 없을 뿐입니다. | |
시작하기(Getting started)
릴리스(Release): Releases에서 WittyCode-<version>-win-x64.zip을 다운로드하고, .sha256 파일과 비교한 후 압축을 풀고 WittyCode.exe를 실행하세요. Python과 모든 종속성(dependency)이 내장되어 있습니다. 이 앱은 아직 코드 서명(code-signed)되지 않았기 때문에 SmartScreen에서 "알 수 없는 게시자"라고 표시할 수 있습니다.
소스 코드 이용(From source) (Windows 10/11, Python 3.11.x, Node.js 24):
git clone https://github.com/WittyRyuji/WittyCode.git; cd WittyCode
py -3.11 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt -c constraints.txt
...
첫 실행: 프로젝트 폴더를 추가 → 설정(Settings) › 계정 및 모델(Accounts & models) → ChatGPT로 계속하기(Continue with ChatGPT) (또는 API 제공업체 추가) → Ctrl+N.
- 단축키(Shortcuts):
Ctrl+N 새 대화, Ctrl+L 메시지 상자, Ctrl+B 사이드바, Ctrl+O 프로젝트 추가, Ctrl+, 설정, F5 새로고침, Ctrl+Q 종료.
- 명령줄(Command line):
--project DIR, --settings FILE, --debug.
- 데이터는
%APPDATA%\ extbackslash WittyCode\에 저장됩니다.
현재 인터페이스는 중국어입니다. 영어 인터페이스는 Roadmap에서 확인할 수 있습니다.
레이아웃(Layout)
| 경로(Path) | 내용(What) |
|---|
desktop/ui/ | 진입점, 프레임리스 창, QWebChannel 브릿지 |
| ... | |
| 페이지와 백엔드는 단일 QWebChannel을 통해 통신하며, 모든 엔진은 AppCore에 동일한 인터페이스를 제공합니다. 이 프로젝트는 Python과 React (TypeScript)만을 사용합니다. | |
개발(Development)
.\.venv\Scripts\python.exe -m pip install -r requirements-dev.txt -c constraints.txt
.\.venv\Scripts\python.exe scripts/check_ci.py --clean
# Whole-window tests run separately, locally (build the page first):
...
Python 3.11.9와 Node 24.20.0을 사용하며 CI와 일치시킵니다. clean 항목은 격리된 복사본에 고정된 종속성을 설치하고, Qt의 실제 QWebChannel 클라이언트를 포함하여 CI 및 릴리스와 동일한 검사를 실행합니다. 전체 창(whole-window) 스위트는 Qt에서 실제 React 페이지를 실행하며 로컬 전용으로 유지됩니다. 풀 리퀘스트를 열기 전에 CONTRIBUTING.md를, 취약점을 보고하려면 SECURITY.md를 참조하십시오.
릴리스 빌드: cd frontend; npm run build:app; cd ..를 실행한 다음, .\.venv\Scripts\python.exe scripts\build_release.py를 실행합니다. zip 파일은 dist\에 있습니다. 태그가 지정된 릴리스는 GitHub Actions에 의해 빌드됩니다.
상태 (Status)
- 알파 버전(Alpha). Windows 10/11 x64 전용입니다.
- 에이전트 루프는 샌드박스가 아닙니다: 권한은 해결된 경로와 명령어 텍스트로부터 결정되며, OS 수준의 격리는 없습니다. 신뢰하지 않는 저장소에서는
ask 레벨을 사용하고, 절대 full을 사용하지 마십시오. 샌드박스는 Roadmap에 있습니다.
- Bedrock은 아직 AWS 계정에 대한 실제 요청을 완료하지 않았습니다 (서명은 botocore를 기준으로 확인되었습니다).
라이선스 (License)
Apache License 2.0, © 2026 NiuXiao@WittyLoong Studio (NOTICE 참조). 릴리스에 포함된 타사 소프트웨어는 자체 라이선스를 유지하며, zip 내부의 THIRD_PARTY_NOTICES.txt 및 licenses/에 나열되어 있습니다. PySide6 / Qt는 별도의 교체 가능한 DLL로 LGPL-3.0 하에 사용됩니다.