App

In UClaw, an App (represented by App in the runtime) is the logical top-level container for your AI agent infrastructure. It acts as a multi-agent directory, coordinating configurations, secrets, and shared sandbox environments.

Core Responsibilities

An App handles several crucial infrastructure roles:

1. Agent Directory: Maintains the active directory of child agent instances, their metadata (creation dates, titles), and message previews.
2. Access Control & Routing: Intercepts connections and verifies short-lived Client Tokens before letting clients connect to specific agents.
3. Shared Secrets: Securely stores API keys and credentials at the application level, allowing agents to pull secrets without hardcoding them.
4. Environment Isolation: Orchestrates environment definitions so agents under the same app can share or separate sandbox filesystems.

App Instance Life Cycle

An App is instantiated dynamically inside UClaw's globally distributed runtime based on your App ID (defaults to default). It coordinates resources, routes client connections, and manages the lifecycle of your agents.

For details on how clients interact with this directory, refer to the useApp React hook or the AppClient SDK documentation.