Thank you for your interest in contributing to clens!
- Bun >= 1.0
- Clone the repository
- Install dependencies:
bun install - Run tests:
bun test
src/ — Source code (CLI, hooks, format definitions, session management)
test/ — Test files (mirrors src/ structure)
.clens/ — Local session data directory (not committed)
specs/ — Implementation plans
bun test— Run all testsbun run typecheck— TypeScript type checkingbun run lint— Lint with Biomebun run lint:fix— Auto-fix lint violationsbun run build— Compile binary
- Branch from
main - Keep PRs focused — one feature or fix per PR
- All tests must pass (
bun test) - TypeScript must compile cleanly (
bun run typecheck) - Code must pass lint (
bun run lint) - Run
bun run lint:fixbefore committing
Code style is enforced by Biome. Run bun run lint:fix before committing to auto-fix formatting and lint issues.