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.
Install SimpleClaude plugins directly from the commandline:
claude plugin marketplace add https://github.com/kylesnowschwartz/SimpleClaude
claude plugin install sc-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-refactorWhat's included:
- sc-core: Intent-based commands and specialized agents for planning, implementation, exploration, and review
- sc-hooks (optional): Session management, tool monitoring, plan review gating, and notification hooks
- sc-output-styles (optional): Curated output styles — personality-driven (Linus, Austen, Lovelace, Ousterhout, Starfleet, Mayo Clinic) and structured formats (HTML, JSON, Markdown, Semantic Markdown, YAML)
- sc-extras (optional): Utility commands for root cause analysis, claim verification, adversarial analysis, and context wizards
- sc-skills (optional): Mermaid diagrams, codebase pattern detection, hypothesis testing, Socratic thinking, file querying, frontend design, image generation, and command generation
- sc-refactor (optional): PR review with ticket integration, codebase health checks, and specialized analysis agents for refactoring workflows
claude plugin marketplace update simpleclaude
claude plugin install sc-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# Core development commands
/sc-core:sc-plan "How should I add authentication to this app?"
/sc-core:sc-work "Add JWT authentication with login/logout"
/sc-core:sc-explore "How does the current database layer work?"
/sc-core:sc-review "Check security vulnerabilities in auth module"
/sc-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-skills:sc-mermaid flowchart auth # Generate architecture diagrams
/sc-extras:sc-validate-task # Validate completed work
/sc-skills:sc-worktrees # Manage git worktrees
/sc-hooks:sc-sounds # Configure notification soundsSimpleClaude uses a lightweight agent architecture with intent-based commands:
- Command Structure: Intent-based interfaces that understand user goals (plan, work, explore, review, workflow)
- Specialized 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
Each command automatically spawns appropriate agents:
sc-code-explorer- Traces execution paths and maps architecturesc-code-architect- Designs feature architectures from existing patternssc-code-reviewer- Reviews code for bugs, security, and convention adherencesc-research-github- Searches across GitHub to compare libraries, evaluate projects, and find issues/PRssc-research-repo- Clones and searches a specific library's repo for docs, APIs, and source codesc-research-web- Searches the web for news, blogs, tutorials, and community discussions
SimpleClaude/
├── plugins/
│ ├── sc-core/ # Core plugin: commands & agents
│ ├── sc-hooks/ # Hooks plugin: session management & notifications
│ ├── sc-output-styles/ # Output styles plugin: personality & structured formats
│ ├── sc-extras/ # Extras plugin: utility commands
│ ├── sc-skills/ # Skills plugin: diagrams, patterns, design, querying
│ └── sc-refactor/ # Refactor plugin: PR review & analysis agents
├── scripts/
│ └── install.rb # Installation/update script
├── docs/ # Documentation
└── README.md # This file
SimpleClaude was inspired by SuperClaude which demonstrated effective patterns for natural language command interfaces. SimpleClaude builds on concepts pioneered by the SuperClaude project and I thank NomenAK for putting in the hard yards with SuperClaude - an awesome project with powerful features.