15. Panel Management

Naia uses a modular panel system. You can install community or custom panels beyond the built-in ones to extend functionality.

Built-in Panels

Panels included with the app, always available:

Installing Panels

Ask the AI avatar to install custom panels from Git or Zip files.

Install from Git

"Install the panel from https://github.com/example/my-panel.git"

The AI clones the repository to ~/.naia/panels/my-panel/ and registers it automatically.

Install from Zip

"Install the panel from /tmp/my-panel.zip"

The AI extracts and registers the panel.

Installation Requirements

Installed panels must include a panel.json manifest file:

{
  "id": "my-panel",
  "name": "My Panel",
  "description": "Panel description",
  "version": "1.0.0",
  "entrypoint": "index.html"
}

Installation is cancelled if panel.json is missing.

Managing Panels

Ask the AI avatar to manage panels in chat:

• "Show installed panels" → Lists all built-in + installed panels
• "Switch to my-panel" → Activates the panel
• "Remove my-panel" → Removes installed panel

Installation Location

Custom panels are stored in the ~/.naia/panels/ directory. Each panel has its own subdirectory:

~/.naia/panels/
├── my-panel/
│   ├── panel.json
│   └── index.html
└── another-panel/
    ├── panel.json
    └── ...

Note: Installation fails if a panel with the same name already exists. Remove the existing panel first, then reinstall.