SimpleClaude
A practical minimalist AI assistant framework that transforms complex AI interactions into natural conversations. Comes with a set of user-commands, sub-agents, hooks, and utilities designed for real-world software development tasks. Completely dogfooded by its creator for building production software in the workplace and for personal projects. Expect frequent updates, enhancements, and breaking changes.
Installation
Option 1: Direct from GitHub (Recommended)
Install SimpleClaude plugins directly from the commandline:
claude plugin marketplace add https://github.com/kylesnowschwartz/SimpleClaude
claude plugin install simpleclaude-core
claude plugin install sc-hooks
claude plugin install sc-output-styles
claude plugin install sc-extras
claude plugin install sc-skills
claude plugin install sc-refactor
Or from within Claude Code:
/plugin marketplace add https://github.com/kylesnowschwartz/SimpleClaude
/plugin install simpleclaude-core
/plugin install sc-hooks
/plugin install sc-output-styles
/plugin install sc-extras
/plugin install sc-skills
/plugin install sc-refactor
What's included:
- simpleclaude-core: 4+1 core commands and 7 specialized agents
- sc-hooks (optional): Session management, tool monitoring, and notification hooks
- sc-output-styles (optional): 8 curated output styles (personality-driven: Linus, Austen, Starfleet; structured: HTML, JSON, Markdown, Semantic Markdown, YAML)
- sc-extras (optional): 11 utility commands for mermaid diagrams, root cause analysis, claim verification, pre-commit setup, git worktrees, task validation, and more
- sc-skills (optional): Frontend design iteration, Gemini image generation, and command generation tools
- sc-refactor (optional): PR review with ticket integration, codebase health checks, and 9 specialized analysis agents for refactoring workflows
Updating
Via Claude Code CLI
claude plugin marketplace update simpleclaude
claude plugin install simpleclaude-core@simpleclaude
claude plugin install sc-hooks@simpleclaude
claude plugin install sc-output-styles@simpleclaude
claude plugin install sc-extras@simpleclaude
claude plugin install sc-skills@simpleclaude
claude plugin install sc-refactor@simpleclaude
Quick Start
# Core development commands
/simpleclaude-core:sc-plan "How should I add authentication to this app?"
/simpleclaude-core:sc-work "Add JWT authentication with login/logout"
/simpleclaude-core:sc-explore "How does the current database layer work?"
/simpleclaude-core:sc-review "Check security vulnerabilities in auth module"
/simpleclaude-core:sc-workflow "Start structured development for OAuth support"
# PR review and refactoring
/sc-refactor:sc-review-pr 42 # Full PR review with ticket context
/sc-refactor:sc-pr-comments 42 # Fetch unresolved PR comments
/sc-refactor:sc-resolve-pr-parallel 42 # Batch resolve PR feedback
/sc-refactor:sc-cleanup src/ # Post-AI session cleanup
/sc-refactor:sc-codebase-health src/ # Full codebase health analysis
# Utilities
/sc-extras:sc-five-whys # Root cause analysis
/sc-extras:sc-mermaid-flowchart # Generate architecture diagrams
/sc-extras:sc-validate-task # Validate completed work
/sc-extras:sc-worktrees # Manage git worktrees
/sc-hooks:sc-sounds # Configure notification sounds
Architecture
SimpleClaude uses a lightweight agent architecture with intent-based commands:
- 4+1 Command Structure: Intent-based interfaces that understand user goals
- 7 Core Agents: Context-specific assistants spawned via
Task() calls
- Token-Efficient Design: Agents work in isolation with focused context
- Clean Separation: Commands understand intent, agents execute specialized tasks
Agent System
Each command automatically spawns appropriate agents: