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.