sugar
Transform Claude Code into an autonomous AI development powerhouse with rich task context, specialized agents, and intelligent workflow automation
View on GitHubTable of content
Transform Claude Code into an autonomous AI development powerhouse with rich task context, specialized agents, and intelligent workflow automation
Installation
npx claude-plugins install @jeremylongshore/claude-code-plugins-plus/sugar
Contents
Folders: agents, commands, hooks, mcp-server, skills
Files: LICENSE, README.md, plugin.json
Documentation
Transform your Claude Code experience with autonomous AI development capabilities!
What is Sugar?
Sugar is a premier Claude Code plugin that brings true autonomous development to your projects. Unlike simple automation plugins, Sugar provides:
- 🤖 Autonomous Task Execution - Let AI handle complex, multi-step development work
- 📋 Enterprise Task Management - Persistent SQLite-backed task tracking with rich metadata
- 🎯 Intelligent Agent Orchestration - Specialized agents for different development aspects
- 🔍 Automatic Work Discovery - Finds work from error logs, GitHub issues, and code quality metrics
- 👥 Team Collaboration - Shared task queues with multi-project support
Quick Start
Prerequisites
Install Sugar CLI (if not already installed):
pip install sugaraiInitialize in your project:
cd /path/to/your/project sugar init
Installation
Install the Sugar plugin via Claude Code:
/plugin install sugar
Basic Usage
Create Tasks
/sugar-task "Implement user authentication" --type feature --priority 4
View Status
/sugar-status
Start Autonomous Mode
/sugar-run --dry-run # Test first
/sugar-run # Start autonomous development
Features
Slash Commands
/sugar-task- Create comprehensive tasks with rich context/sugar-status- View system status and task queue/sugar-review- Review and manage pending tasks/sugar-run- Start autonomous execution mode/sugar-analyze- Analyze codebase for potential work
Specialized Agents
- sugar-orchestrator - Coordinates autonomous development workflows
- task-planner - Strategic task planning and breakdown
- quality-guardian - Code quality and testing enforcement
- autonomous-executor - Handles autonomous task execution
Automatic Task Discovery
Sugar automatically discovers work from:
- Error logs and crash reports
- GitHub issues and pull requests
- Code quality metrics and technical debt
- Missing test coverage
- Documentation gaps
Advanced Features
Rich Task Context
Create tasks with comprehensive metadata:
sugar add "User Dashboard Redesign" --json --description '{
"priority": 5,
"type": "feature",
"context": "Complete overhaul of user dashboard for better UX",
"business_context": "Improve user engagement and reduce support tickets",
"technical_requirements": ["responsive design", "accessibility compliance"],
"agent_assignments": {
"ux_design_specialist": "UI/UX design leadership",
"frontend_developer": "Implementation and optimization",
"qa_test_engineer": "Testing and validation"
},
"success_criteria": ["mobile responsive", "passes accessibility audit"]
}'
Custom Task Types
Define your own task types beyond the defaults:
sugar task-type add security_audit \
--name "Security Audit" \
--description "Security vulnerability scanning" \
--agent "tech-lead" \
--emoji "🔒"
Multi-Project Support
Sugar maintains isolated instances per project:
- Separate
.sugar/directory in each project - Independent task queues and execution
- No interference between projects
Configuration
Sugar auto-generates .sugar/config.yaml with sensible defaults. Key settings:
sugar:
loop_interval: 300 # 5 minutes between autonomous cycles
max_concurrent_work: 3 # Execute multiple tasks per cycle
dry_run: false # Set to true for safe testing
claude:
enable_agents: true # Enable Claude agent mode selection
use_structured_requests: true
Safety Features
- Dry Run Mode - Test without making changes
- Project Isolation - Clean
.sugar/directory structure - Graceful Shutdown - Handles interrupts cleanly
- Audit Trail - Complete history of all autonomous actions
Documentation
Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Documentation: docs.roboticforce.io/sugar
License
MIT License - see LICENSE
Sugar 🍰 v1.9.1 - Transform any project into an autonomous development environment.
⚠️ Disclaimer: Sugar is an independent third-party tool. “Claude,” “Claude Code,” and related marks are trademarks of Anthropic, Inc. Sugar is not affiliated with, endorsed by, or sponsored by Anthropic, Inc.
Included Skills
This plugin includes 1 skill definition:
managing-autonomous-development
|
View skill definition
Sugar
This skill provides automated assistance for sugar tasks.
Overview
This skill empowers Claude to orchestrate and monitor autonomous development processes within the Sugar environment. It provides a set of commands to create, manage, and execute tasks, ensuring efficient and automated software development workflows.
How It Works
- Command Recognition: Claude identifies the appropriate Sugar command (e.g.,
/sugar-task,/sugar-status,/sugar-review,/sugar-run). - Parameter Extraction: Claude extracts relevant parameters from the user’s request, such as task type, priority, and execution flags.
- Execution: Claude executes the corresponding Sugar command with the extracted parameters, interacting with the Sugar plugin.
- Response Generation: Claude presents the results of the command execution to the user in a clear and informative manner.
When to Use This Skill
This skill activates when you need to:
- Create a new development task with specific requirements.
- Check the current status of the Sugar system and task queue.
- Review and manage pending tasks in the queue.
- Start or manage the autonomous execution mode.
Examples
Example 1: Creating a New Feature Task
User request: “/sugar-task Implement user authentication –type feature –priority 4”
The skill will:
- Parse the request and identify the command as
/sugar-taskwith parameters “Implement user authentication”,--type feature, and--priority 4. - Exe
…(truncated)