컨텍스트 참조

type @ 를 입력하여 메시지를 직접 입력합니다. Hermes는 참조 인라인을 확장하고 --- Attached 컨텍스트 --- 섹션에서 콘텐츠를 추가합니다.

지원된 참고

옵션 정보	설명
@file:path/to/file.py	파일 내용
@file:path/to/file.py:10-25	특정 라인 범위 (1-indexed, 포함)
@folder:path/to/dir	파일 metadata로 디렉토리 트리 목록
@diff	Inject git diff (단일 작업 나무 변경)
@staged	git diff --staged (단일 변경)
@git:5	마지막 N는 패치 (최대 10)로 커밋합니다.
@url:https://example.com	Fetch and inject 웹 페이지 내용

사용 예제

Review @file:src/main.py and suggest improvements

What changed? @diff

Compare @file:old_config.yaml and @file:new_config.yaml

What's in @folder:src/components?

Summarize this article @url:https://arxiv.org/abs/2301.00001

다중 참조는 단일 메시지에서 작동:

Check @file:main.py, and also @file:test.py.

순회화 (,, ., ;, !, ?)는 참조 값에서 자동으로 벗겨집니다.

CLI 탭 완료

인터렉티브 CLI에서 @ 트리거를 자동 완성합니다

• @는 모든 참조 유형 (@diff, @staged, @file:, @folder:, @git:, ...)을 보여줍니다
• @file: 및 @folder: 트리거 파일시스템 경로 완료 파일 크기 메타데이터
• Bare @는 부분 텍스트가 현재 디렉토리의 파일과 폴더에 매칭합니다

선 범위

@file: 참고는 정확한 내용 주입을 위한 선 범위를 지원합니다:

@file:src/main.py:42        # Single line 42
@file:src/main.py:10-25     # Lines 10 through 25 (inclusive)

라인은 1-indexed입니다. 잘못된 범위는 침묵적으로 무시됩니다 (전체 파일이 반환됩니다).

크기 제한

컨텍스트 References는 모델의 컨텍스트 창을 압도적으로 방지하기 위해 경계를 둡니다:

임계값	주요 특징	채용 정보
소프트 제한	맥락 길이의 25%	경고 부과, 확장 진행
단단한 한계	컨텍스트 길이의 50%	확장 거부, 원래 메시지가 변경되지 않음
폴더 항목	최대 200 파일	Excess 항목은 -...로 대체됩니다
Git 커밋	최대 10	@git:N 범위에 클램프 [1, 10]

보안 보안

민감한 경로 차단

이 경로는 항상 @file: 참조에서 차단됩니다

• SSH 열쇠와 구성: ~/.ssh/id_rsa, ~/.ssh/id_ed25519, ~/.ssh/authorized_keys, ~/.ssh/config
• 셸 단면도: ~/.bashrc, ~/.zshrc, ~/.profile, ~/.bash_profile, ~/.zprofile
• Credential 파일: ~/.netrc, ~/.pgpass, ~/.npmrc, ~/.pypirc
• Hermes env: $HERMES_HOME/.env

다음 위치는 완전히 차단됩니다(그 안의 모든 파일 포함):

• ~/.ssh/, ~/.aws/, ~/.gnupg/, ~/.kube/, $HERMES_HOME/skills/.hub/

Path Traversal 보호

모든 경로는 작업 디렉터리를 기준으로 해석됩니다. 허용된 workspace root 밖으로 벗어나는 참조는 거부됩니다.

Binary 파일 탐지

binary file은 MIME type과 null byte scan으로 감지됩니다. 알려진 text 확장자(.py, .md, .json, .yaml, .toml, .js, .ts 등)는 MIME 기반 감지를 우회합니다. binary file은 warning과 함께 거부됩니다.

플랫폼 가용성

context reference는 주로 CLI 기능입니다. interactive CLI에서는 @ trigger tab completion이 동작하고, reference가 agent에게 전송되기 전에 확장됩니다.

messaging platform(Telegram, Discord 등)에서는 @ 구문이 gateway에서 확장되지 않습니다. message는 그대로 전달됩니다. agent는 여전히 read_file, search_files, web_extract tool을 통해 참조 파일을 직접 확인할 수 있습니다.

컨텍스트 압축을 가진 상호 작용

대화 context가 압축되면 확장된 reference content가 compression summary에 포함됩니다. 즉:

• 큰 파일의 @file: content는 context 사용량에 포함됩니다.
• 대화가 나중에 압축되면 파일 내용은 요약됩니다(원문 그대로 보존되지 않음).
• 매우 큰 파일은 line range(@file:main.py:100-200)를 사용해 관련 section만 주입하세요.

일반 패턴

# Code review workflow
Review @diff and check for security issues

# Debug with context
This test is failing. Here's the test @file:tests/test_auth.py
and the implementation @file:src/auth.py:50-80

# Project exploration
What does this project do? @folder:src @file:README.md

# Research
Compare the approaches in @url:https://arxiv.org/abs/2301.00001
and @url:https://arxiv.org/abs/2301.00002

오류 처리

잘못된 참조는 실패보다 인라인 경고를 생성합니다

(주)	채용 정보
찾을 수 없음	경고: "파일을 찾을 수 없습니다"
Binary 파일	경고: "기본 파일이 지원되지 않습니다"
찾을 수 없음	경고: "찾지 못했습니다"
Git 명령은 실패	git stderr로 경고
URL 반환 내용	경고: "작용되지 않음"
민감한 경로	경고: "path는 민감한 식별 파일"
외부 작업 공간	경고: "path는 허용된 업무 공간 밖에 없습니다"