구성
q의 개인 설정, 워크스페이스 상태, 프로필, 재생성 가능한 인덱스 위치를 확인합니다.
개인 상태
| 경로 | 용도 |
|---|---|
~/.q/config.yaml |
기본 모델, 역할, 컨텍스트, Loom, LSP 구성 |
~/.q/providers.json |
관리형 Gateway 공급자와 모델 메타데이터 |
~/.q/gateway.json |
독립 Gateway 리스너와 키 메타데이터 |
~/.q/gateway.key |
Gateway API 키 검증용 비공개 마스터 키 |
~/.q/remote.json |
Remote 리스너, 인증 스위치, 키 메타데이터 |
~/.q/remote.key |
Remote API 키 검증용 비공개 마스터 키 |
~/.q/library.json |
Global Library 루프백 리스너 설정 |
~/.q/workspace-memory.json |
Workspace Memory 루프백 리스너 설정 |
~/.q/usage.json |
토큰 Usage 서비스 루프백 리스너 설정 |
~/.q/mcp.json |
외부 MCP 프로필과 역할 할당 |
~/.agents/skills/ |
q가 관리하지 않는 휴대 가능한 전역 Agent Skills |
~/.q/skills/ |
q가 관리하는 전역 Agent Skills |
~/.q/subagents/ |
전역 사용자 정의 서브에이전트 프로필 |
~/.q/logs/thinker/ |
단기 Thinker 호출 진단 |
~/.q/usage/usage.sqlite |
최근 토큰 이벤트와 일별 집계 |
~/.q/usage/archive/ |
오래된 원시 사용량 이벤트의 Parquet 아카이브 |
일반 구성에는 TUI를 사용하세요. 자동화가 필요할 때만 이 파일을 직접 편집하는 것이 좋습니다.
워크스페이스 상태
| 경로 | 용도 |
|---|---|
.q/sessions/<uuid>/session.json |
대화, 컨텍스트, 제목, 생명주기, 학습 상태 |
.q/sessions/<uuid>/plan-execution.json |
재개 가능한 승인 계획 체크포인트 |
.q/plan-executions/ |
완료된 실행 스냅샷 |
.q/model.json |
워크스페이스 모델 역할 오버라이드 |
.q/learning.json |
워크스페이스 학습 스위치 |
.q/lsp.json |
워크스페이스 LSP 루트와 오버라이드 |
.q/data/ 및 .q/index/ |
영구 레코드와 파생 인덱스 |
.q/loom/ |
내용 주소 기반 도구 아티팩트와 GC 메타데이터 |
.agents/skills/ |
q가 관리하지 않는 휴대 가능한 워크스페이스 Agent Skills |
.q/skills/ |
q가 관리하는 워크스페이스 Agent Skills |
.q/subagents/ |
워크스페이스 사용자 정의 서브에이전트 프로필 |
AGENTS.md |
워크스페이스 및 중첩 경로 지침 |
.qignore |
검색 제외 규칙 |
원본 데이터
JSON 레코드가 원본입니다. Bleve와 HNSW 인덱스는 파생 데이터이며 다시 만들 수 있습니다.
Loom GC는 구성된 유예 기간에 따라 활성 세션 프로젝션과 계획 체크포인트가 참조하는 아티팩트를 보호합니다. 워크스페이스 .q 상태를 삭제하면 q의 영구 기록이 사라지지만 저장소 파일을 되돌리지는 않습니다.