Welcome to Cyrus.

In 2026, AI has become an inevitable part of most developers' workflows. We see it as a valuable companion rather than a threat. Cyrus embraces this reality while maintaining clear boundaries about where AI assistance belongs.

We have a pragmatic and transparent stance on AI-generated code.

AI-generated or AI-authored code is not allowed in the compiler codebase, parser, type system, standard library, or runtime.

Why? The compiler is a correctness-critical system. Even subtle errors can have massive consequences. We believe that human reasoning is essential for long-term maintainability, authorship must be traceable, and trust in the language's foundation must be absolute.

If a pull request targeting the compiler is found to contain AI-generated code, it will be closed immediately.

AI assistance is allowed and welcome in areas like:

• Our VSCode extension, Emacs plugin, and other tooling.
• The website, documentation, examples, and tutorials.

However, you are always fully responsible for the correctness, licensing, and originality of any contribution you submit, regardless of how it was drafted.

In short: you can use AI to help you write a VSCode plugin for Cyrus, but the core compiler itself must be 100% human-crafted. We think that is the right balance for a systems language in 2026.

We have created a special file in this repository: skills.md.

This is not just documentation. It is a complete, machine-readable knowledge pack designed to teach Large Language Models (LLMs) the entire Cyrus language from scratch.

1. Port your projects: using skills.md, you can guide an LLM to help you translate existing projects from C, Rust, Zig, and other languages into Cyrus.
2. Develop from scratch: you can use AI assistants as pair programmers to write new Cyrus code, generate examples, or debug, all by providing them with the knowledge in skills.md.
3. Onboard faster: new team members can use an AI to get up to speed on Cyrus's quirks and features instantly.

Consider skills.md the source of truth for AI agents interacting with Cyrus. It is our way of embracing the future of development while keeping the soul of the project human.

We welcome contributions of all kinds, whether fixing bugs, improving documentation, or building new tooling.

• Read our full Contribution Guide: https://cyrus-lang.ir/en/docs/project/contribution
• Check for existing issues before filing a new one.
• Start with a Draft PR for non-trivial changes. We value collaboration and early feedback.

Cyrus is open source and licensed under the MIT License.