AgentApps

AgentApps

AgentApps are small mini-apps stored inside a repository and rendered in the LatchLoop desktop editor. They are designed for general-agent projects where the agent can create or update lightweight tools that live with the project.

---

What AgentApps are for

Use AgentApps for project-specific interfaces such as:

• calendars
• checklists
• simple dashboards
• data editors
• repository-local tools
• project-specific review surfaces

Because AgentApps are stored in the repository, they can be versioned, reviewed, and edited like normal project files.

---

Where AgentApps live

AgentApps are stored under:

.latchloop/agent-apps/

A repository-level config file controls which apps are enabled:

.latchloop/agent-apps.json

Each app has a manifest and an entry file, usually app.tsx.

---

Permissions

AgentApps run in a sandbox and must declare file permissions in their manifest.

An app can only read or write files that its manifest explicitly allows. This helps keep mini-apps useful without giving them unrestricted access to your repository.

---

Managing AgentApps

In the desktop editor, open the AgentApps panel from the right-side surface.

From there you can:

• view enabled apps
• open AgentApps settings
• enable or disable discovered apps
• open app files in the editor
• reload apps after changes

The main app view is intentionally clean. Management actions live in AgentApps settings rather than inside every running app.

---

Calendar example

LatchLoop includes a Calendar example AgentApp that can be copied into a general-agent repository.

The Calendar app:

• shows a month grid
• lets you add, edit, and delete events
• stores events in a local JSON file
• works without network access
• demonstrates safe read/write permissions

Use it as a starting point for your own repository-local apps.

---

Troubleshooting

No AgentApps appear

• Confirm your repository has .latchloop/agent-apps/ files.
• Confirm .latchloop/agent-apps.json enables at least one app.
• Reload AgentApps from the panel menu.

An AgentApp cannot read or write a file

• Check the manifest permissions.
• Paths beginning with ./ are relative to the AgentApp folder.
• Paths beginning with / are relative to the repository root and require explicit permission.

An AgentApp fails to render

• Open the app source files in the desktop editor.
• Fix any TypeScript or runtime errors.
• Reload the app from the AgentApps panel.