rundesk-ai/rundesk-cli / src/skills/managing-rundesk
managing-rundesk
VerifiedUse when managing this agent, any other agent in its Rundesk install, or the install itself. It supplies verified operational workflows and safety rules for agent instructions, gateways, conversations, channels, schedules, providers, skills, backups, configuration, credentials, and the Rundesk lifecycle. Do not use for ordinary project work or for deciding, performing, or reviewing delegation.
Manage Rundesk
Use Rundesk's commands to answer questions about this install. Do not guess at its state or paths.
Use the right install
Run "$RUNDESK_COMMAND", never bare rundesk. It is the absolute command for the install running
this turn. $RUNDESK_HOME already points to that install; do not change it or introduce another
location.
"$RUNDESK_COMMAND" status
"$RUNDESK_COMMAND" --help
Treat generated help as authoritative. If a verb is absent, Rundesk cannot perform it. A command
exits 0 when it answered or completed, 1 when understood but not completed, and 2 for invalid
command syntax. Never report success from wording alone; read the exit code and result.
Common entry points
| Priority | Need | Command |
|---|---|---|
| 1 | Prove which install this is and whether it is healthy | "$RUNDESK_COMMAND" status |
| 2 | See the agents and their providers | "$RUNDESK_COMMAND" agents |
| 3 | See whether gateways are running | "$RUNDESK_COMMAND" gateways |
| 4 | Explain gateway trouble | "$RUNDESK_COMMAND" gateways logs <agent> |
| 5 | Check provider, channel, and skill readiness | "$RUNDESK_COMMAND" providers check <provider> · "$RUNDESK_COMMAND" channels doctor <agent> · "$RUNDESK_COMMAND" skills doctor <agent> |
| 6 | Protect approved risky work | "$RUNDESK_COMMAND" backups save |
Choose the narrowest command that answers the request. Before a mutation, inspect only enough state to identify the exact target and consequence. Most groups list when called with no subcommand.
Safety boundaries
- Never open or edit Rundesk databases, conversation records, or lock files directly. If a command fails, use documented read-only surfaces or report it; do not bypass the command with file tools.
- Never stop your own gateway. Restarting it is allowed: Rundesk queues the restart until the active turn finishes, then brings the gateway back online.
- Require an explicit request for agent removal, schedule removal, backup restore, uninstall, purge, or forced gateway shutdown. Name the exact target.
- Run a guarded command without
--confirmfirst when it offers a preview. Add--confirmonly after the preview matches the request. - Save a backup before an approved destructive change. A backup contains the sealed credential store and its key, so protect its location as credential-bearing data.
- Never ask for a credential in chat or pass one as an argument. Tell the owner to run
"$RUNDESK_COMMAND" env set <NAME>in their own terminal. - Prefer diagnosis before restart: inspect status, listings, logs, and the relevant
doctororcheckcommand.
Read only the reference you need
| Area | Read for |
|---|---|
| Agents | Add, describe, reassign, or remove agents |
| Agent instructions | Design or change persistent agent behavior |
| Gateways | Start, stop, restart, run, inspect, or recover gateways |
| Conversations | Ask agents; inspect messages, turns, usage, and failures; search the platforms an agent is connected to |
| Backups | Save, locate, move, or restore copies |
| Schedules | Create timed work and proactive verification check-ins |
| Channels | Connect adapters, access lists, notifications, and diagnosis |
| Providers | Discover, check, or inspect provider execution |
| Skills | Catalogs, grants, profiles, values, and skill diagnosis |
| Maintenance | Focused upkeep of this agent's memory, indexes, and home workspace |
| Retrospective | Write the bounded usage-cycle diary from evidence and compare prior improvements |
| Self-improvement | Review proven friction, continuity, capability gaps, and skills |
| Configuration | Status, version, install settings, and secret values |
| Permissions | What macOS lets this install do, and whose grants an answer is about |
| Teams | Install and reconcile version-controlled agent teams |
| OAuth login | Configure an installed provider; connect, select, extend, or recover accounts |
| Lifecycle | Install, update, uninstall, and purge |
Use "$RUNDESK_COMMAND" <group> --help when exact help and a reference disagree. Report the command's
answer, including uncertainty or refusal, without translating it into a success it did not earn.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |