본문 바로가기
WIKI 기술 지식 베이스

CLI 참조

원문 보기 위키 갱신

agentfs 명령줄 도구의 전체 참조예요.

출처: 문서

본문

최신 참조는 저장소의 MANUAL.md에서 확인할 수 있어요.

설치

curl -fsSL https://github.com/tursodatabase/agentfs/releases/latest/download/agentfs-installer.sh | sh

명령

agentfs init

새 에이전트 파일시스템을 초기화해요.

agentfs init [OPTIONS] [ID]

인자:

  • ID - 에이전트 식별자 (기본값: agent-{timestamp})

옵션:

옵션 설명
--force 기존 에이전트 파일시스템 덮어쓰기
--base <PATH> 오버레이 파일시스템의 베이스 디렉터리
--sync-remote-url <URL> 원격 Turso 데이터베이스 URL

예제:

agentfs init my-agent
agentfs init my-overlay --base /path/to/project

agentfs run

샌드박스 환경에서 프로그램을 실행해요.

agentfs run [OPTIONS] <COMMAND> [ARGS]...

옵션:

옵션 설명
--session <ID> 영속성을 위한 이름 붙은 세션
--allow <PATH> 디렉터리에 쓰기 접근 허용
--no-default-allows 기본 허용 디렉터리 비활성화
--experimental-sandbox ptrace 샌드박스 사용 (Linux)
--strace 가로챈 시스템 콜 표시

예제:

agentfs run /bin/bash
agentfs run --session my-project python3 agent.py
agentfs run --allow /tmp --allow ~/.cache /bin/bash

agentfs mount

에이전트 파일시스템을 마운트하거나 마운트 목록을 보여줘요.

agentfs mount [OPTIONS] [ID_OR_PATH] [MOUNT_POINT]

인자 없이 실행하면 마운트된 모든 파일시스템을 나열해요.

옵션:

옵션 설명
-a, --auto-unmount 종료 시 자동으로 언마운트
--allow-root root 사용자 접근 허용
-f, --foreground 포어그라운드로 실행
--uid <UID> 파일의 사용자 ID
--gid <GID> 파일의 그룹 ID

예제:

agentfs mount                              # List mounts
agentfs mount my-agent ./mnt               # Mount agent
agentfs mount my-agent ./mnt -a -f         # Foreground with auto-unmount

언마운트:

  • Linux: fusermount -u <MOUNT_POINT>
  • macOS: umount <MOUNT_POINT>

agentfs serve mcp

MCP (Model Context Protocol) 서버를 시작해요.

agentfs serve mcp <ID_OR_PATH> [OPTIONS]

옵션:

옵션 설명
--tools <TOOLS> 쉼표로 구분된 도구 목록

사용 가능한 도구:

카테고리 도구
Filesystem read_file, write_file, readdir, mkdir, remove, rename, stat, access
Key-Value kv_get, kv_set, kv_delete, kv_list

예제:

agentfs serve mcp my-agent
agentfs serve mcp my-agent --tools read_file,readdir,stat

agentfs serve nfs

NFS 서버를 시작해요.

agentfs serve nfs <ID_OR_PATH> [OPTIONS]

옵션:

옵션 설명
--bind <IP> 바인딩할 IP (기본값: 127.0.0.1)
--port <PORT> 포트 (기본값: 11111)

예제:

agentfs serve nfs my-agent --bind 0.0.0.0 --port 2049

마운트:

mount -t nfs -o vers=3,tcp,port=11111,mountport=11111,nolock localhost:/ /mnt

agentfs sync

원격 Turso 데이터베이스와 동기화해요.

agentfs sync <ID_OR_PATH> <SUBCOMMAND>

하위 명령:

명령 설명
pull 원격 변경 가져오기
push 로컬 변경 내보내기
stats 동기화 통계 보기
checkpoint 체크포인트 만들기

예제:

agentfs sync my-agent pull
agentfs sync my-agent push

agentfs fs

에이전트 데이터베이스에 대한 파일시스템 작업이에요.

agentfs fs ls

agentfs fs ls <ID_OR_PATH> [FS_PATH]

파일을 나열해요. 출력은 파일은 f <name>, 디렉터리는 d <name> 형식이에요.

agentfs fs cat

agentfs fs cat <ID_OR_PATH> <FILE_PATH>

파일 내용을 표시해요.

agentfs fs write

agentfs fs write <ID_OR_PATH> <FILE_PATH> <CONTENT>

파일에 내용을 기록해요.

예제:

agentfs fs ls my-agent
agentfs fs cat my-agent /config.json
agentfs fs write my-agent /hello.txt "Hello, world!"

agentfs diff

오버레이 모드에서 파일시스템 변경 사항을 보여줘요.

agentfs diff <ID_OR_PATH>

agentfs timeline

에이전트 동작 타임라인을 표시해요.

agentfs timeline [OPTIONS] <ID_OR_PATH>

옵션:

옵션 설명
--limit <N> 항목 수 제한 (기본값: 100)
--filter <TOOL> 도구 이름으로 필터
--status <STATUS> 필터: pending, success, error
--format <FORMAT> 출력: table, json

예제:

agentfs timeline my-agent
agentfs timeline my-agent --filter web_search --status error
agentfs timeline my-agent --format json

agentfs completions

셸 자동 완성을 관리해요.

agentfs completions install [SHELL]
agentfs completions uninstall [SHELL]
agentfs completions show

지원 셸: bash, zsh, fish, powershell

환경 변수

샌드박스 안에서 설정되는 변수예요:

변수 설명
AGENTFS 샌드박스 안에서 1로 설정됨
AGENTFS_SANDBOX 샌드박스 유형
AGENTFS_SESSION 세션 ID

파일

경로 설명
.agentfs/<ID>.db 에이전트 파일시스템 데이터베이스
~/.config/agentfs/ 설정 디렉터리

더 알아보기 (Learn more)