파일 및 터미널
Anyy는 파일을 읽고 검색하고, 특정 부분을 편집하고, 셸 명령을 실행하고, 백그라운드 프로세스 세션을 관리할 수 있습니다. 세션의 워크스페이스와 목표가 명확할 때 특히 유용합니다.
파일 도구
| 기능 | 동작 |
|---|---|
| 읽기 | 텍스트나 지원 JPEG/PNG/GIF/WebP/BMP 이미지 읽기. 큰 텍스트는 제한됨 |
| 목록 | 숨김 파일을 포함해 디렉터리를 알파벳순으로 나열 |
| 찾기 | .gitignore를 따르며 glob으로 경로 찾기 |
| Grep | .gitignore를 따르며 경로·줄 번호와 함께 파일 내용 검색 |
| 기록 | 파일 하나를 생성·덮어쓰고 상위 디렉터리 생성 |
| 편집 | 파일 하나의 정확하고 유일하며 겹치지 않는 텍스트 영역 교체 |
검색 결과와 읽기는 의도적으로 제한됩니다. 잘린 출력이 전체라고 가정하지 말고 오프셋부터 계속하거나 검색을 좁히도록 요청하세요.
터미널 도구
터미널은 포그라운드 셸 명령이나 관리 백그라운드 프로세스를 실행합니다. 관리 프로세스는 목록, 폴링, 로그, 대기, 입력 기록/제출, 입력 닫기, 종료 같은 수명 주기 동작을 지원합니다.
요청 예:
In this Workspace, find every reference to the old setting and show me the affected files. Do not edit anything.
Run the focused tests for this package. If they pass, update the two affected files and summarize the diff.
파일 변경
write와 edit는 요청 변경을 직접 적용합니다. write는 없는 상위 디렉터리를 만들고 edit는 각 교체가 유일하고 겹치지 않는 영역과 일치해야 합니다. 잘못된 소스 문법도 추가 문법 검사 없이 요청대로 기록됩니다.
상대 경로는 도구 작업 디렉터리에서 결정됩니다. 절대 경로, 상위 디렉터리 경로, 일반 심볼릭 링크는 파일 시스템 의미를 따릅니다. 워크스페이스는 컨텍스트이며 파일 접근을 한 디렉터리로 제한하지 않습니다. 운영체제 권한은 계속 적용됩니다.
같은 대상의 변경은 순서대로 대기합니다. I/O 시작 후 파일 작업이 실패·취소되면 재시도 전에 파일을 확인하세요. 완료 효과는 자동 롤백되지 않습니다.
작업 방식
- 현재 상태를 확인하고 설명하도록 요청합니다.
- 관련 경로를 지정해 구체적 변경을 요청합니다.
- 결과 diff를 검토합니다.
- 집중 검증을 실행합니다.
런타임과 의존성
로컬 bash 도구는 Anyy 호스트에서 구성 셸이나 사용 가능한 bash를 실행하며 /bin/sh를 대체로 씁니다. 명령에는 해당 환경의 실행 파일, 인터프리터, 자격 증명이 필요합니다. 클라이언트 컴퓨터의 명령이 상주 호스트에도 있다고 보장하지 않습니다.
grep은 rg, find는 fd 또는 fdfind를 사용합니다. 프로필 bin/ 후 PATH를 확인하며 누락 도우미를 공식 릴리스에서 받을 수 있습니다. ANYY_OFFLINE=1은 설치 도우미 사용을 허용하며 획득만 끕니다. Android는 획득을 건너뜁니다. 검색 도우미 가용성을 참조하세요.
기본으로 처음 선택되는 이식 가능한 파일 도구는 read, bash, edit, write입니다. grep, find, ls는 별도 선택하거나 조건이 맞으면 활성 Codemode로 호출할 수 있습니다. 실제 선택은 현재 카탈로그를 사용하세요.
결과·프로세스 로그 노출 전에 알려진 자격 증명을 가립니다. 모델 표시 출력과 프로그램 반환은 별도 한도입니다. 예를 들어 Codemode tools.bash는 output, truncated, exit_code, wall_time_seconds를 반환합니다. 1 MiB 초과 출력은 앞/뒤 값과 full_output_path를 유지합니다. 0 아닌 종료도 객체로 정상 반환될 수 있으니 exit_code를 확인하세요. 텍스트 읽기 이어 읽기 안내를 따르거나 유효 논리 결과 참조로 tool_result_read를 쓰세요.
백그라운드 프로세스
서버, 감시기, 장시간 테스트에는 관리 프로세스를 사용하세요. 프로세스 세션 핸들을 보고하고 폴링·로그 확인 후 작업 종료 시 중지하도록 요청하세요. 프로세스는 시작 대화에 속하므로 다른 대화는 입력 전송, 로그 읽기, 중지를 할 수 없습니다.
기본 한도는 프로필 전체 대화에서 관리 백그라운드 프로세스 네 개입니다. 포그라운드 셸 명령은 한도 밖입니다. 종료 작업에 다시 신호를 보내지 않습니다. 상주 재시작 후 저장 PID만으로 제어를 복구할 수 없으며 이전 ID로 종료하지 않고 제어 불가를 보고합니다.
독립 에이전트 작업은 백그라운드 작업을 참조하세요.