Minnow: 완전한 에이전트 개발 워크스페이스

완벽한 에이전트 개발 워크스페이스. 오픈 소스이며, 완전히 사용자의 것입니다.

에디터, 에이전트, git, 이슈 관리, 계획 수립, 지식 베이스, 로컬 모델 호스팅 — 이 모든 것이 서로 작동하도록 처음부터 설계된 하나의 앱입니다.

Minnow가 존재하는 이유는 도구들은 훌륭하지만, 그들 사이의 연결고리(seams)가 아니었기 때문입니다.

그래서: 단일 워크스페이스, 단일 도구 세트. 기능을 계획하고, 작업 트리에 구축하게 하고, 테스트를 관찰하며, diff를 검토하고, 발생한 문제를 기록하고, 커밋하고, 배포할 수 있습니다 — 앱을 전환하거나 프로젝트에 대해 다시 설명할 필요 없이 말입니다.

사용자가 지정하는 모든 환경에서 실행됩니다. 사용자의 GPU에서 27B 모델이든, API 키를 통한 최첨단 모델이든, 또는 서로 다른 작업에 연결된 여러 모델로 두 가지 모두 한 번에 가능합니다. 계정, 구독, 사용 제한, 원격 측정(telemetry)이 없습니다.

Minnow는 솔로 개발자 및 취미 사용자에게 초점을 맞추고 있습니다. 밤 2시에 무언가를 만드는 장난기 많은 사람 말입니다. 그런 사람은 여섯 개의 구독과 조직도(org chart)가 필요하지 않습니다. 그들이 필요한 것은, 자신의 기계에서 전체 루프를 처리하는 단 하나의 도구입니다.

이들은 하나의 채팅 엔진, 하나의 도구 세트, 하나의 세션 스토어, 그리고 하나의 워크스페이스 루트를 공유합니다. 에이전트가 한 곳에서 학습한 내용은 다른 모든 곳에서도 사용 가능합니다.

Releases에서 패키지 빌드를 다운로드하세요.

설치 후 첫 실행. 그런 다음 모델을 지정하고 첫 채팅을 보내세요.

클론(Clone)하고 npm start를 실행하세요.

git clone https://github.com/HenriGrimm/Minnow.git
cd Minnow
npm install && npm start

전체 단계: 소스에서 설정하기.

Minnow는 가중치(weights)를 포함하지 않으며 내장된 제공자(provider)도 없습니다. 모든 OpenAI, Anthropic 또는 LMStudio API 엔드포인트로 스트리밍됩니다.

로컬(Local) — Minnow가 자체적으로 모델을 호스팅하고, LMStudio, Ollama 또는 다른 모든 호환 가능한 엔드포인트에 연결할 수 있습니다.클라우드(Cloud) — 사용자 자신의 키를 사용하는 모든 호환 가능한 API입니다.둘 다(Both) — 모델 라우팅(Model routing) 기능을 통해 특정 역할에 모델을 설정할 수 있습니다. 모델 풀(Model pools)은 사용 가능한 제공자에게 자동으로 라우팅되도록 합니다.

코드가 워크스페이스입니다. 그 외 모든 것은 코드를 서비스하는 표면일 뿐입니다.

idea → 계획 모드 (Plan mode) → documentation/plans/의 사양(spec)
→ 오케스트레이터 보드 (Orchestrator board) → 격리된 작업 트리에서 빌더 및 테스터 에이전트
→ 소스 제어 (Source Control) → diff 검토, PR 열기, CI 모니터링
...

또한 저장소(repo)를 열고 타이핑을 시작할 수도 있습니다.

프로젝트 개요는 채팅, 보드, 저장소 변경 사항, 이슈, 최근 파일, 예정된 작업, 기록된 AI 코드 활동을 통합합니다. 해당 행에서 직접 작업을 열거나 **코드 열기(Open Code)**를 선택하여 빌드할 수 있습니다. 홈 가이드입니다.

파일 트리, 우리는 에디터로 CodeMirror를 사용하며 여기에 언어 서버 인텔리전스 및 인라인 자동 완성 기능, 터미널 탭, 소스 제어, 개발 서버, 그리고 전체 사용자 및 에이전트 브라우저 기능을 결합했습니다. **의도 모드(Intent mode)**는 일반 영어 한 줄을 Tab으로 수락할 코드로 변환합니다. 채팅은 다른 창에 있는 것이 아니라 프로젝트 옆에 위치하여 동일한 파일, git, 터미널을 구동합니다. 원한다면 코드만 보고 채팅하는 것도 가능합니다.

dev-server 화면은 프로젝트가 필요한 서버들을 등록하며, 모델이 동일한 컨트롤을 구동합니다.

코드 맵(Code map) 은 리포지토리 전반에 걸친 심볼과 호출 관계를 인덱싱하여 사용자와 에이전트 모두에게 제공합니다.

완벽한 Git 및 GH 인터페이스입니다. 사용자의 에이전트들과 함께 작동하도록 처음부터 설계되었습니다.

푸시(Push), PR, 이슈(Issues), CI는 자체 gh CLI를 통해 실행됩니다. Minnow는 GitHub 토큰을 저장하지 않습니다: 만약 gh가 설치되거나 인증되지 않은 경우에도 그렇습니다. 추가적인 git 제공업체들은 로드맵에 있습니다.

하나의 계획을 작업들의 파도로 전환하고, 이를 Builder 및 Tester 에이전트에게 격리된 git worktree로 전달한 후 마지막에 병합합니다. 작업별로 구동하거나, 그냥 실행되도록 두어 실제로 무엇을 지정했는지 발견할 수 있습니다.

Minnow 홈의 마크다운 위키: 그래프 뷰, 페이지 편집, 추가 전용 로그(append-only log), 검토 대기 중인 AI 제안, 메모리, 인제스트(ingest), 린트(lint), 그리고 리포지토리의 코드-심볼 인덱스가 있습니다. 이 어시스턴트는 도구들을 사용하여 이를 읽고 쓰며, 이것이 프로젝트의 컨텍스트가 생성한 채팅을 거쳐도 살아남게 하는 방식입니다.

전체 투어: Apps guide.

리포지토리 옆에서 채팅하기 |
코드 레일(Code rail)에서의 세션: 모드, 첨부 파일, 음성, 알림. 사용 중인 동일한 파일, git, 터미널을 이용합니다. |
계획 수립(Planning) |
플랜 모드는 아이디어를 코드를 건드리지 않고 documentation/plans/에 구축 가능한 명세로 만듭니다. |
의도 기반 코딩(Intent-based coding) |
한 줄이 무엇을 해야 하는지 일반 영어로 입력하면, Tab 키가 이를 코드로 변환합니다. |
자동 완성(Autocomplete) |
언어 서버 컨텍스트를 백그라운드에 가진 인라인 고스트 텍스트입니다. |
빠른 편집(Quick Edit) |
Ctrl+K는 설명을 선택 영역의 diff로 변환합니다. |
서브 에이전트(Sub-agents) |
연구, 검토 또는 오랜 작업들을 자체 프롬프트, 모델, 컨텍스트 예산이 있는 에이전트에게 맡깁니다. |
루프와 목표(Loops and goals) |
/loop는 스케줄에 따라 프롬프트를 재실행하고; /goal은 평가자 에이전트가 조건 충족을 알릴 때까지 계속 작업합니다. |
음성(Voice) |
작곡기(composer)에 음성을 받아쓰고, 로컬 음성 모델로 말하는 답변을 받습니다. |
컴패니언 접근(Companion access) |
선택할 경우 LAN의 다른 장치에서 워크스페이스에 접속할 수 있습니다.

그 뒤에는 110개의 내장 도구가 있습니다: 파일, git, LSP, Godot 제어, 터미널, 웹, 브라우저 자동화, 서브 에이전트, 그리고 계획 확인 기능입니다. 이 각각의 도구는 Full, Ask, 또는 Off로 설정할 수 있으며, 이는 셸 명령을 실행할 수 있는 프로그램은 가끔 체크인(check in)해야 한다는 원칙에 기반합니다.

작동하는 데 필요한 세 가지 프로세스가 있습니다: Electron 셸, 로드되는 SPA(Single Page Application), 그리고 도구를 실행하고 ~/.minnow 아래 모든 영구 데이터를 소유하는 Node 서버입니다.

. 아키텍처에서 자세한 내용을 확인하세요.

오픈 소스의 요점은 여러분이 소스 코드를 읽을 수 있다는 것이 아닙니다. 실제로 손을 뻗고 싶은 곳에 '솔기(seams)'가 열려 있다는 것입니다.

Skills: SKILL.md 파일을 ~/.minnow/skills/ 디렉터리에 넣고 컴포저에서 /로 호출하세요. 19개의 기능이 내장되어 있으며, Skills Library에서 더 많이 설치하거나 자체적으로 작성할 수 있습니다.Plugins: /build-plugin을 사용하여 도구, 연결(connections), 패널 및 스킬을 생성한 다음, Settings → Plugins (플러그인 제작)에서 실시간으로 설치하고 다시 로드하세요. 레거시 로컬 도구와 MCP 서버도 지원됩니다.Agents: 자체 프롬프트, 모델, 샘플러 및 컨텍스트 예산을 가진 서브 에이전트 및 작업 에이전트를 정의할 수 있습니다.Prompts and modes: 앱의 모든 시스템 프롬프트는 리포지토리 내 마크다운 파일입니다. 직접 수정하세요.Themes: 16개가 내장되어 있는데, 이는 엄격하게 필요한 것보다 15개나 더 많은 것입니다. 전체 UI는 하나의 파일에 --mn-* 토큰으로 되어 있습니다.

소스 코드: AGPL 라이선스입니다. 포크하고, 제거하고, 재구축하고, 배포하세요. 파생물은 계속 AGPL을 유지합니다.

• 채팅 기록, 설정(config), Brain, 모델 및 비밀 정보는 사용자의 디스크에 ~/.minnow 아래에 저장됩니다. - 제공업체 키와 비밀번호는 휴지 상태에서 암호화됩니다 (AES-256-GCM). - 네트워크 접근은 옵트인(opt in)하기 전까지 루프백 전용입니다. - 파일 및 git 도구는 전체 드라이브가 아닌 열린 폴더 내에서 해결됩니다. - 웹 검색은 선택한 제공업체를 사용합니다. 원격 측정(telemetry)이나 전화 홈(phone-home) 기능이 없습니다. 아무도 여러분이 이것을 설치했다는 것을 모릅니다.

유료 등급을 위해 어떤 기능도 숨기지 않습니다. 참고점은 SaaS 제품이 아니라 Blender입니다. 즉, 전체 루프를 포괄하는 완전한 스위트이며, 카피레프트(copyleft) 하에 무료로 제공되고, 사용자들에 의해 자금이 지원되며, 그들이 분해하도록 만들어졌습니다.

관리자 한 명과 작은 커뮤니티가 있습니다. 진행 중인 작업이므로 일부는 미완성 상태이며, 제가 발견하기 전에 가장자리 부분을 찾게 될 것입니다. 버그 보고는 진정으로 유용합니다. 무언가가 고장 났거나, 혼란스럽거나, 빠진 부분이 있다면 말씀해 주세요.

풀 리퀘스트(Pull requests), 문서 수정, 기술, 테마 모두 환영합니다. 코드베이스에서 작업하고 싶으신가요? AGENTS.md와 documentation/context.md부터 시작하세요.

라이선스: GNU AGPL-3.0-or-later. 타사 공지 사항: THIRD_PARTY_NOTICES.md.