Contributing

Set up a development stack, make a focused change, and submit it with the required checks.

Source of truth

Development setup

Clone the OpenNeko repository and follow CONTRIBUTING.md for the current toolchain, environment files, service startup, and test commands.

Start from source

git clone https://github.com/open-neko/openneko.git
cd openneko
corepack enable
pnpm bootstrap
pnpm dev:setup
pnpm dev

Before a pull request

Keep the change focused and explain the operator problem it solves.
Add or update tests for behavior that changed.
Update source documentation when a command, setting, security boundary, or user path changes.
Run the repository checks listed in CONTRIBUTING.md.
Sign the Contributor License Agreement when requested.

Security-sensitive changes

Changes to sandbox policy, egress, secret handling, action execution, identity, audit, or recovery need explicit threat-boundary review. Document both the intended control and how a reviewer can verify it.