Overview
Guardian's Project Monitoring feature provides real-time oversight of your codebase, identifying issues as you work using AI-powered analysis.
Starting Monitoring
Step 1: Select a Project
- Click Browse or drag a folder onto the app
- Select your project's root directory
- The path will appear in the project selector
Step 2: Launch Guardian
Once you have:
- Selected a valid project path
- Configured your AI provider
- Authenticated with your identity provider (if required)
Click Launch Guardian to start monitoring.
How Monitoring Works
Guardian watches your project for file changes and analyzes code using your configured AI provider:
- File Detection: Monitors for saved changes in your project
- Batch Processing: Groups changes for efficient analysis
- AI Analysis: Sends code to your AI provider for review
- Results Display: Shows findings in the activity panel
Understanding Findings
Severity Levels
| Level | Meaning | Action |
|---|
| Critical | Security vulnerability or major issue | Fix immediately |
| High | Significant problem | Address soon |
| Medium | Should be improved | Plan to fix |
| Low | Minor improvement | Consider for cleanup |
| Info | Informational | No action required |
Finding Categories
Guardian can identify:
- Security Issues: Vulnerabilities, exposed secrets
- Code Quality: Anti-patterns, complexity
- Performance: Inefficient patterns
- Best Practices: Style and convention violations
Working with Findings
Viewing Details
Click any finding to see:
- Description of the issue
- Affected file and location
- Suggested fix (if available)
Applying Fixes
For findings with suggested fixes:
- Review the proposed change
- Click Apply Fix to implement
- Or click Reject to dismiss
Ask Guru
Click Ask Guru on any finding to get:
- Detailed explanation of the issue
- Alternative solutions
- Best practice recommendations
Stopping Monitoring
Click Kill Guardian to stop monitoring:
- All file watchers are stopped
- Pending analyses are cancelled
- The app returns to idle state
Activity Panel
The activity panel shows:
- Real-time monitoring status
- Recent findings with severity
- Guru conversation history
- Applied fixes log
Chat History
Guardian maintains chat history per project:
- Conversations persist across sessions
- Clear history via the chat panel
- Export conversations as needed
Troubleshooting
| Issue | Solution |
|---|
| No findings appearing | Check that files are being saved |
| Slow analysis | Consider using a faster AI model |
| Connection errors | Verify API key and network |
| High token usage | Reduce monitored file scope |
Best Practices
- Start Small: Begin with a focused directory
- Review Before Apply: Always review suggested fixes
- Use Guru: Ask for explanations on unclear findings
- Monitor Costs: Track AI provider usage for paid APIs
- Ignore Noise: Focus on high-severity issues first