Codius CLI

Coding assistant for domain-driven design projects in ASP.NET Core.

pip install codius

Why Codius?

Free domain-driven designers from boilerplate and let them focus on modeling.

Codius is your coding assistant for domain-driven design — built to take care of the repetitive tasks that just have to get done.

Instead of manually writing boilerplate for aggregates, methods, repositories, and other building blocks, you describe the changes you want to make. Codius takes care of translating those changes into code, aligned with the OpenDDD.NET framework.

This frees you up to focus on what really matters: modeling your domain and evolving your design.
Refinements become faster, iteration cycles shorter, and the feedback loop tighter.

With Codius, your ideas move from thought to implementation without getting lost in scaffolding.

If you’re passionate about DDD, code quality, and improving developer flow, try Codius — or help shape it by contributing to its development.

Example

Say you want a Book aggregate with Title, Author, and Price, and a method to apply discounts.

Just tell Codius:

> Create a Book aggregate with Title, Author, and Price.  
Add a method to apply a discount to the Price.

Codius handles the boilerplate — aggregate, method, repository — so you can focus on the model.

Quickstart

$ pip install codius    # Temporary package name
$ cd /your/project/root # Go to your project's root
$ codius                # Starts Codius CLI

On first run, Codius will create .codius/config.yaml and initialize a modeling session.

Compatibility

Codius is designed for projects built with OpenDDD.NET — a framework for Domain-Driven Design in .NET.

It works directly on your existing codebase, generating and modifying code according to OpenDDD.NET’s conventions.

Whether you’re evolving your domain model or adding new building blocks, Codius helps you stay consistent and productive within the framework’s structure.

Slash Commands

Requirements

• Python 3.9 to 3.12
• A project built with OpenDDD.NET
• OpenAI or Anthropic API key (set in config.yaml or use /model in the CLI)

Configuration

When you run Codius for the first time, it creates a .codius/config.yaml file in your project root.

This file controls how Codius behaves — including which LLM provider it uses, how verbose it is, and whether changes are auto-approved or suggested.

Example

debug: true
debug_llm: false
log_level: warning
approval_mode: suggest

llm:
  provider: openai
  openai:
    model: gpt-4o
    api_key: sk-...         # Or leave blank to use the OPENAI_API_KEY environment variable
  anthropic:
    model: claude-3-opus

Config Options

💡 If api_key is not specified in the YAML file, Codius falls back to environment variables like OPENAI_API_KEY.

Contribute

Codius is under active development.

If you're into:

• Domain-Driven Design
• Developer tooling
• LLM-based assistants
• Improving the modeling experience

...then jump in! Try it out, explore the codebase, and open an issue or PR.

License

Licensed under GPLv3.