Getting Started
Understand the product and release model before your first run.
What is Guardian?
Guardian is a desktop governance application that evaluates codebases against architecture constraints, security expectations, and release quality standards. It provides real-time feedback on code quality, suggests fixes using the Guru assistant, and integrates with your existing release workflows.
Key Capabilities
- Codebase Scanning: Analyzes your project for architectural violations, security issues, and quality concerns.
- Guru AI Assistant: An intelligent assistant that explains issues in context and provides actionable fix suggestions.
- Release Governance: Manages the release process with built-in update checking and version management.
- In-App Updates: Checks for updates via GitHub Releases and guides you through installing new releases.
Who is it for?
Guardian is designed for teams and individuals who care about code quality:
| Role | Use Case |
|---|---|
| Technical Leads | Enforce architectural standards across the team |
| Platform/DevOps Teams | Integrate quality checks into CI/CD pipelines |
| Security Teams | Monitor for security vulnerabilities and compliance |
| Individual Developers | Get instant feedback on code quality |
How it works
Guardian follows a three-step governance cycle:
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ SCAN │────▶│ ANALYZE │────▶│ ACT │
│ Codebase │ │ Findings │ │ Fix/Approve │
└─────────────┘ └─────────────┘ └─────────────┘
- Scan: Guardian scans your codebase and classifies findings by type (security, architecture, quality).
- Analyze: Issues are prioritized by severity, and the Guru assistant provides context and explanations.
- Act: Review findings, apply fixes when appropriate, and use baselines to track what is new vs. already-known.
First 10 Minutes
Here's what you should do in your first session:
1. Install the Application
Download the installer from the Download page. macOS builds are available now; Windows and Linux appear when published.
2. Configure Provider Settings
Navigate to Settings > Provider and configure your AI provider credentials. Guardian supports multiple AI providers including cloud-based and local options.
3. Start Your First Scan
Click the Scope field (or drag and drop a folder onto the app) to select your workspace, then choose Launch Guardian to start monitoring.
4. Review Findings
Once the scan completes:
- Click on any finding to see details
- Use the Guru chat to ask questions about the issue
- Apply suggested fixes or set a baseline to track the current state
Application Layout
The Guardian interface consists of four main areas:
| Area | Purpose |
|---|---|
| Sidebar | Navigate between scans, settings, and history |
| Main Panel | View findings, code, and analysis results |
| Guru Chat | Interactive AI assistant for getting help |
| Status Bar | Connection status, version info, and quick actions |
Next Steps
- Installation Guide - Detailed setup instructions
- Guru Assistant - Learn how to use the AI architect
- Reviews & Fix Proposals - Manage suggested code fixes
- Configuration - Customize settings and guardian.lock
- Security - Understand the security model
What's New in v1.2.3
v1.2.3 focuses on a fully bilingual experience (EN/TR) across the desktop app and website, with AI outputs matching your selected language.
- EN/TR UI language: Switch languages in Settings. The interface updates across Monitor, Guru, AI Context, Reviews, and Settings.
- Localized AI outputs: Guru answers and Monitor findings are requested in your selected language (severity values remain stable for validation).
- SEO locale URLs: Docs and pages live under
/en/...and/tr/..., with a globe toggle in the header.