English · 简体中文

Unfour

백엔드 개발자를 위한 로컬 우선 데스크톱 워크스페이스로, API 디버깅, SSH 터미널, 데이터베이스 관리를 결합하고 로컬 MCP 서버를 통해 AI 에이전트에 노출합니다.

Codex & GPT-5.6로 제작

Codex는 Rust 및 TypeScript 아키텍처 검토, Tauri 명령 구현 및 리팩터링, 테스트 추가, 빌드 실패 및 MCP 프로세스 수명 주기 문제 조사에 사용되었습니다.

GPT-5.6은 AI 지원 백엔드 문제 해결 워크플로우 설계, SSH 및 데이터베이스 권한 경계 분석, MCP 도구 설계 개선, 프로젝트 아키텍처 및 릴리스 프로세스 계획을 돕습니다.

Codex는 Unfour의 개발 도구 그 이상입니다. Unfour MCP 서버를 통해 API, SSH, 데이터베이스 기능을 사용하여 API 문제를 재현하고, 서비스 로그를 검사하고, 데이터베이스를 쿼리하고, 증거를 연관 지어 근본 원인을 식별할 수 있습니다.

민감한 작업은 여전히 개발자 통제 하에 있습니다. 작업 영역 범위, 자격 증명 처리, 호스트 신뢰, 확인, 도구 권한은 Codex가 액세스하고 실행할 수 있는 대상을 제한합니다. Codex를 연결한다고 해서 기본적으로 무제한 액세스 권한이 부여되는 것은 아닙니다.

[!WARNING] 소스 트리는 Community Stable v0.5.0 릴리스를 준비 중입니다. 서명되지 않았으며 여전히 릴리스 검증이 필요합니다. 설치 프로그램이 SmartScreen 또는 기타 운영 체제 보안 경고를 트리거할 수 있습니다.

Related MCP server: devpulse-mcp

다운로드

GitHub Releases에서 게시된 빌드를 다운로드하세요. 최신 안정 버전은 v0.4.0이며, v0.5.0은 릴리스가 게시된 후 여기에 표시됩니다.

• Windows: NSIS .exe 설치 프로그램.

• macOS 및 Linux 패키지는 실제 기기 스모크 테스트가 기록될 때까지 실험적이며 검증되지 않았습니다. 아직 지원되거나 검증된 것으로 간주하지 마십시오.

• 릴리스 SHA256SUMS.txt 자산으로 다운로드한 설치 프로그램을 확인하세요.

Unfour란 무엇인가요?

Unfour는 백엔드 및 운영 작업을 위한 로컬 우선 데스크톱 워크스페이스입니다. API 요청, SSH 연결, 데이터베이스 연결, 로컬 활동, 작업 영역 레이아웃을 하나의 로컬 우선 애플리케이션에 유지하고 로컬 MCP 서버를 통해 AI 에이전트에 이러한 기능을 노출합니다. 이 기반은 이러한 도구 전반에 걸친 AI 지원 문제 해결 워크플로우를 지원합니다.

이 앱은 Tauri 2, React, TypeScript 및 Rust로 구축되었습니다. 프런트엔드는 작업대 UI를 담당하며, HTTP, SSH, 데이터베이스 드라이버, 로컬 스토리지, 자격 증명 참조와 같은 보안에 민감한 실행은 Rust 기능 크레이트와 명령 버스 뒤에 있습니다.

모듈

• API 클라이언트 - HTTP 요청을 작성하고 전송하고, 저장된 요청을 컬렉션과 폴더로 구성하고, 공유 작업 영역 변수를 해석하고, 응답 본문/헤더/쿠키/타이밍을 검사하고, 저장된 사전 요청 및 사후 응답 스크립트를 실행하고, 스크립트 테스트 및 콘솔 출력을 검토하고, 편집된 기록을 유지합니다.

• SSH 터미널 - SSH 연결 및 터미널 세션을 관리하고(분할 창, 검색, 클립보드 상황에 맞는 메뉴, 영구적인 편집된 명령 기록 및 입력 제안, 호스트 키 신뢰, 편집된 로그), SFTP를 통해 원격 파일을 탐색 및 전송하고, 연결/파일/작업 사이드바에서 다단계 SSH 작업(명령, 업로드, 다운로드)을 자동화합니다.

• 데이터베이스 - 데이터베이스 연결을 관리하고, 스키마를 탐색하고, 확인 인식 안전 검사(다중 문 현재 실행/모두 실행 포함)로 SQL을 실행하고, 테이블 행을 미리 보고 편집하며, 쿼리 출력을 검토합니다.

• 작업 영역 - 저장된 요청, 공유 환경/변수, 연결, 활동, 탭 및 레이아웃 상태를 로컬 작업 영역으로 범위를 지정하고, 제목 표시줄 활성 환경 전환을 지원합니다.

• Codex 기반 API, SSH 및 데이터베이스 디버깅을 위한 MCP 통합 - 데스크톱 앱에서 사용하는 것과 동일한 명령 버스를 통해 MCP 클라이언트(예: Codex, Claude Code, Cursor)에 안전한 로컬 진단 도구를 노출하여 AI 에이전트가 동일한 API, SSH 및 데이터베이스 컨텍스트로 작업할 수 있도록 합니다.

스크린샷

앱 개요 — 모듈 전환기가 있는 사이드바 및 API 클라이언트 작업 영역

API 클라이언트 — 매개변수, 인증, 헤더, 본문 및 응답이 있는 요청 빌더

SSH 터미널 — 연결, 세션, 원격 파일 및 작업

데이터베이스 — 스키마 탐색 및 SQL 쿼리 출력

로컬 개발

요구 사항:

• Node.js 및 pnpm.

• 안정적인 Rust 툴체인.

• 운영 체제에 맞는 Tauri 2 사전 요구 사항.

설치 및 실행:

pnpm install
pnpm tauri dev

pnpm install은 lefthook을 통해 Git 후크도 설치합니다. 커밋은 cargo fmt로 스테이징된 Rust 파일의 형식을 지정하고 ESLint로 스테이징된 TypeScript를 자동 수정합니다. LEFTHOOK=0 git commit으로 한 번 건너뜁니다.

일반적인 명령:

pnpm tauri build        # create local Stable-channel Tauri bundles
pnpm tauri build:test   # create isolated Test-channel Tauri bundles
pnpm run build          # build the desktop frontend only
pnpm run check          # frontend build + Rust check + large-file check
pnpm run lint           # ESLint
pnpm run test           # frontend unit tests (Vitest)
pnpm run test:e2e       # Playwright smoke tests
pnpm run check:rust     # cargo check --workspace
pnpm run check:rust:ssh # cargo check with the ssh-native feature
pnpm run test:rust      # cargo test --workspace
pnpm run test:release-env # release/channel contract unit tests

패키지 문서에 달리 명시되지 않는 한 리포지토리 루트에서 명령을 실행하세요. pnpm tauri dev는 기본적으로 Test 릴리스 채널을 사용하는 반면, 로컬 pnpm tauri build는 Stable을 기본으로 합니다. 격리된 Test 채널 번들은 pnpm tauri build:test를 사용하세요. 개발 데이터가 ~/.unfour-dev를 사용해야 하는 경우 UNFOUR_STORAGE_PROFILE=dev를 설정하세요. 이 스토리지 재정의는 릴리스 ID와 무관합니다. 공식 게시 가능한 Stable 아티팩트는 UNFOUR_RELEASE_CHANNEL=stable 및 정확한 UNFOUR_BUILD_COMMIT을 사용하여 CI에서만 만들어야 합니다.

프로젝트 레이아웃

전체 패키지 및 크레이트 맵은 docs/architecture/project-structure.md를 참조하세요.

릴리스 상태

소스 트리는 Community Stable v0.5.0을 준비 중입니다. 최신 게시된 안정 버전은 v0.4.0입니다. 릴리스 준비 상태는 다음 문서에 설명되어 있습니다:

• docs/testing/release-verification.md

• docs/testing/manual-test-cases.md

• docs/release/release-checklist.md

• docs/release/distribution.md

• docs/release/signing.md

Windows는 NSIS .exe 설치 프로그램을 배포합니다. 설치 프로그램은 서명되지 않았으며 SmartScreen을 트리거할 수 있습니다. macOS 및 Linux는 실제 기기 스모크 테스트가 완료될 때까지 실험적/검증되지 않은 상태로 유지됩니다. 대상 플랫폼에서 성공적으로 실행되었거나 현재 리포지토리 증거로 뒷받침되지 않는 한 릴리스 검사가 통과했다고 주장하지 마십시오.

문서

• AGENTS.md - 코딩 에이전트를 위한 리포지토리 규칙.

• docs/agents/START_HERE.md - AI 에이전트를 위한 범위 지정된 온보딩 경로.

• docs/architecture/package-boundaries.md - 패키지 소유권 및 금지된 종속성 방향.

• docs/architecture/project-structure.md - 리포지토리, 패키지, 크레이트 및 호출 체인 맵.

• docs/architecture/data-storage.md - 작업 영역 데이터, SQLite, 자격 증명 참조 및 로컬 활동 규칙.

• docs/architecture/diagnostics.md - 로컬 구조화 로그, 편집, 보존, 진단 번들 및 개발자 로깅 지침.

• docs/architecture/security-model.md - 보안 태세, 편집, 호스트 키 정책 및 위험한 작업 규칙.

• docs/mcp/overview.md 및 docs/mcp/tools.md - 로컬 MCP 서버 동작.

• docs/testing/release-verification.md - 릴리스 검증 매트릭스.

• docs/release/release-checklist.md - 공개 릴리스 체크리스트.

• docs/user/USER_GUIDE.md - 사용자용 워크플로 가이드.

기여

풀 리퀘스트를 열기 전에 CONTRIBUTING.md, CODE_OF_CONDUCT.md 및 AGENTS.md의 패키지 경계 규칙을 읽어 주세요.

보안 문제는 공개 이슈가 아닌 SECURITY.md를 통해 신고해야 합니다.

라이선스

Apache License 2.0에 따라 라이선스가 부여됩니다.