Description
ArchSutra AI is an open-source software architecture agent designed to augment the capabilities of popular AI coding assistants such as Claude Code, Cursor, OpenAI Codex, GitHub Copilot, and Gemini CLI. It provides both portable Agent Skills and a deterministic offline Command Line Interface (CLI) to help developers and teams perform comprehensive software architecture audits, design reviews, threat modeling, and modernization efforts.
Read More
The core value proposition of ArchSutra AI lies in its evidence-first approach. Every claim generated by the agent is tagged as observed, inferred, proposed, or unknown, with findings citing specific files and lines of code. Each finding includes severity, confidence levels, suggested fixes, and acceptance criteria, moving beyond subjective assessments to provide actionable insights. This ensures that architectural decisions are grounded in verifiable data rather than mere intuition.
One of the key advantages of ArchSutra AI is its privacy-centric design. The CLI operates entirely offline, sending no data anywhere and incorporating no telemetry. When used within a supported AI IDE, the Agent Skills leverage the IDE's existing model, eliminating the need for any additional ArchSutra API keys or accounts. This architecture ensures that sensitive code remains within the user's environment, addressing common concerns about data privacy and security.
ArchSutra AI is built for integration into continuous integration (CI) pipelines, allowing teams to gate pull requests based on high-severity findings. It supports various export formats, including Markdown, Mermaid, JSON, and SARIF 2.1.0, facilitating seamless integration with code scanning tools. The agent includes 20 automated tests, 19 audit rules, and 12 specialist agents covering areas like security, data, cloud, and reliability, all contributing to a robust and comprehensive architectural analysis.
Adoption is made safe through features like dry-run installs, SHA-256 manifests, conflict detection, backups, and an uninstall process that preserves user edits. The project maintains transparency by openly stating its support levels and explicitly listing what aspects are not yet proven, such as live behavior in all AI IDEs or accuracy on real-world repositories. ArchSutra AI is licensed under Apache-2.0, providing legal and privacy clarity for its users.
- CategoryAI Code Review & Testing
- Pricing ModelOpen Source
- DeploymentOffline CLI, IDE Integration
- PlatformsWeb
ArchSutra AI's Core Features
Open-source software architecture agent
Offline CLI for deterministic audits
Portable Agent Skills for AI IDEs
Audits, designs, threat-models, and modernizes software
Provides file-and-line evidence for findings
No extra API key required
No telemetry or code sent externally by CLI
Supports Claude Code, Cursor, OpenAI Codex, GitHub Copilot, Gemini CLI
20 automated tests and 19 audit rules
12 specialist agents for various architectural domains
Export reports in Markdown, Mermaid, JSON, SARIF 2.1.0
CI/CD integration with --fail-on high option
Evidence-first approach with severity and confidence levels
Apache-2.0 licensed for legal clarity
Safe adoption features: dry-run installs, backups
How to use ArchSutra AI?
Install ArchSutra AI: Follow the user guide for installation, including dry-run options and manifest checks.
Configure for IDE: Integrate Agent Skills into your preferred AI IDE (Claude Code, Cursor, Codex, Copilot, Gemini CLI) by placing files in vendor-documented layouts.
Run CLI Audits: Execute the offline CLI to measure software architecture, generating reports without sending code externally.
Prompt AI IDE: Use your AI IDE's model with ArchSutra skills to reason over code and architectural findings.
Review Reports: Analyze generated reports with file-and-line evidence, severity, confidence, and proposed fixes.
Integrate into CI: Configure CI jobs to use ArchSutra AI for gating pull requests based on audit findings.
ArchSutra AI's Use Cases
- Software Architecture Auditing
- Threat Modeling
- Code Modernization
- Design Review
- CI/CD Integration
- Developer Productivity
- Security Analysis
- Compliance Review Aid





