| name | component-management |
| description | Guidelines for managing zylos components via CLI and C4 channels. Use when installing, upgrading, or uninstalling components, or when user asks about available components. |
Component Management
Guidelines for installing, upgrading, and managing zylos components.
CLI
zylos is a global npm command (installed via npm install -g zylos).
Run it directly as zylos, NOT as ~/zylos/zylos or ./zylos.
General Principles
- Always confirm before executing - User must explicitly approve install/upgrade/uninstall
- Guide interactively - Never just tell user to "manually edit files"
- Read SKILL.md - Each component declares its requirements in SKILL.md frontmatter
- Detect execution mode - Handle both Claude session and C4 channels differently
- CLI = mechanical, Claude = intelligent - CLI handles downloads, backups, file sync. Claude handles config, hooks, service management, user interaction.
Workflows
Detailed step-by-step workflows for each operation (Session + C4 modes):
- Install — Add new components
- Upgrade — Upgrade components and zylos-core (self-upgrade)
- Uninstall — Remove components with data options
Quick Commands
zylos --version
zylos list
zylos search <keyword>
zylos status
zylos upgrade --self --check
zylos upgrade --self --check --beta
zylos upgrade --all --check