Temha CLI Panel
Temha 프로젝트를 내려받아 코드를 수정하고 다시 업로드하세요.
VS Code와 Cursor에서 템플릿하우스(Temha) 프로젝트의 HTML·CSS·JavaScript를 편집할 수 있습니다. 익숙한 편집기와 AI 코딩 도구로 작업하고, 수정한 결과를 Temha 에디터에 이어서 반영하세요.
이렇게 사용하세요
- 로그인 — Temha 계정을 연결합니다.
- 내려받기(Pull) — 수정할 프로젝트를 내 컴퓨터로 가져옵니다.
- 코드 수정 — 프로젝트 폴더를 열어 HTML·CSS·JavaScript를 수정합니다.
- 업로드(Push) — 수정한 프로젝트를 Temha에 반영합니다.
Node.js, Git, 터미널용 Temha CLI를 따로 설치할 필요가 없습니다.
주요 기능
| 기능 |
할 수 있는 일 |
| 로그인·로그아웃 |
Temha 계정을 연결하거나 연결을 해제합니다. |
| 내려받기(Pull) |
프로젝트 하나 또는 전체 프로젝트를 내려받습니다. |
| 업로드(Push) |
프로젝트 하나 또는 전체 프로젝트를 서버에 반영합니다. |
| 저장 폴더 관리 |
저장 위치를 바꾸거나 폴더를 열고 경로를 복사합니다. |
| 작업 결과 확인 |
진행 상태, 성공·실패 결과와 상세 로그를 확인합니다. |
| AI 작업 가이드 |
Temha 프로젝트 구조와 수정 규칙을 확인합니다. |
처음 시작하기
1. Temha 계정으로 로그인하세요
왼쪽 활동 표시줄에서 Temha 아이콘을 누르세요. 이메일과 비밀번호를 입력한 뒤 로그인을 누르면 됩니다.
- 비밀번호는 로그인 요청에만 사용하며 저장하지 않습니다.
- 로그인 세션은 VS Code의 보안 저장소에 보관합니다.
- SNS 로그인만 사용한다면 Temha 사이트의 비밀번호 찾기에서 비밀번호를 먼저 설정하세요.
로그인 후 계정 영역의 로그아웃으로 연결을 해제할 수 있습니다.
2. 프로젝트를 내려받으세요
프로젝트 선택 Pull로 원하는 프로젝트를 가져오세요. 모든 프로젝트가 필요하면 전체 Pull을 사용하세요.
기본 저장 위치는 사용자 홈 폴더의 TemhaProjects입니다. 위치 변경으로 다른 폴더를 지정할 수 있습니다.
3. 파일을 열어 수정하세요
VS Code나 Cursor에서 내려받은 프로젝트 폴더를 여세요. 탐색기에서 HTML·CSS·JavaScript 파일을 선택해 수정할 수 있습니다.
AI 코딩 도구를 함께 사용하거나, 프로젝트에 맞는 로컬 서버 도구로 결과를 확인할 수 있습니다.
4. 수정한 프로젝트를 업로드하세요
프로젝트 선택 Push로 수정한 프로젝트를 선택하세요. 실행 전 확인 창에서 대상이 맞는지 확인한 뒤 진행합니다.
전체 Push는 로컬 저장 폴더에 있는 모든 프로젝트를 대상으로 합니다.
작업 전에 꼭 확인하세요
Pull하면 서버 내용을 기준으로 로컬 프로젝트를 다시 구성합니다.
아직 업로드하지 않은 수정 내용이 있다면 먼저 Push하거나 별도로 백업하세요.
- Push 전에는 업로드할 프로젝트가 맞는지 확인하세요.
- 여러 사람이 작업한다면 최신 프로젝트 내려받기 → 수정 → 업로드 순서를 지키세요.
- 같은 프로젝트를 동시에 수정하면 마지막에 서버에 저장한 내용이 우선될 수 있습니다.
- 작업이 끝날 때까지 편집기와 인터넷 연결을 유지하세요.
일부 파일이 업로드되지 않나요?
다음 파일은 Temha의 공통 시스템 파일이므로 일반 리소스 업로드에서 제외됩니다.
setting.css, plugin.css, style.css, setting.js, plugin.js, style.js
공통 스타일과 기능이 실수로 덮어써지는 것을 막기 위한 동작입니다.
또한 전체 Push를 실행해도 로컬에 없는 프로젝트나 CSS·JavaScript 파일을 서버에서 자동으로 휴지통에 보내지는 않습니다.
오류가 나면 이렇게 확인하세요
패널의 출력 보기를 누르면 Temha CLI 로그에서 자세한 내용을 확인할 수 있습니다.
| 상황 |
확인할 내용 |
| 로그인 오류 |
새로고침하거나 다시 로그인하세요. |
| 프로젝트 접근 오류 |
해당 계정에 프로젝트 권한이 있는지 확인하세요. |
| 파일 저장 오류 |
저장 폴더에 쓰기 권한이 있는지 확인하세요. |
| 작업 실행 불가 |
다른 Pull·Push 작업이 진행 중인지 확인하세요. |
| 서버 연결 오류 |
인터넷 연결 상태를 확인하세요. |
AI 작업 가이드
패널의 AI 가이드를 누르면 Temha 프로젝트 구조와 코드 수정 규칙을 볼 수 있습니다.
가이드는 프로젝트 저장 폴더의 docs에도 제공됩니다. VS Code와 Cursor의 AI 도구가 코드와 함께 참고할 수 있습니다.
사용 환경
- VS Code 1.85 이상 또는 호환되는 Cursor
- Temha 계정
- 인터넷 연결
- 프로젝트를 저장할 수 있는 로컬 폴더
관련 링크