Autonomous issue resolution for AI-assisted development.
Persistent memory, cross-session context, and autonomous task execution for any AI coding CLI.
Sugar is a Claude Code plugin that brings persistent memory and autonomous development to your projects. Sugar provides:
- 🧠 Persistent Memory - Cross-session context that survives restarts - decisions, preferences, error patterns, and more
- 🌐 Global Knowledge - Project-independent memory for guidelines and standards available across all your work
- 🤖 Autonomous Task Execution - Let AI handle complex, multi-step development work
- 📋 Task Management - Persistent SQLite-backed task tracking with rich metadata
- 🔍 Automatic Work Discovery - Finds work from error logs, GitHub issues, and code quality metrics
-
Install Sugar CLI (if not already installed):
pip install sugarai
-
Initialize in your project:
cd /path/to/your/project sugar init
Install the Sugar plugin via Claude Code using one of these methods:
Option 1: Direct Repository Installation (Recommended)
/plugin install roboticforce/sugar
Option 2: Register Sugar Marketplace First
/plugin marketplace add roboticforce/sugar
/plugin install sugar
Note: The plugin is available from the roboticforce/sugar GitHub repository. If you get "Plugin not found in any marketplace", use the direct installation method above.
/sugar-task "Implement user authentication" --type feature --priority 4
/sugar-status
/sugar-run --dry-run # Test first
/sugar-run # Start autonomous development
/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/sugar-thinking- View Claude's thinking logs for tasks (New in v3.4)
- 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
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
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"]
}'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 "🔒"Sugar maintains isolated instances per project:
- Separate
.sugar/directory in each project - Independent task queues and execution
- No interference between projects
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- 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
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Documentation: sugar.roboticforce.io
MIT License - see LICENSE
Sugar - Autonomous issue resolution for AI-assisted development.