Thanks for your interest in contributing!
- Fork the repo
- Clone your fork
- Install dependencies:
npm install - Build:
npm run build - Run tests:
npm test
Cortex is a monorepo with npm workspaces. Packages are in packages/.
# Build all packages
npm run build
# Run tests
npm test
# Run a specific package's tests
cd packages/llm && npm test
# Link for local development
cd packages/cli && npm link- One feature or fix per PR
- Include tests for new functionality
- Run
npm testbefore submitting - Keep PRs focused — large refactors should be discussed in an Issue first
Open an Issue with:
- What you expected to happen
- What actually happened
- Steps to reproduce
- Your environment (OS, Node version, Ollama version if applicable)
Open a Discussion in the Ideas category. Describe the use case, not just the solution.
Be kind. Be constructive. We're all here to build something useful.