Skip to content

Panel Apps

A Panel App is a lightweight local application that runs in NextClaw's right side. Dashboards, forms, calculators, data browsers, and temporary workbenches can remain interactive instead of ending as a screenshot or static response.

A Panel App running beside a session

When to use one

  • A data report needs filters and metric switching.
  • A repeated calculation belongs in a form or calculator.
  • Local files need a small persistent browser.
  • Generated HTML should stay usable beside the task.

Create a Panel App

Describe the purpose, data, and interactions:

Turn the current sales analysis into a local Panel App. Add month and product-line filters, and show revenue, margin, and a trend chart. Read the existing analysis-output data without modifying the source CSV files.

The agent can create a .panel.html file or a manifest-backed app and open it for review. Verify the real data, interactions, and narrow-screen layout before keeping it.

App list and references

Manage existing Panel Apps from the app list and reference one from the session composer when asking for changes.

The NextClaw Panel Apps list

Service Apps

When a Panel App needs a local runtime or controlled action, pair it with a Service App. Review every exposed action and permission, and grant only what the app needs.

App data and uninstall

NextClaw keeps installable code separate from mutable App data. Updates replace code while preserving the managed App instance. Uninstalling an App or removing a workspace Service App also keeps that instance by default, so a later reinstall can continue with the same data.

The removal dialog offers two explicit choices:

  • Keep data removes the App and keeps its managed instance.
  • Delete app and data removes both after destructive confirmation.

Before confirming, NextClaw shows the exact managed path and storage used by data, config, state, cache, temporary files, and logs. Retained instances remain visible in the Apps page and can be deleted separately later. Files or folders that you granted to an App outside its managed instance are never deleted by either flow.

For CLI inspection and cleanup, use the running NextClaw host:

bash
nextclaw app data list --json
nextclaw app data delete <data-id> --confirm <app-id> --json

The delete command accepts only retained data. Copy the opaque data id from the latest list output and confirm the exact App id; do not delete the storage directory manually.

Released under the MIT License.