> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# 파일과 폴더

> Archetype이 설정, 키, 기록, 로그, worktree를 두는 곳과 이를 바꾸는 환경 변수.

macOS와 Linux 기준 경로입니다. `$XDG_CONFIG_HOME`이 있으면 `~/.config` 대신, `$XDG_DATA_HOME`이 있으면 `~/.local/share` 대신 씁니다.

## 설정

내 설정, 프로젝트 설정, env 파일, 지침, 스킬, 이름 있는 에이전트는 [설정](https://docs.archetype.ing/ko/reference/config.md)에 있습니다. `~/.config/archetype/`에는 이것들도 있습니다.

| 무엇 | 위치 |
| - | - |
| 앱의 폴더 목록 | `workspaces.json` |
| 키보드 단축키 | `shortcuts.json` |
| 직접 추가한 모델 제공자 | `providers/*.json` |

플래그가 프로젝트 설정보다, 프로젝트 설정이 내 설정보다 먼저입니다. 프로젝트 설정은 에이전트가 할 수 있는 일을 줄일 수만 있고 넓힐 수는 없습니다. 제공자나 모델, 편집·명령 허용, hook, 샌드박스는 정할 수 없습니다.

## 데이터

`~/.local/share/archetype/` 안:

| 무엇 | 위치 |
| - | - |
| 폴더마다의 대화와 기록 | `projects/<폴더>-<id>/` |
| 채팅 채널의 대화 | `chat/` |
| 세션과 하위 에이전트의 worktree | `worktrees/<폴더>/<세션>/` |
| 메모리 | `memory/` |
| 권한 모드와 "항상 허용" | `permissions.json` |
| 에이전트가 물어 받은 키 | `secrets/` |
| Archetype의 ChatGPT 로그인 | `auth/chatgpt.json` |
| 엔진의 추가 계정 | `engine-accounts/` |
| 플러그인 데이터 | `plugin-data/<플러그인>/` |

세션의 worktree는 `archetype/<세션>` 브랜치에 있습니다. 기록은 직접 지우기 전까지 남습니다. 사용자 설정에 `"keepRecordsDays": 90`을 두면 그보다 오래된 끝난 기록을 지웁니다.

## 로그

| 무엇 | 위치 |
| - | - |
| 백그라운드 서비스 | `~/.local/share/archetype/daemon/daemon.log`, 또는 `archetype daemon logs -n 100 --follow` |
| 서비스 정의 | macOS: `~/Library/LaunchAgents/ai.pairful.archetype.daemon.plist`, Linux: `~/.config/systemd/user/archetype-daemon.service` |

`archetype --doctor`는 모델을 부르지 않고 설정, 모델, 키, 기록 폴더를 확인합니다.

## 환경 변수

| 변수 | 하는 일 |
| - | - |
| `XDG_CONFIG_HOME` | `~/.config`를 옮깁니다 |
| `XDG_DATA_HOME` | `~/.local/share`를 옮깁니다 |
| `ARCHETYPE_NO_CONFIG=1` | 설정 파일을 읽지 않고, 기본 에이전트만 씁니다 |
| `ARCHETYPE_NO_NETWORK=1` | 업데이트 확인과 온라인 모델 목록을 건너뜁니다 |
| `ARCHETYPE_NO_BROWSER=1` | MCP 서버 로그인에 브라우저를 열지 않습니다 |
| `ARCHETYPE_INSTALL_DIR` | 설치 스크립트가 `archetype`을 두는 곳(기본 `~/.local/bin`) |
| `ARCHETYPE_WORK_NICE` | 에이전트의 명령이 앱에 양보하는 정도(1–19, 기본 10, `off`면 끔) |
| `ARCHETYPE_PLAIN=1` | 터미널이 전체 화면 대신 줄 단위로 출력합니다 |
| `ARCHETYPE_INLINE=1` | 터미널이 전체 화면 대신 출력을 스크롤에 쌓습니다 |
| `ARCHETYPE_MOUSE=0` | 마우스 휠과 선택을 터미널에 맡깁니다 |
| `NO_COLOR` | 터미널에서 색을 쓰지 않습니다 |

API 키도 환경 변수입니다. [계정과 키](https://docs.archetype.ing/ko/use/accounts.md) 참고.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.