콘텐츠로 건너뛰기
supastack
문서 둘러보기
데스크톱Tauri

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/desktop/agent-setup.md (or send Accept: text/markdown).

에이전트에게 설정 맡기기

준비된 프롬프트 하나를 코딩 에이전트에 붙여넣고, 컴퓨터에서 Desktop 설정을 실행하게 한 다음, 각 단계에 대해 작성한 보고서를 확인합니다.

이 가이드에 대해 질문하기
다음에서 열기

번거로운 부분은 맡길 수 있습니다

이 리포지토리는 코딩 에이전트가 읽을 수 있도록 작성되었습니다. 맵 파일(llms.txt), 규칙 파일(AGENTS.md), 파일별 메모리 노트(.ai/), 태스크 스킬(.agents/skills/)이 함께 제공됩니다. 독립형 Desktop 체크아웃에는 prompts/ 폴더가 포함되지 않으므로 준비된 프롬프트가 이 가이드에 인쇄되어 있습니다 — 파일을 여는 대신 아래에서 복사하십시오.

타이핑을 맡긴다고 검사를 건너뛰는 것은 아닙니다. 에이전트는 저장소의 복사본 안에서 작업하며 무엇을 했는지 증거와 함께 보고해야 합니다. 아래 섹션은 좋은 리포트가 어떤 모습인지 보여주므로 결과를 계속 통제할 수 있습니다.

이 경로는 Tauri 셸과 Web 백엔드(계정과 데이터를 처리하는 서버)에 대한 연결을 설정합니다. 데스크톱 창은 해당 백엔드를 표시할 뿐입니다. 체크아웃에 apps/web도 포함된 경우 에이전트가 로컬에서 실행할 수 있고, Desktop 전용 체크아웃에는 제공받은 접근 가능한 백엔드 주소가 필요합니다.

먼저 필요한 것

먼저 준비 가이드를 완료하세요: Node.js, Git, 편집기 설치, GitHub 초대 수락, supastack 폴더를 컴퓨터에 다운로드. 에이전트는 그 폴더 안에서 작업하므로 시작하기 전에의 모든 내용이 계속 적용됩니다.

코딩 에이전트 역할을 할 수 있는 도구도 필요합니다 — AI 코딩 에이전트가 내장된 편집기(AI IDE) 또는 터미널에서 실행되는 에이전트(에이전트 CLI). 현재 에이전트 기능이 있는 도구라면 무엇이든 됩니다. 프롬프트에 무엇을 읽고 실행해야 하는지 이미 적혀 있으므로 지시를 직접 쓸 필요가 없습니다.

마지막으로 프롬프트가 요구하는 두 가지를 결정합니다: 창이 로드해야 하는 백엔드 주소 — 로컬 백엔드는 http://localhost:3000 또는 제공된 HTTPS 주소 — 와 이 컴퓨터에 Rust와 네이티브 빌드 도구가 이미 설치되어 있는지 여부.

프롬프트 복사, 두 곳 채우기, 붙여넣기

프롬프트는 아래의 코드 블록입니다 — 전체 블록을 선택하고 복사합니다.

두 개의 플레이스홀더에 선택이 필요합니다. <APP_URL>을 창이 로드해야 하는 백엔드 주소로 바꿉니다 — 로컬 백엔드는 http://localhost:3000 또는 제공된 HTTPS 주소. <TOOLCHAIN: present | install>을 rustc와 cargo가 이미 버전을 출력하면 present로, 에이전트가 먼저 Rust와 OS 빌드 도구를 설정해야 하면 install로 바꿉니다. 번호가 매겨진 단계는 작성된 그대로 유지합니다.

Set up this supastack Desktop checkout end to end and open the Tauri window against the backend at **<APP_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run rustc --version and cargo --version. On **<TOOLCHAIN: present | install>** = install, install Rust and this OS's Tauri prerequisites first, then continue.
3. Run corepack pnpm install.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <APP_URL> answers from this computer and report its status.
5. Start the shell with corepack pnpm --filter @supastack/desktop dev and report whether the window opens, the tray icon appears and the summon shortcut works.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.

에이전트가 프롬프트로 하는 일

프롬프트는 에이전트에게 맵, 규칙, 보안 체크리스트를 가리키고 설정을 순서대로 진행하며 각 단계를 증명하도록 지시합니다. 쉽게 말해 에이전트는 다음을 수행합니다:

  • 아무것도 건드리기 전에 저장소 지도(llms.txt), 프로젝트 규칙(AGENTS.md), 자격 증명 취급 규칙(docs/agent-security.md)을 읽습니다.
  • Rust 도구 체인과 이 OS의 Tauri 전제 조건을 확인하고 컴파일 중간에 실패하는 대신 설치하는 것을 보고합니다.
  • 백엔드가 지정한 주소에서 응답하는지 확인합니다 — 이 체크아웃에 apps/web 폴더가 있는 경우에만 스스로 시작합니다 — 없는 서버를 가정하지 않습니다.
  • 종속성을 설치하고 셸을 컴파일하고 창을 연 다음 창, 트레이, 소환 단축키 동작을 실제 출력과 함께 보고합니다.
  • 같은 단계가 두 번 실패하면 중지하고 보고합니다 — 실패를 우회하거나 묻지 않고 무언가를 삭제하지 않습니다.

에이전트의 리포트에서 확인할 것

좋은 보고서는 주장이 아닌 증거를 보여줍니다. 각 PASS 뒤에 응답하는 백엔드 URL, 완료된 종속성 설치, 완료된 Rust 컴파일, 열린 창이 있는지 확인하십시오 — '모든 것이 작동한다'는 문장이 아닙니다.

프롬프트는 에이전트에게 같은 단계가 두 번 실패하면 중지하고 보고하라고 — 실패를 우회하지 말고 — 파괴적인 작업 전에 물어보라고 지시합니다. 에이전트가 반복된 실패 후에도 계속 즉흥적으로 진행하면 중지하고 첫 번째 오류를 문제 해결 가이드로 가져가십시오.

절대 나타나서는 안 되는 두 가지가 있습니다: 오류를 없애려고 꺼버린 보안 기능과, 채팅이나 리포트에 출력된 비밀번호나 키 같은 시크릿 값. 둘 중 하나라도 보이면 그 실행은 실패로 간주하세요.

셸과 실제 로그인을 마음속으로 구분하십시오. 백엔드의 홈페이지를 보여주는 창은 셸을 증명합니다 — 실제 계정에는 여전히 백엔드의 데이터베이스가 필요합니다. '창이 열렸다'는 아직 '계정이 작동한다'가 아닙니다.

직접 하고 싶다면

에이전트가 수행하는 모든 단계는 아래의 수동 가이드에 나와 있습니다 — 같은 명령, 같은 확인, 자신의 속도로.