System Plugin

1# System Plugin
2 
3**Purpose**: System configuration and health monitoring
4**Category**: System
5**Version**: 1.0.0
6 
7## Overview
8 
9The System plugin provides essential commands for configuring, monitoring, and maintaining Claude Code installations. These are system-level operations that configure or monitor Claude Code itself.
10 
11## Commands (9)
12 
13### /system:status
14**Purpose**: Unified view of work, system, and memory state
15 
16Provides comprehensive status overview including:
17- Active work units and progress
18- Memory system state
19- System configuration health
20- Recent activity summary
21 
22**Usage**:
23```bash
24/system:status              # Standard status view
25/system:status verbose      # Detailed status with full context
26```
27 
28### /config
29**Purpose**: Manage Claude Code configuration settings
30 
31Interactive configuration management:
32- View current settings
33- Update configuration
34- Reset to defaults
35- Validate configuration
36 
37**Usage**:
38```bash
39/config              # View current configuration
40/config set key=value
41/config reset
42```
43 
44### /setup:python
45**Purpose**: Initialize Python projects with Claude Code framework
46 
47Sets up Python project with configurable quality levels:
48- Creates modern `pyproject.toml` with development tools
49- Configures testing, linting, and type checking
50- Sets up `.claude/` directory structure
51- Initializes project memory and configuration
52 
53**Options**:
54```bash
55/setup:python                    # Standard setup (production-ready)
56/setup:python --minimal          # Basic structure only
57/setup:python --standard         # Standard with pytest, ruff, mypy (default)
58/setup:python --full             # Comprehensive with docs, CI/CD
59/setup:python my-project         # Create new project with name
60```
61 
62### /setup:javascript
63**Purpose**: Initialize JavaScript/Node.js projects with Claude Code framework
64 
65Sets up JavaScript project with modern tooling:
66- Creates `package.json` with Jest, ESLint, Prettier
67- Configures testing and code quality tools
68- Sets up `.claude/` directory structure
69- Initializes project memory and configuration
70 
71**Usage**:
72```bash
73/setup:javascript                # Initialize JavaScript project
74/setup:javascript my-app         # Create new project with name
75```
76 
77### /setup:existing
78**Purpose**: Add Claude Code framework to existing projects
79 
80Detects project type and adds appropriate framework structure:
81- Auto-detects Python or JavaScript projects
82- Creates `.claude/` directory structure without modifying existing files
83- Initializes configuration and memory system
84- Preserves all existing project structure
85 
86**Usage**:
87```bash
88/setup:existing                  # Auto-detect and setup
89```
90 
91### /setup:user
92**Purpose**: Initialize user-level Claude Code configuration
93 
94Sets up global Claude Code configuration in `~/.claude/`:
95- Creates user-level `CLAUDE.md` with best practices
96- Initializes global memory templates
97- Configures user preferences
98 
99**Options**:
100```bash
101/setup:user                      # Initialize user config
102/setup:user --force              # Overwrite existing config
103```
104 
105### /setup:statusline
106**Purpose**: Configure Claude Code statusline display
107 
108Sets up statusline to show framework information:
109- Configures statusline format
110- Shows active work unit
111- Displays memory state
112 
113**Usage**:
114```bash
115/setup:statusline                # Configure statusline
116```
117 
118### /audit
119**Purpose**: Validate framework compliance and configuration
120 
121Comprehensive framework validation:
122- Configuration compliance checks
123- Directory structure validation
124- Memory system health
125- Work unit integrity
126- Best practices verification
127 
128**Usage**:
129```bash
130/audit                   # Full audit
131/audit --framework       # Framework structure only
132/audit --fix             # Auto-fix issues where possible
133```
134 
135### /cleanup
136**Purpose**: Clean up generated files and temporary data
137 
138Intelligent cleanup operations:
139- Remove Claude-generated clutter
140- Consolidate documentation
141- Archive completed work
142- Free up disk space
143 
144**Options**:
145```bash
146/cleanup --dry-run       # Preview what would be cleaned
147/cleanup --auto          # Auto-cleanup with safe defaults
148/cleanup root            # Clean project root only
149/cleanup tests           # Clean test artifacts
150/cleanup reports         # Clean old reports
151/cleanup work            # Archive completed work units
152/cleanup all             # Comprehensive cleanup
153```
154 
155## Integration
156 
157### Memory System
158- `system:status` command integrates with memory to show context state
159- `audit` validates memory structure and health
160 
161### Work Units
162- `system:status` shows active work unit progress
163- `audit` validates work unit integrity
164- `cleanup` can archive completed work units
165 
166### MCP Tools
167- **Sequential Thinking** (optional): Enhanced status analysis and audit reasoning
168- Graceful degradation when MCP unavailable
169 
170## Use Cases
171 
172### Daily Workflow
173```bash
174/system:status                  # Check what's happening
175# ... do work ...
176/system:status verbose          # Review progress before handoff
177```
178 
179### Project Initialization
180```bash
181/setup:python --standard # Initialize Python project
182/setup:javascript        # Initialize JavaScript project
183/setup:existing          # Add framework to existing project
184/audit                   # Verify setup correct
185```
186 
187### Maintenance
188```bash
189/audit                   # Check framework health
190/cleanup --dry-run       # See what can be cleaned
191/cleanup all             # Clean up clutter
192```
193 
194### Configuration Management
195```bash
196/config                  # Review current settings
197/config set memory.auto_gc=true
198/audit                   # Verify configuration valid
199```
200 
201## Best Practices
202 
203### System Health
204- Run `/system:status` at session start to understand current state
205- Run `/audit` periodically to catch configuration drift
206- Use `/cleanup` when projects accumulate clutter
207 
208### Configuration
209- Use `/config` to view before modifying manually
210- Run `/audit` after configuration changes
211- Keep configuration in version control
212 
213### Setup
214- Use `/setup:python --standard` for production Python projects
215- Use `/setup:python --minimal` for experiments or learning
216- Use `/setup:javascript` for Node.js applications
217- Use `/setup:existing` to add framework to existing projects without disruption
218- Use `/setup:user` once to configure global preferences
219 
220## Migration Notes
221 
222### From Core Plugin (v0.9.x)
223These commands moved from the `core` plugin:
224- `status` → `/system:status` (renamed to avoid conflict with native /status)
225- `config` - Was `/core/config`
226- `setup` - Was `/core/setup`
227- `audit` - Was `/core/audit`
228- `cleanup` - Was `/core/cleanup`
229 
230### Name Change (v1.1.0)
231- `/status` → `/system:status` to avoid conflict with Claude Code native `/status` command
232 
233## Dependencies
234 
235None - System plugin is foundational.
236 
237## See Also
238 
239- **workflow** plugin - Task workflow management
240- **memory** plugin - Knowledge and context management
241- **development** plugin - Development tools
242 
243---
244 
245**Maintained by**: Claude Code Framework Team
246**Version**: 1.0.0
247**Last Updated**: 2025-10-18
248