overthinkos/remove
core/skills/remove/SKILL.md
Remove service container, quadlet file, and charly.yml entry. MUST be invoked before any work involving: charly remove command, cleaning up containers, removing quadlets, or purging volumes.
data-ai
Updated Jun 27, 2026
$ install --global
skillsauthnpx skillsauth add overthinkos/overthink-plugins removeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 27, 2026, 5:29 AM100.0s1 file scanned
SKILL.md
- name:
- remove
- description:
- |
- MUST be invoked before any work involving:
- charly remove command, cleaning up containers, removing quadlets, or purging volumes.
charly remove -- Remove Service Container
Overview
Removes a service container along with its quadlet file and charly.yml entry. Optionally purges named volumes and runs lifecycle hooks before removal.
Quick Reference
| Action | Command | Description |
|--------|---------|-------------|
| Remove container | charly remove <image> | Remove container, quadlet, and deploy entry |
| Purge volumes | charly remove <image> --purge | Also remove named volumes |
| Keep deploy entry | charly remove <image> --keep-deploy | Keep charly.yml entry for re-configuration |
| With env vars | charly remove <image> -e KEY=VALUE | Pass env vars to pre_remove hooks |
Usage
# Remove a service (container + quadlet + charly.yml entry)
charly remove jupyter
# Remove and purge all named volumes
charly remove ollama --purge
# Remove but keep charly.yml entry for later re-configuration
charly remove immich --keep-deploy
# Pass environment variables to pre_remove hooks
charly remove openclaw -e CLEANUP_MODE=full
Flags
| Flag | Description |
|------|-------------|
| --purge | Also remove named volumes associated with the image |
| --keep-deploy | Preserve the charly.yml entry (useful for re-running charly config) |
| -e, --env KEY=VALUE | Pass environment variables to pre_remove lifecycle hooks |
Behavior
- Runs
pre_removelifecycle hooks (if defined in image labels) - Stops the container if still running
- Removes the quadlet file (quadlet mode) or container (direct mode)
- Removes the charly.yml entry (unless
--keep-deploy) - With
--purge: removes named volumes (charly-<image>-<name>)
Lifecycle Hooks
Images can define pre_remove hooks that run before the container is removed. These are useful for graceful shutdown, data export, or cleanup tasks. Use -e to pass context to hooks.
Instance Removal
Remove specific instances with -i:
charly remove selkies-desktop -i 192.241.92.221 # Remove instance
charly remove selkies-desktop -i 192.241.92.221 --purge # Also purge volumes
Instance removal automatically cleans the instance's env_provide and mcp_provide from charly.yml provides section. Other instances of the same base image are unaffected.
Cross-References
-
/charly-build:pull-- Prerequisite: fetch the image into local storage; handles remote refs (@github.com/...) and theErrImageNotLocalrecovery path -
/charly-core:stop-- Stop without removing -
/charly-core:charly-config-- Configure/reconfigure services (see "Full instance removal" for 3-step cleanup) -
/charly-core:deploy-- Deploy.yml management, tunnel configuration -
/charly-core:service-- Full service lifecycle -
/charly-build:charly-mcp-cmd-- aftercharly config removecleans this instance'smcp_providefrom the globalprovides.mcp:list, consumers'CHARLY_MCP_SERVERSno longer lists it; usecharly check live <consumer> --filter mcpto confirm the cleanup propagated
Related Skills
overthinkos/plugin
tools
VerifiedTrustedCommunity
Use when authoring or modifying a charly PLUGIN — a candy with a `plugin:` block that contributes Providers (verbs/kinds/deploy-targets/steps/builders/commands), its own CUE schema, builtin (compiled-in) or external (out-of-tree git repo). Covers the unified Provider model, the per-plugin CUE-schema contract (single source → Go params for dev + schema-over-Describe RPC for runtime), the SDK, and the loader.
SKILL.mdUpdated Jun 22, 2026
overthinkos/cue
tools
VerifiedTrustedCommunity
The CUE data-validation / configuration CLI (cue), pinned to v0.16.1. Use when working with the cue candy, installing the cue binary into a box or onto a target:local dev host, or running the offline schema-vendoring pipeline that feeds charly's egress validation.
SKILL.mdUpdated Jun 16, 2026
overthinkos/egress
tools
VerifiedTrustedCommunity
CUE EGRESS validation — validating (and, where it adds value, generating) the config files charly WRITES to a system BEFORE the bytes hit disk. MUST be invoked before working on charly/egress.go, the vendored schemas under candy/plugin-egress/egress-schemas/vendor/, the ValidateEgress / registerVendoredEgressKind path, the offline `task cue:vendor` pipeline, or adding an egress schema for any written artifact (cloud-init, k8s manifests, traefik routes, runtime config, install ledger, systemd/quadlet units, ssh_config, libvirt XML).
SKILL.mdUpdated Jun 16, 2026
overthinkos/check-k8s
tools
VerifiedTrustedCommunity
Kubernetes cluster-probe declarative check verb — the `kube:` check verb (nodes, pods, ingress, storage class, addon health, apply/delete, and arbitrary resource GETs) served out-of-process by the candy/plugin-kube plugin (vendored client-go; no external kubectl required).
SKILL.mdUpdated Jun 14, 2026