<div align="center">

[![Announcement Banner](https://img.shields.io/badge/🌟_We_are_exploring_some_interesting_things,_please_keep_following_us!-2563EB?style=for-the-badge)](https://costrict.ai)

</div>

<div align="center">

<img src="https://img.shields.io/badge/version-latest-blue?style=flat-square" alt="Version">
<img src="https://img.shields.io/badge/license-Apache%202.0-green?style=flat-square" alt="License">
<img src="https://img.shields.io/badge/platform-VS%20Code%20%7C%20JetBrains-orange?style=flat-square" alt="Platform">
<img src="https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square" alt="PRs Welcome">

</div>

<div align="center">

# CoStrict

<img src="./assets/images/shenma_robot_logo_big.png" alt="CoStrict Logo" width="60">

**Strict AI Coder for Enterprises**

_Free • Open Source • Private Deployment_

[简体中文](./README.zh-CN.md) | English

</div>

---

**CoStrict** is a free, open-source AI-powered coding assistant designed for enterprise-grade development. With support for private deployment, it's the optimal choice for organizations requiring secure, standardized AI development workflows.

## ✨ Core Capabilities

| Feature                | Description                                                                                                         |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------- |
| 🔒 **Strict Mode**     | Standardized AI code generation with requirements analysis, architecture design, task planning, and test generation |
| 🔍 **Code Review**     | Repository-wide RAG-based code analysis with multi-expert model verification                                        |
| ⚡ **Code Completion** | Context-aware code generation in seconds                                                                            |
| 🎯 **Vibe Code**       | Rapid development through natural language dialogue                                                                 |
| 🔗 **MCP Integration** | Standardized system connectivity for APIs, databases, and custom tools                                              |
| 🎨 **Multi-modal**     | Support for image context and visual inputs                                                                         |
| 🛠️ **Skills Support**  | Extensible skills system for specialized task workflows                                                             |

## 📦 Installation

<table>
  <tr>
    <td align="center" width="25%">
      <b>🌟 CoStrict Cloud (Experimental)</b><br><br>
      <a href="https://docs.costrict.ai/cli/product-characteristics/cloud">
        <img src="https://img.shields.io/badge/Cloud-Documentation-blue?style=for-the-badge" alt="Cloud Docs">
      </a>
    </td>
    <td align="center" width="25%">
      <b>VS Code Extension</b><br><br>
      <a href="https://marketplace.visualstudio.com/items?itemName=zgsm-ai.zgsm-nightly">
        <img src="https://img.shields.io/badge/Download-Nightly-success?style=for-the-badge" alt="Download">
      </a>
      <a href="https://marketplace.visualstudio.com/items?itemName=zgsm-ai.zgsm">
        <img src="https://img.shields.io/badge/Download-Latest-success?style=for-the-badge" alt="Download">
      </a>
    </td>
    <td align="center" width="25%">
      <b>CLI Tool</b><br><br>
      <a href="https://docs.costrict.ai/cli/guide/installation">
        <img src="https://img.shields.io/badge/CLI-Documentation-blue?style=for-the-badge" alt="CLI Docs">
      </a>
      <a href="https://costrict.ai/download">
        <img src="https://img.shields.io/badge/Download-Latest-success?style=for-the-badge" alt="Download">
      </a>
    </td>
    <td align="center" width="25%">
      <b>JetBrains Plugin</b><br><br>
      <a href="https://github.com/zgsm-sangfor/costrict-for-jetbrains">
        <img src="https://img.shields.io/badge/GitHub-Repository-informational?style=for-the-badge" alt="JetBrains Repo">
      </a>
      <a href="https://costrict.ai/download">
        <img src="https://img.shields.io/badge/Download-Latest-success?style=for-the-badge" alt="Download">
      </a>
    </td>
  </tr>
</table>

## 🚀 Key Features

### Strict Mode

Standardizes AI-generated code workflows for enterprise scenarios, ensuring high-quality and controllable outputs.

<table bgcolor="#1e1e1e">
  <tr>
    <td align="center" width="50%">
      <a href="https://docs.costrict.ai/en/tutorial-videos/video/#strict-mode">
        <img src="./assets/images/readme/strict_mode_en_buffer.webp" alt="Strict Mode Demo" width="100%">
      </a>
    </td>
    <td align="center" width="50%">
      <img src="./assets/images/readme/strict_mode_en.webp" alt="Strict Mode" width="100%">
    </td>
  </tr>
</table>

### Code Review

Repository-wide indexing and RAG-based analysis with multi-model verification strategies.

<table bgcolor="#1e1e1e">
  <tr>
    <td align="center" width="50%">
      <a href="https://docs.costrict.ai/en/tutorial-videos/video/#ai-codereview">
        <img src="./assets/images/readme/codereview_buffer.webp" alt="Code Review Demo" width="100%">
      </a>
    </td>
    <td align="center" width="50%">
      <img src="./assets/images/readme/codereview_en.webp" alt="Code Review" width="100%">
    </td>
  </tr>
</table>

### More Features

- 🌐 **Multi-language Support** - Python, Go, Java, JavaScript/TypeScript, C/C++, and all programming languages
- 🔐 **Privacy & Security** - Professional private deployment with physical isolation and end-to-end encryption
- 🎛️ **API & Model Customization** - Built-in free models + support for Anthropic, OpenAI, OpenAI-compatible APIs, and local models
- 📁 **Large Repository Context** - Automatic context inclusion with @ file/folder mentions
- 🔧 **Mode Customization** - Multiple default modes (Code, Orchestrator) with custom mode support
- 📝 **[OpenSpec Integration](https://github.com/Fission-AI/OpenSpec)** - Standardized change proposal workflows with `/openspec-init`
- 🔗 **VSCode SCM Integration** - Seamless integration with Git for code review and collaboration
- **Auto Cleanup History** - Automatically clean up history and reduce disk usage.
- 📝 **History Import&Export** - Supports import and export of historical records to facilitate offline migration
- 🔗 **Lite Mode** - Reduce context usage and reduce token consumption.
  <img src="./assets/images/readme/more-feature_en.webp" alt="More Features" width="100%">

## 📚 Documentation

| Resource           | Link                                                                                               |
| ------------------ | -------------------------------------------------------------------------------------------------- |
| Installation Guide | [docs.costrict.ai/en/guide/installation](https://docs.costrict.ai/en/guide/installation)           |
| Private Deployment | [docs.costrict.ai/en/deployment/introduction](https://docs.costrict.ai/en/deployment/introduction) |
| Tutorial Videos    | [docs.costrict.ai/en/tutorial-videos/video](https://docs.costrict.ai/en/tutorial-videos/video)     |
| CLI Documentation  | [docs.costrict.ai/cli/guide/installation](https://docs.costrict.ai/cli/guide/installation)         |

## 🤝 Community & Support

<table>
  <tr>
    <td align="center" width="33%">
      <img src="./assets/images/readme/wechat.png" width="120"><br>
      <b>WeChat Group</b>
    </td>
    <td align="center" width="33%">
      <img src="./assets/images/readme/communication_group.webp" width="120"><br>
      <b>Feedback</b>
    </td>
    <td align="center" width="33%">
      <a href="https://github.com/zgsm-ai/costrict/issues/new/choose">
        <img src="https://img.shields.io/badge/GitHub-Issues-blue?style=for-the-badge&logo=github" alt="GitHub Issues">
      </a>
    </td>
  </tr>
</table>

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](assets/docs/devel/en-US/how-to-contribute.md) for details.

## 📄 License

[Apache 2.0 © 2025 Sangfor, Inc.](./LICENSE)

## ⭐ Star History

<a href="https://www.star-history.com/#zgsm-ai/costrict&Date">
  <img src="https://api.star-history.com/svg?repos=zgsm-ai/costrict&type=Date" alt="Star History Chart" width="100%">
</a>

## 🙏 Acknowledgments

Special thanks to our open-source partners:

[![Roo Code](https://img.shields.io/badge/Roo%20Code-Repository-blue?style=flat-square)](https://github.com/RooCodeInc/Roo-Code)
[![OpenSpec](https://img.shields.io/badge/OpenSpec-Repository-blue?style=flat-square)](https://github.com/Fission-AI/OpenSpec)
[![OpenCode](https://img.shields.io/badge/OpenCode-Repository-blue?style=flat-square)](https://github.com/anomalyco/opencode)
[![agents.md](https://img.shields.io/badge/agents.md-Repository-blue?style=flat-square)](https://github.com/agentsmd/agents.md)
[![agentskills](https://img.shields.io/badge/agentskills-Repository-blue?style=flat-square)](https://github.com/agentskills/agentskills)

---

## Disclaimer

**Please note** that Sangfor, Inc does **not** make any representations or warranties regarding any code, models, or other tools provided or made available in connection with CoStrict, any associated third-party tools, or any resulting outputs. You assume **all risks** associated with the use of any such tools or outputs; such tools are provided on an **"AS IS"** and **"AS AVAILABLE"** basis. Such risks may include, without limitation, intellectual property infringement, cyber vulnerabilities or attacks, bias, inaccuracies, errors, defects, viruses, downtime, property loss or damage, and/or personal injury. You are solely responsible for your use of any such tools or outputs (including, without limitation, the legality, appropriateness, and results thereof).
