privateapp
Personal PWA dashboard server with plugin apps. Use when: (1) installing or setting up PrivateApp, (2) starting/stopping/restarting the service, (3) building frontends after changes, (4) adding new app plugins, (5) configuring push notifications. Requires Python 3.9+, Node.js 18+. Runs as systemd user service or launchd plist.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/camopel/privateappWhat This Skill Does
PrivateApp is a robust, self-hosted Personal PWA (Progressive Web Application) dashboard designed to centralize personal computing tasks. It features a high-performance FastAPI backend coupled with a modern React/Vite frontend. PrivateApp functions as a modular platform, allowing users to load custom apps, monitor system health, and manage file operations directly from their local server. By design, it bridges the gap between powerful server-side operations and mobile-friendly web accessibility, ensuring your personal digital tools are available from anywhere via a unified interface.
Installation
Installation is streamlined for systems meeting the minimum requirements (Python 3.9+, Node.js 18+). To install, clone the repository from GitHub into your workspace using git clone https://github.com/camopel/PrivateApp.git. Once cloned, navigate to the project directory and execute the primary setup script: bash scripts/install.sh. This script automates venv creation, frontend builds, and system service registration. Afterward, customize your setup by copying scripts/config.example.json to scripts/config.json, where you can define your server host, port, and data directory paths.
Use Cases
- System Monitoring: Track real-time CPU, RAM, and GPU usage metrics through the
sysmondashboard app. - File Management: Securely browse, preview, and share files across your local filesystem using the
filesapp. - Custom Automation: Build and integrate custom micro-apps (e.g., home automation controllers, task trackers, or personal note-takers) by following the PrivateApp plugin architecture.
- Mobile Notifications: Receive critical system alerts on your mobile device through the built-in VAPID-compliant push notification system.
Example Prompts
- "PrivateApp: Please restart the background service so the latest changes to the system monitor take effect."
- "PrivateApp: Walk me through the steps to create a new plugin app for tracking my grocery inventory, including the required folder structure."
- "PrivateApp: Build the frontend for all installed plugins so my dashboard interface is up to date."
Tips & Limitations
- Security: Since PrivateApp exposes system files and settings, ensure you secure your host machine and network appropriately.
- Development: When building new apps, always ensure your input font-size is at least 16px to prevent iOS auto-zoom behavior on inputs.
- Persistence: All application-specific data is stored within the configured
data_dir(~/.local/share/privateapp). Ensure this directory is included in your routine backups. - Builds: If you modify CSS or frontend logic, you must manually run the build script or use the install script to recompile the React assets, otherwise, your changes will not reflect in the UI.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-camopel-privateapp": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, code-execution
Related Skills
ddgs-search
Free multi-engine web search via ddgs CLI (DuckDuckGo, Google, Bing, Brave, Yandex, Yahoo, Wikipedia) + arXiv API search. No API keys required. Use when user needs web search, research paper discovery, or when other skills need a search backend. Drop-in replacement for web-search-plus.
finviz-crawler
Continuous financial news crawler for finviz.com with SQLite storage, article extraction, and query tool. Use when monitoring financial markets, building news digests, or needing a local financial news database. Runs as a background daemon or systemd service.
arxivkb
Local arXiv paper manager with semantic search. Crawls arXiv categories, downloads PDFs, chunks content, and indexes with FAISS + Ollama embeddings. No cloud API keys required — everything runs locally.
storage-cleanup
One-command disk cleanup for macOS and Linux — trash, caches, temp files, old kernels, snap revisions, Homebrew, Docker, and Xcode artifacts. Use when user asks to free storage, clean up disk, reclaim space, reduce disk usage, or encounters low disk / "disk full" warnings. Safe by default with dry-run mode. No dependencies beyond bash and awk.
claw-guard
System-level watchdog for OpenClaw gateway restarts and sub-agent task PIDs. Monitors registered PIDs and optional log/directory freshness. Auto-reverts config on failed gateway restarts. Requires explicit registration — does NOT auto-discover. Use when running long background tasks or before gateway restarts.