Bottles Next

Central repository for the Bottles Next project.

Usage

Clone the repository:

SSH:

git clone --recursive git@github.com:bottlesdevs/bottles-next.git

HTTPS:

git clone --recursive https://github.com/bottlesdevs/bottles-next.git

Build

To build the project, you can use the just command:

just build

More recipes can be found in the justfile.

Use of Generative AI

Some maintainers use generative AI tools as assistants while working in Bottles, in the spirit of Open Source, we want to be transparent about how, specifically:

• Code comments and documentation
• Boilerplate and repetitive code
• Issue triage (spotting duplicates, outdated reports, grouping similar issues)

Tools vary between contributors (currently mostly Claude and Codex): each AI-assisted commit states the tool and model used in its Assisted-by trailer.

What we don't use it for

Architecture, complex logic, the security and sandboxing model and user experience are designed and written by the maintainers, manually.

Human review

Every line of generated code, documentation and comments are reviewed by a maintainer before it is merged.

Also, starting from the 10th Sep 2026, the following commit pattern must be used for contributions made with or helped with the AI:

feat: add support for X

Assisted-by: <tool>:<model-version>
AI-Scope: what the AI generated in this commit, and the prompt used (or a short summary of it)

Trivial completions (single lines, renames, formatting) don't need to be marked.

Not following this layout will lead to a closed Pull Request.

License

GPL-3.0

Coding agents must also follow AGENTS.md before changing files, creating commits, or opening pull requests.