MiniCode

가볍고 효율적인 코딩 도구입니다. 속도를 위해 설계되었으며, 단순함을 위해 구축되었습니다.

简体中文 | Usage Guide | DeepWiki | Architecture | Contributing | Roadmap | License

MiniCode는 로컬 개발 워크플로우를 위한 가벼운 터미널 코딩 어시스턴트입니다.

이는 Claude Code와 유사한 워크플로우 및 아키텍처 아이디어를 훨씬 더 작은 구현으로 제공하여, 학습, 실험, 맞춤형 도구 제작에 특히 유용합니다.

Fluxion AI는 GPT나 Claude 같은 주류 AI 모델에 대한 통합 API 접근을 안정적이고 비용 효율적으로 제공합니다. 아래의 전용 MiniCode 링크를 통해 등록하고 $3 API 크레딧을 받으세요:

MiniCode는 실용적인 터미널 우선 에이전트 루프를 중심으로 구축되었습니다:

• 사용자 요청 수락
• 작업 공간 검사
• 필요할 때 도구 호출
• 작성 전 파일 변경 사항 검토
• 동일한 터미널 세션에서 최종 응답 반환

프로젝트는 의도적으로 간결하게 유지되어, 제어 흐름(control flow), 도구 모델(tool model), TUI 동작이 이해하고 확장하기 쉽습니다.

Liu Mengxuan
창립자
TypeScript 레포지토리, 핵심 워크플로우, MCP/Skills, TUI 및 문서를 담당합니다.
|
GateJustice
공동 기획자
사용량 계산(usage accounting), 자동 압축(auto compact), 컨텍스트 붕괴(context collapse)를 포함한 장기 세션 컨텍스트 시스템에 기여했습니다.
|
sssn
핵심 기여자
장기 계획 워크플로우(/goal, /loop 및 /plan), 다중 서브 에이전트 오케스트레이션, TUI 시각적 개선에 기여했습니다.
|
harkerhand
MiniCode-rs
Rust 버전의 메인 작성자입니다.
|
QUSETIONS
MiniCode-Python
Python 버전의 메인 작성자입니다.
|
GoDiao
핵심 기여자
계층적 메모리(layered memory), /init, 세션 재개, TUI 상호 작용 개선에 기여했습니다.
|

요약은 메인 레포지토리와 다중 언어 브랜치 커밋 히스토리를 기반으로 합니다. 더 광범위한 기여자 목록은 레포지토리의 커밋 히스토리를 참조해 주십시오.

• TypeScript (이 레포): MiniCode

• Rust 버전: MiniCode-rs

• Python 버전: MiniCode-Python

• Go 버전: MiniCode-go

• Java 버전: MiniCode4j

• 브라우저에서 Open docs/index.html을 열어 시각적인 제품 개요를 확인하세요.

• GitHub Pages (권장):
  https://liumengxuan04.github.io/MiniCode/

MiniCode는 다음과 같은 경우에 적합합니다:

• 대규모 플랫폼 대신 가벼운 코딩 어시스턴트가 필요한 경우

• 툴 호출(tool calling), 기록(transcript), 명령어 워크플로우를 갖춘 터미널 UI가 필요한 경우

• 연구 및 수정에 적합한 작은 코드베이스가 필요한 경우

• Claude Code와 유사한 에이전트 아키텍처의 참고 구현체가 필요한 경우

• 단일 턴(turn)에서 다단계 툴 실행을 수행하여 model -> tool -> model 루프를 형성합니다.

• 최대 3개의 동시 읽기 전용 서브 에이전트를 지원하며, 루트 에이전트가 모든 코드 변경 사항을 소유하고 워커를 기다리거나 종료할 수 있습니다.

• 루트 에이전트의 턴에 걸쳐 공유되는 인메모리 Todo 계획(plan)으로, update_plan으로 업데이트하고 /plan으로 볼 수 있습니다.

• 턴에 걸쳐 지속되는 사용자 생성 인메모리 목표(Goal)를 가지며, /goal pause, /goal resume 및 명시적인 완료 확인 기능을 제공합니다.

• 프로세스 로컬 루프(Loop)가 각 실행 후 고정 지연 시간으로 프롬프트를 반복하고, Plan을 공유하며, 활성 Goal과 상호 배타적입니다.

• 입력 기록, 기록 스크롤, 슬래시 명령어 메뉴 및 승인 흐름이 있는 전체 화면 터미널 UI를 제공합니다.

• 재개(resume), 이름 변경(rename), 포크(fork), 압축(compact) 명령을 통한 프로젝트별 세션 지속성을 지원합니다.

• tail 추정치, 자동 압축(auto-compact), 컨텍스트 축소(context collapse), snip compact를 갖춘 제공자 사용 순서 우선(Provider-usage-first)의 컨텍스트 통계를 제공합니다.

• 파일, 검색, 편집, 명령어 실행, 웹 가져오기/검색 및 명확화 프롬프트를 위한 내장 툴을 제공합니다.

• SKILL.md를 통해 발견되는 로컬 스킬과 stdio 또는 원격 HTTP를 통한 MCP 툴/리소스/프롬프트가 있습니다.

• 경로 및 명령어 권한 검사를 거치는 쓰기 전 파일 편집(Review-before-write file edits) 기능을 제공합니다.

• 과도하게 큰 툴 결과는 디스크에 저장되고, 컨텍스트 내에서는 짧은 미리보기와 파일 경로로 대체됩니다.

전체 명령어 참조, 설정 예제, 세션 상세 정보 및 Skills/MCP 사용법은 Usage Guide로 이동했습니다.

git clone https://github.com/LiuMengxuan04/MiniCode.git
cd MiniCode
npm install
...

설치 프로그램이 모델 이름, ANTHROPIC_BASE_URL을 요청합니다.

, 그리고 ANTHROPIC_AUTH_TOKEN
.
설정은 다음 위치에 저장됩니다:

~/.mini-code/settings.json
~/.mini-code/mcp.json

MINI_CODE_HOME으로 설정하여 구성 디렉토리를, MINI_CODE_BIN_DIR으로 설정하여 런처 디렉토리를 재정의할 수 있습니다.
.
자세한 내용은 설치 상세 정보를 참조하세요.

설치된 런처 실행:

minicode

개발 모드에서 실행:

npm run dev

오프라인 데모 모드에서 실행:

MINI_CODE_MODEL_MODE=mock npm run dev

/help
: 대화형 도움말을 표시합니다.
/tools
: 사용 가능한 도구를 나열합니다.
/plan
: 현재 메모리 내 Todo 목록을 확인합니다.
/goal <설명>
,/goal [상태]
,/goal pause [이유]
,/goal resume
,/goal clear
: Goal을 생성, 검사 및 제어합니다.
/loop [Nm|Nh] <프롬프트>
,/loop
,/loop stop
: 반복적인 프롬프트(기본 10분; 최소 1분)를 생성, 검사 및 중지합니다.
/skills
: 발견된 스킬을 나열합니다.
/mcp
: MCP 연결 상태를 표시합니다.
/status
: 세션 및 컨텍스트 상태를 표시합니다.
/init
: 현재 프로젝트용 .mini-code/와 MINI.md를 스캐폴딩(scaffold)합니다.
/memory
: 현재 턴에 로드된 계층적 메모리 파일을 검사합니다.
/model
//model <이름>
: 모델을 검사하거나 전환합니다.
/resume
: 세션 선택기를 엽니다.
/compact
: 컨텍스트를 수동으로 압축합니다.

관리 명령어에는 minicode mcp ...와 minicode skills ...가 포함됩니다.
.
전체 참조는 명령어를 참조하세요.

• 사용 가이드 (Usage Guide)
• 아키텍처 개요 (Architecture Overview)
• 중국어 아키텍처 설명 (中文架构说明)
• 기여 가이드라인 (Contribution Guidelines)
• 중국어 기여 규범 (中文贡献规范)
• 로드맵 (Roadmap)
• MiniCode를 통해 Claude 코드 설계 학습하기

npm run check
npm test

MiniCode는 의도적으로 작고 실용적입니다. 목표는 아키텍처가 이해하기 쉽고, 해킹 가능하며, 확장하기 쉬운 상태로 유지하는 것입니다.