@hasna/files
v0.2.7
Published
Agent-first file management — index local folders and S3 buckets, sync Google Drive, tag, search, and retrieve files via CLI + MCP
Maintainers
Readme
@hasna/files
Agent-first file management — index local folders and S3 buckets, sync Google Drive, tag, search, and retrieve files via CLI + MCP
Install
bun install -g @hasna/filesCLI Usage
files --helpGoogle Drive Sync
Google Drive sync uses profiles configured through the connectors CLI:
connectors auth googledriveAdd an S3 destination once. Google Drive sources auto-use the first enabled S3 source by default:
files sources add s3://my-files-bucket/google-drive --region us-east-1
files sources add-google-drive --all-profiles --all
files sources sync-google-driveTo sync into local storage instead, add a local source and pass it as the destination:
files sources add ~/Files/google-drive-imports --name drive-local
files sources add-google-drive --profile personal --all --destination-source <local-source-id>Synced files are indexed under the actual S3 or local destination source, so
files download, files where, and MCP file tools operate on the stored copy.
MCP Server
files-mcp31 tools available.
REST API
files-serveCloud Sync
This package supports cloud sync via @hasna/cloud:
cloud setup
cloud sync push --service files
cloud sync pull --service filesData Directory
Data is stored in ~/.hasna/files/.
License
Apache-2.0 -- see LICENSE
