Search everything...

Stats

Actions

Available In

desktop-manager

Name: desktop-manager
Author: danielrosehill

By danielrosehill

Linux desktop management workflow — auto-profiles the local machine on first run and persists it to user data, then runs system checks, package install/remove, config application, hardware troubleshooting, and service/log inspection against that profile. Local-only (not remote/server admin).

npx claudepluginhub danielrosehill/claude-code-plugins --plugin desktop-manager

Popularity

Stars

Above avg

Med: 0·Avg: 285

Installs

Med: 0·Avg: 1

What's Inside

Slash Commands8

apply-config

/apply-config

Apply a configuration change (dotfile edit, desktop-environment setting, systemd unit, etc.) with a rollback path. Picks DE-specific tooling based on the machine profile (gsettings/dconf for GNOME, kwriteconfig for KDE). Reads $CLAUDE_USER_DATA/desktop-manager/profile.json.

check-system

/check-system

Snapshot the local desktop — refreshes hardware/storage/uptime against the persisted machine profile and writes a timestamped report. Reads $CLAUDE_USER_DATA/desktop-manager/profile.json.

inspect-service

/inspect-service

Inspect a systemd service or user unit — status, recent logs, failure history, config path. Refuses to run on non-systemd machines (per the machine profile). Reads $CLAUDE_USER_DATA/desktop-manager/profile.json.

install-package

/install-package

Install one or more packages using the package manager recorded in the machine profile (apt, dnf, pacman, zypper, flatpak, snap). Honours `packaging.preferred_for_gui_apps` and `packaging.ask_when_ambiguous`. Reads $CLAUDE_USER_DATA/desktop-manager/profile.json.

remove-package

/remove-package

Remove a package from the local desktop, showing reverse-dependencies first. Uses the package manager recorded in the machine profile. Reads $CLAUDE_USER_DATA/desktop-manager/profile.json.

Skills3

new-workspace

/new-workspace

Provision a new desktop-manager workspace on disk. Use when the user wants a persistent scaffold for managing their local Linux desktop (tracking installs, config changes, hardware issues, log reviews). Accepts a workspace name and optional target parent path. Scaffolds the workspace, personalises CLAUDE.md from the user's global memory, and (by default) creates a public GitHub repo.

onboard

/onboard

First-run onboarding for the desktop-manager plugin. Auto-profiles the local Linux desktop (distro, kernel, desktop environment, session type, package managers, audio stack, GPU, hardware summary), then interviews the user for the small handful of things that can't be auto-detected (sudo policy, GUI-app packaging preference, hardware quirks, services of interest), and persists the result to `$CLAUDE_USER_DATA/desktop-manager/profile.json`. Run this before any other skill in this plugin, or whenever the machine changes (distro upgrade, new GPU, switched DE, etc.). Triggers on phrases like "set up desktop manager", "onboard desktop", "profile this machine".

update-profile

/update-profile

Surgical edits to the desktop-manager machine profile without re-running full onboarding. Use when a single field changed — e.g. user upgraded distro, switched from X11 to Wayland, swapped GPU, changed sudo policy, added a service to watch, recorded a new hardware quirk. Reads and writes `$CLAUDE_USER_DATA/desktop-manager/profile.json`. Triggers on phrases like "update desktop profile", "I switched to wayland", "add a quirk", "change sudo mode".

The plugin manifest points to a different repository than the source indexed by ClaudePluginHub.

Stats

Version2.0.0

Stars1

MaintenanceGood

LicenseMIT

Last CommitApr 30, 2026

AddedApr 21, 2026

Actions

View on GitHub View README Plugin Marketplace JSON

Own this plugin?

Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).

Available In

danielrosehill11

README

desktop-manager-plugin

Claude Code plugin for managing a local Linux desktop workstation. v2.0 introduces a per-machine profile that's auto-detected on first run, persisted to user data (outside the plugin tree), and consulted by every command — so you stop re-answering "what distro is this" and Claude stops guessing wrong.

Scope is explicitly local desktop only. Remote server/homelab admin lives in the separate sysadmin-homelab plugin.

Part of the danielrosehill Claude Code marketplace.

How it works

First run: /desktop-manager:onboard auto-profiles the machine (distro, kernel, DE, session type, audio stack, package managers, GPU) and asks a few quick questions for the things it can't detect (sudo policy, GUI-app packaging preference, hardware quirks, services to surface).
Profile is persisted to $CLAUDE_USER_DATA/desktop-manager/profile.json (falling back to $XDG_DATA_HOME/claude-plugins/desktop-manager/ and then ~/.local/share/claude-plugins/desktop-manager/). It lives outside the plugin install tree, so plugin upgrades don't touch it and it doesn't get committed to git.
Every command reads the profile and uses it instead of re-detecting. KDE+Wayland boxes get wlr-randr and kwriteconfig; GNOME+X11 boxes get xrandr and gsettings; pipewire boxes get wpctl flows.
Surgical edits: /desktop-manager:update-profile <field> [value] for one-off changes (e.g. you switched to Wayland, swapped GPU, added a new service to watch).

Skills

/desktop-manager:onboard — auto-profile + interview, persist profile.json. Run on first install or when the machine changes.
/desktop-manager:update-profile — surgical field edits.
/desktop-manager:new-workspace <name> [<target-path>] [--local-only] [--private] — scaffold a workspace on disk for tracking install / config / hw-triage notes over time.

Commands

All commands refuse to run without a profile.json and point you at /desktop-manager:onboard.

/desktop-manager:check-system — live snapshot anchored against the recorded profile, flags drift.
/desktop-manager:install-package — install via the recorded package manager(s); honours your GUI-app preference and ambiguity policy.
/desktop-manager:remove-package — reverse-deps first, then remove.
/desktop-manager:update-system — refresh + upgrade across native + flatpak + snap; honours auto_reboot_after_update.
/desktop-manager:apply-config — DE-aware config change with rollback path (KDE / GNOME / XFCE / MATE / direct file).
/desktop-manager:inspect-service — systemd unit status + logs + failure signatures (refuses on non-systemd).
/desktop-manager:review-logs — journalctl + dmesg filtered for errors; surfaces services_of_interest.
/desktop-manager:troubleshoot-hardware — class-based probes (audio/display/usb/bt/net/input), variant-picked from profile.

Profile schema

See lib/PROFILE.md for the full schema and field semantics.

Install

/plugin marketplace add danielrosehill/Claude-Code-Plugins
/plugin install desktop-manager
/desktop-manager:onboard

License

MIT.

Similar Plugins

planning-with-files

23.4k·81·

Persistent file-based planning for AI coding agents. Crash-proof markdown plans (task_plan.md, findings.md, progress.md) that survive context loss and /clear, with an opt-in completion gate and multi-agent shared state. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60+ agents via the SKILL.md standard. Includes Arabic, German, Spanish, and Chinese (Simplified and Traditional).

v3.1.3

OthmanAdi

nature-skills

20.0k·124·

A growing collection of Claude-compatible academic workflow bundles. Covers scientific figures, manuscript writing and polishing, reviewer assessment, citation retrieval, data availability, paper reading, literature search, response letters, paper-to-PPTX conversion, and evidence-grounded Chinese invention patent drafting. Rules are organized as reusable skill folders with explicit workflows and quality checks.

v1.0.0

Yuan1z0825

drawio-diagramming

12·108·

Intelligent draw.io diagramming plugin with AI-powered diagram generation, multi-platform embedding (GitHub, Confluence, Azure DevOps, Notion, Teams, Harness), conditional formatting, live data binding, and MCP server integration for programmatic diagram creation and management.

2mo

v2.0.0

markus41

ecc

217.3k·2.6K·

Harness-native ECC operator layer - 67 agents, 271 skills, 92 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses

v2.0.0

affaan-m

fullstack-dev-skills

10.0k·455·

Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.

v0.4.15

Jeffallan

claude-md-management

30.2k·425·

Tools to maintain and improve CLAUDE.md files - audit quality, capture session learnings, and keep project memory current.

4mo

v1.0.0

anthropics

desktop-manager

Popularity

What's Inside

Confidence

README