프로젝트
프로젝트는 OpenChamber가 추적하는 사용자 컴퓨터의 폴더로, 보통 하나의 코드베이스입니다. 프로젝트를 전환하면 에이전트가 작업하는 폴더가 그 프로젝트의 세션 및 설정과 함께 전환됩니다.
프로젝트 추가하기
몇 군데에서 프로젝트를 추가할 수 있습니다.
- 명령 팔레트의 Add project 항목
- 세션 사이드바 상단의 + 버튼
- 디렉터리를 선택할 때 나오는 폴더 브라우저
폴더를 지정하면 OpenChamber가 기억합니다. 이름은 폴더에서 가져오며, 나중에 변경할 수 있습니다.
프로젝트 전환하기
사이드바에서 프로젝트를 선택하면 활성화됩니다. 세션, git, 노트 등 모든 것이 열려 있는 프로젝트를 따릅니다.
프로젝트를 알아보기 쉽게 만들기
Settings → Projects를 열어 프로젝트에 사용자 지정 이름, 색상, 아이콘을 지정합니다. OpenChamber는 아이콘을 자동으로 찾으려고 시도합니다. Project icons를 참고하세요.
VS Code에서는 OpenChamber가 항상 열려 있는 폴더를 유일한 프로젝트로 사용하므로 추가하거나 전환할 것이 없습니다. 거기서는 Projects 설정 페이지가 숨겨집니다.
프로젝트 환경
프로젝트의 도구가 direnv, devenv, Nix 셸에서 오는 경우 Git 훅, 터미널, 프로젝트 작업은 그 도구를 스스로 찾지 못합니다. 설정 → 프로젝트를 열고 프로젝트를 고른 뒤 환경에서 다음 중 하나를 하세요.
- 이 프로젝트에만 필요한 변수 추가
- 또는 변수를 출력하는 환경 명령 설정(예:
direnv export json,devenv print-dev-env --json)
명령은 프로젝트 폴더에서 실행되고, worktree에서는 그 worktree의 폴더에서 실행됩니다. 마지막 실행 후 몇 분이 지났다면 커밋하거나 터미널을 열거나 작업을 실행할 때 다시 실행되며, 다시 실행을 누르면 바로 실행됩니다. 프로젝트를 열어 두기만 해서는 실행되지 않습니다. 입력란 아래에 마지막 실행이 변수를 몇 개 추가했는지, 또는 왜 실패했는지가 표시됩니다. 실패한 실행은 아무것도 추가하지 않으며, Git과 터미널은 그 변수 없이 계속 작동합니다.
이 변수는 설정 → 일반 → 환경 변수에 있는 변수에 더해 Git, 터미널, 프로젝트 작업에 전달됩니다(환경 변수 참고). OpenCode는 하나의 프로세스로 모든 프로젝트를 처리하므로 프로젝트 변수를 받지 않습니다. 에이전트에 필요한 값은 일반 목록에 넣으세요.
이 명령은 내가 직접 설정한 것만 사용됩니다. 저장소에서 읽어 오지 않으므로, 클론한 저장소가 OpenChamber에 무언가를 실행시킬 수는 없습니다.
관련 항목
- 채팅 — 간단한 질문을 위한, 프로젝트 없는 세션
- Project Notes, Todos & Plans — 프로젝트별로 작업 노트를 유지하세요
- Project Actions — 자주 실행하는 명령을 저장하세요
- Context — 세션이 모델의 메모리를 얼마나 사용하는지 확인하세요