AIFS - HTTP File system
Store and retrieve files via AIFS.space cloud storage API. Use when persisting notes, documents, or data to the cloud; syncing files across sessions; or when the user mentions AIFS, aifs.space, or clo
Store and retrieve files via AIFS.space cloud storage API. Use when persisting notes, documents, or data to the cloud; syncing files across sessions; or when the user mentions AIFS, aifs.space, or clo
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
AIFS.space is a simple HTTP REST API for cloud file storage. Use it to persist files across sessions, share data between agents, or store user content in the cloud.
A human should sign up on https://AIFS.Space and get an API key to provide to you.
Requires API key in headers. Check for key in environment (
AIFS_API_KEY) or user config.
Authorization: Bearer aifs_xxxxx
Key types:
admin (full), read-write, read-only, write-only
https://aifs.space
curl -H "Authorization: Bearer $AIFS_API_KEY" https://aifs.space/api/files
Returns:
{"files": [{"path": "notes/todo.txt", "size": 1024, "modifiedAt": "..."}]}
# Full file curl -H "Authorization: Bearer $AIFS_API_KEY" "https://aifs.space/api/read?path=notes/todo.txt"Line range (1-indexed)
curl -H "Authorization: Bearer $AIFS_API_KEY" "https://aifs.space/api/read?path=notes/todo.txt&start_line=5&end_line=10"
Returns:
{"path": "...", "content": "...", "total_lines": 42, "returned_lines": 10}
Creates directories automatically (max depth: 20).
curl -X POST -H "Authorization: Bearer $AIFS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"notes/new.txt","content":"Hello world"}' \ https://aifs.space/api/write
Returns:
{"success": true, "path": "...", "size": 11, "lines": 1}
Update specific lines without rewriting entire file.
curl -X PATCH -H "Authorization: Bearer $AIFS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"notes/todo.txt","start_line":5,"end_line":10,"content":"replacement"}' \ https://aifs.space/api/patch
Returns:
{"success": true, "lines_before": 42, "lines_after": 38}
curl -X DELETE -H "Authorization: Bearer $AIFS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"path":"notes/old.txt"}' \ https://aifs.space/api/delete
Get first 500 chars of a file.
curl -H "Authorization: Bearer $AIFS_API_KEY" "https://aifs.space/api/summary?path=notes/long.txt"
60 requests/minute per key. Check headers:
X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset| Code | Meaning |
|---|---|
| AUTH_REQUIRED | No auth provided |
| AUTH_FAILED | Invalid key |
| FORBIDDEN | Key type lacks permission |
| RATE_LIMITED | Too many requests |
| NOT_FOUND | File doesn't exist |
| INVALID_PATH | Path traversal or invalid |
| DEPTH_EXCEEDED | Directory depth > 20 |
# Save curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \ -d "{\"path\":\"sessions/$(date +%Y-%m-%d).md\",\"content\":\"# Session Notes\\n...\"}" \ https://aifs.space/api/writeRetrieve
curl -H "Authorization: Bearer $KEY" "https://aifs.space/api/read?path=sessions/2024-01-15.md"
projects/ ├── alpha/ │ ├── README.md │ └── notes.md └── beta/ └── spec.md
# Read existing EXISTING=$(curl -s -H "Authorization: Bearer $KEY" "https://aifs.space/api/read?path=log.txt" | jq -r .content)Append and write back
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json"
-d "{"path":"log.txt","content":"$EXISTING\n$(date): New entry"}"
https://aifs.space/api/write
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.