afslisted

# afs - Agent-First File Operations CLI CLI tool for AI Agents to perform local file operations and cloud storage synchronization with S3-compatible providers. ## Quick start **Install**: ```bash curl -fsSL https://raw.githubusercontent.com/geekjourneyx/agent-fs/main/scripts/install.sh | bash ``` **Basic usage**: ```bash # Get file info afs local info /path/to/file # Read file with slicing (Token-aware) afs local read /path/to/log --tail 50 # Create and extract archives afs local zip /data --out backup.zip afs local unzip backup.zip --dest /restore # Cloud operations afs cloud upload file.txt remote/path/ afs cloud list remote/ --limit 20 afs cloud url remote/file.txt --expires 3600 # Generate access URL afs cloud providers # List supported providers ``` ## Commands | Command | Purpose | |---------|---------| | `afs local zip` | Create zip archive from file/directory | | `afs local unzip` | Extract zip archive to destination | | `afs local info` | Get file/directory metadata | | `afs local read` | Read file with slicing options | | `afs cloud upload` | Upload to S3-compatible storage | | `afs cloud download` | Download from cloud storage | | `afs cloud list` | List objects in cloud storage | | `afs cloud url` | Generate access URL (Presigned URL or Public URL) | | `afs cloud providers` | List supported cloud storage providers | | `afs config` | Manage configuration | ## Local operations ### Get file/directory info ```bash # File info afs local info /path/to/file