LiuMengxuan04/MiniCode

MiniCode – 경량 터미널 우선 코딩 어시스턴트

그것은 무엇인가 – MiniCode는 Claude Code 에이전트 패턴을 모방하지만 코드베이스가 매우 작은 오픈 소스 터미널 기반 AI 코딩 어시스턴트입니다. 로컬에서 실행되며 LLM(Anthropic의 Claude 또는 Sidrune AI 통합 API를 통해 노출되는 모든 모델)과 통신하고, 내장 도구(파일 편집, 검색, 셸 명령, 웹 페치 등)를 호출하여 사용자의 요청을 수행할 수 있습니다.

왜 중요한가 – 대부분의 AI 기반 코딩 어시스턴트는 대규모 웹 서비스 또는 무거운 데스크톱 앱입니다. MiniCode는 의도적으로 작게(수천 줄의 TypeScript) 유지되어 개발자가 전체 에이전트 루프를 읽고, 수정하고, 확장할 수 있습니다. 따라서 다음에 유용합니다:

• LLM 도구 호출 에이전트가 어떻게 연결되는지 배우기,
• 클라우드 플랫폼 없이 사용자 정의 프로젝트별 어시스턴트 구축,
• 터미널 UI에서 다단계 도구 워크플로, 목표 및 계획을 실험.

핵심 기능

• 모델 ↔ 도구 ↔ 모델 루프 – 단일 턴에서 여러 도구를 호출하고 결과를 LLM에 피드백하여 최종 답변을 얻을 수 있습니다.
• 하위 에이전트 – 최대 3개의 읽기 전용 작업자가 병렬로 실행됩니다. 루트 에이전트가 모든 파일 변경을 소유합니다.
• 메모리 내 계획 및 목표 – /plan은 에이전트가 업데이트하는 할 일 목록을 표시합니다. /goal은 턴을 넘어 지속되는 영구 목표를 만듭니다.
• 루프 기능 – 동일한 계획을 공유하면서 타이머 간격으로 프롬프트를 반복합니다.
• 전체 화면 TUI – 트랜스크립트 스크롤, 슬래시 명령 메뉴, 파일 쓰기 전 승인 프롬프트.
• 세션 지속성 – 각 프로젝트에는 자체 .mini-code/ 폴더가 있습니다. 세션은 재개, 이름 변경 또는 포크할 수 있습니다.
• 컨텍스트 관리 – 사용량 우선 통계, 자동 압축 및 과도한 도구 결과 스니핑.
• 확장 가능한 도구 세트 – 파일 조작, grep 스타일 검색, 셸 실행, 웹 페치, 명확화 프롬프트 및 SKILL.md를 통한 사용자 정의 스킬.

설치 및 빠른 시작

# 클론 및 설치
git clone https://github.com/LiuMengxuan04/MiniCode.git
cd MiniCode
npm install
npm run install-local   # 모델 이름 및 Anthropic 자격 증명 요청

# 어시스턴트 시작
minicode

모의 모드(MINI_CODE_MODEL_MODE=mock)를 사용하면 API 키 없이 UI를 시험해 볼 수 있습니다.

일반적인 워크플로

1. 요청 입력 – 예: "parseJson에 대한 단위 테스트 추가".
2. MiniCode는 작업 공간을 검사하고 필요한 도구를 결정하여 호출합니다(파일 검색, 테스트 실행기 실행 등).
3. LLM은 도구 출력을 수신하고 계획을 개선하며 파일 변경을 제안합니다.
4. TUI에서 diff를 검토합니다. MiniCode는 쓰기 전에 확인을 요청합니다.
5. 최종 응답(요약, 다음 단계 등)이 동일한 터미널 세션에 표시됩니다.

다국어 생태계 – 저장소는 TypeScript 참조 구현을 호스팅합니다. Rust, Python, Go 및 Java에도 동등한 버전이 있어 아키텍처가 언어에 구애받지 않음을 보여줍니다.

누가 만들었나 – 창립자 Liu Mengxuan(TypeScript 코어), 공동 창립자 GateJustice(긴 세션 컨텍스트 시스템), 그리고 하위 에이전트, 메모리 레이어 및 언어 포트를 담당하는 여러 기여자.

더 알아보기 –

• 사용 가이드(USAGE.md) – 전체 명령 참조 및 구성 예제.
• 아키텍처 개요(ARCHITECTURE.md) – 에이전트 루프, 메모리 레이어 및 도구 모델을 설명합니다.
• 데모 페이지 – docs/index.html 또는 GitHub-Pages 사이트를 열어 시각적 연습을 확인하세요.

이상적인 사용자

• 터미널 전용 AI 어시스턴트를 원하는 개발자.
• LLM 기반 도구 호출 패턴을 연구하는 연구자 또는 취미 개발자.
• 클라우드 플랫폼의 오버헤드 없이 사용자 정의 가능하고 자체 호스팅 코딩 도우미가 필요한 팀.

---

MiniCode는 코딩 지원에 초점을 맞춘 진정한 경량 AI 에이전트 프로젝트이며, 일반적인 튜토리얼 목록이나 사소한 데모가 아닙니다.