App Files And APIs

Read, discover, and modify app files via space.api helpers.

1.4k|316|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/agent0ai/space-agent --skill app-files-and-apis-agent0ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: App Files And APIs
Source: https://github.com/agent0ai/space-agent/tree/main/app/L0/_all/mod/_core/skillset/ext/skills/development/app-files-apis
Command: npx skills add https://github.com/agent0ai/space-agent --skill app-files-and-apis-agent0ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps frontend code use the authenticated app-file and API surface correctly, avoiding unsafe path assumptions and permission mistakes when reading, writing, discovering, or downloading app data.

Core Features & Use Cases

  • Permission-aware file operations: Use space.api wrappers for listing, reading, writing (including incremental edits), deleting, copying, and moving app files.
  • Indexed discovery and pattern matching: Discover files with server-side file_paths using patterns and optional writable-only constraints.
  • User identity and scope: Snapshot the current user via userSelfInfo and apply logical path rules for ~, L1, and L2.
  • Secure downloads and preflight checks: Generate authenticated folder download URLs and optionally preflight with fileInfo or folder_download HEAD.
  • Git history workflows (if enabled): Leverage gitHistoryList/diff/preview/rollback/revert on writable history roots when CUSTOMWARE_GIT_HISTORY=true.

Quick Start

Use the App Files And APIs skill to list the current user's writable files under L2/alice/ and then append a line to a target log file using the appropriate space.api helpers.

Frequently Asked Questions about App Files And APIs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read and write app files safely from a browser frontend?▼

Permission-aware app file operations from the browser use space.api wrappers to handle CRUD actions safely. These helpers enforce logical app-rooted paths and layer rules to prevent unsafe path assumptions.

How do I discover frontend API files using pattern matching?▼

Server-indexed discovery endpoints enable pattern-based file discovery using file_paths. You apply optional writable-only constraints to locate specific app files without directly querying disk paths.

Can I generate authenticated download URLs for app folders?▼

You can generate authenticated folder download URLs for app data. Perform a preflight check using fileInfo or folder_download HEAD requests to verify access and availability before downloading.

Does this approach support incremental text edits to app files?▼

The space.api helpers support incremental text edits to app files. This allows frontend workflows to append lines or modify specific content within a file without rewriting the entire document.

What are the limitations when accessing user identity and file scopes?▼

File access is constrained by user identity snapshots from userSelfInfo and logical path rules for ~, L1, and L2 scopes. You must respect these layer constraints and rely on server-indexed endpoints rather than disk paths.

How do I interact with git history for writable app files?▼

Git history workflows use gitHistoryList, diff, preview, rollback, and revert functions on writable history roots. This capability is only available when the CUSTOMWARE_GIT_HISTORY setting is enabled.