Contributing

August 14, 2026 ยท View on GitHub

Thank you for helping Cathead Coding become a dependable and delightful coding agent.

Development workflow

  1. Create a focused branch from main.
  2. Install dependencies with pnpm install.
  3. Make one coherent change with tests and documentation.
  4. Run pnpm check before opening a pull request.
  5. Explain user-visible behavior, risk, and verification in the pull request.

Do not commit API keys, session logs, generated workspaces, or user prompts. New runtime capabilities should be composed through config/cordis.yml or a focused module rather than embedded in the TUI.

Changes and tests

  • User-visible terminal behavior needs a deterministic test.
  • Runtime event handling should use stable DSH event fields and tolerate unknown plugin events.
  • Dependency updates must retain exact DSH prerelease versions until DSH offers a stable compatibility contract.
  • Security-sensitive changes should document their threat model and failure behavior.

By participating, you agree to follow the Code of Conduct.