<p align="center">
<img src="https://raw.githubusercontent.com/oschina/mothx/HEAD/docs/assets/mothx.png" alt="MothX" width="128" height="128">
</p>
<h1 align="center">MothX</h1>
<p align="center">
<strong>默思</strong> | 중국어 명칭
</p>
<p align="center">
<strong>🚀 모든 것을 지배하는 단일 바이너리 — 터미널 내 AI 코딩 어시스턴트</strong>
</p>
<p align="center">
Claude Code, Codex, Claw, Channels 간에 전환하는 것을 멈추세요.<br>
MothX는 제공자(providers), 도구(tools), 샌드박스(sandbox), 세션(sessions), 스킬(skills) 등을 단일 파일로 패키징합니다.
</p>
<p align="center">
<a href="https://www.npmjs.com/package/mothx-installer"><img src="https://img.shields.io/npm/dm/mothx-installer.svg" alt="npm downloads"></a>
<a href="https://pypi.org/project/mothx-installer/" alt="PyPI version"><img src="https://img.shields.io/pypi/v/mothx-installer.svg"></a>
<a href="https://github.com/oschina/mothx/releases/latest"><img src="https://img.shields.io/github/release/oschina/mothx.svg" alt="GitHub release"></a>
<a href="https://gitee.com/oschina/mothx/releases/latest"><img src="https://img.shields.io/badge/Gitee-release-blue" alt="Gitee release"></a>
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
<a href="https://goreportcard.com/report/github.com/oschina/mothx"><img src="https://goreportcard.com/badge/github.com/oschina/mothx" alt="Go Report Card"></a>
<a href="https://pkg.go.dev/github.com/oschina/mothx"><img src="https://pkg.go.dev/badge/github.com/oschina/mothx?status.svg" alt="GoDoc"></a>
<a href="https://github.com/oschina/mothx/network/dependencies"><img src="https://img.shields.io/librariesio/release/github/oschina/mothx" alt="Dependencies"></a>
</p>
<p align="center">
<strong>국내 미러: <a href="https://gitee.com/oschina/mothx">Gitee</a></strong>
</p>
이름 변경 공지: MothX는 이전에 VibeCoding으로 알려져 있었습니다. vibecoding 명령어와 이전 설치 패키지 이름은 호환성 별칭(compatibility aliases)으로 남아 있습니다. 설정은 .mothx 프로젝트 디렉토리와 MothX 전역 설정 디렉토리에서만 읽어오며, 레거시(legacy) 디렉토리는 읽거나 마이그레이션되지 않습니다.
✨ 왜 MothX인가?
문제점: 여러 AI 코딩 도구들(Claude Code는 한 가지 용도에, Codex는 다른 용도에, Claw는 또 다른 용도에)을 사용하고 있습니다. 각각은 자체적인 설정과 독특한 특징, 그리고 의존성을 가지고 있습니다.
해결책: MothX는 이 모든 것을 처리하는 올인원 터미널 AI 코딩 어시스턴트입니다. 단일 바이너리. 단일 설정. 번거로움 제로(Zero hassle).
🎯 주요 특징
| 기능 | 사용자에게 의미하는 바 |
|---|
| ⚙️ 워크플로우 모드 (Workflow Mode) | 단계별 실행, 병렬 실행, 다중 작업자 조정이 가능한 동적 JavaScript 워크플로우 — 복잡한 개발 파이프라인을 자동화합니다. |
| ... | |
🚀 30초 만에 시작하기
curl -fsSL https://mothx.net/install.sh | bash
...
이것으로 끝입니다. 이제 AI와 함께 코딩을 할 수 있습니다.
지원 플랫폼: Linux (x86_64, arm64), macOS (x86_64, arm64), Windows (x86_64), FreeBSD (x86_64, arm64)
제거:
npm uninstall -g mothx-installer
...
🎮 모든 상황을 위한 세 가지 모드
🗒️ Plan → 읽기 전용 분석 및 계획. 안전하고, 격리되어 있으며, 예상치 못한 일이 없습니다.
🔧 Agent → 표준 읽기/쓰기. Bash 승인이 필요합니다.
🚀 YOLO → 전체 시스템 접근 권한. 제한 없음. (기본값)
/mode plan|agent|yolo를 사용하거나 Tab 키를 눌러 언제든지 모드를 전환할 수 있습니다.
🏗️ 아키텍처 개요
mothx/
├── cmd/mothx/ # CLI 진입점
├── internal/
...
📚 문서
🚀 시작하기
⚙️ 설정 (Configuration)
🏗️ 아키텍처 (Architecture)
🔒 보안 (Security)
💻 IDE 통합 (IDE Integration)
🌐 서버 모드 (Serve Mode)
- 서버 모드 — OpenAI와 호환되는 HTTP API, 웹 UI 및 메시징 채널
- A2A 프로토콜 — 에이전트 간(Agent-to-Agent) 프로토콜
📊 분석 (Analytics)
📖 튜토리얼 (Tutorials)
🇨🇳 중국어 문서
🔄 동적 워크플로우 (Dynamic Workflows)
🖼️ 이미지 분석 (Image Analysis)
mothx -P "이 스크린샷을 설명해 주세요" --image screenshot.png
mothx -P "이 이미지에서 텍스트를 추출해 주세요" --image document.jpg
| 도구 (Tool) | 설명 (Description) |
|---|
read | 파일 내용 읽기 (Read file contents) |
| ... | |
🔧 설정 (Configuration)
설정 파일 (Settings Files)
| 위치 (Location) | 플랫폼 (Platform) | 범위 (Scope) |
|---|
~/.mothx/settings.json | Linux/macOS/FreeBSD | 전역 (Global) |
| ... | | |
MothX는 위 .mothx 위치에서만 설정을 읽습니다. 레거시인 .vibecoding 또는 .vibe 디렉토리는 읽거나 마이그레이션하지 않습니다. 사용자 지정 전역 설정 디렉터리를 선택하려면 MOTHX_DIR을 사용하세요. | | |
환경 변수 (Environment Variables)
| 변수 (Variable) | 설명 (Description) |
|---|
DEEPSEEK_API_KEY | DeepSeek API 키 |
| ... | |
Serve 설정 (Serve Configuration)
Serve 설정은 serve.json에 위치하며 (전역 ~/.mothx/serve.json, 프로젝트 .mothx/serve.json), OpenAI와 호환되는 API, 웹 UI, cron, 메모리, 메시징 채널을 포괄합니다. 자세한 내용은 Serve 모드를 참조하세요.
🤝 기여 (Contributing)
기여를 환영합니다! 자세한 내용은 개발 가이드를 참고하세요.
git clone https://github.com/oschina/mothx.git
cd mothx
make build
...
📄 라이선스 (License)
MIT — 자세한 내용은 LICENSE를 참고하세요.
<p align="center">
<strong>준비되셨나요? ⭐ 이 레포지토리에 별을 누르고 코딩을 시작하세요!</strong>
</p>