Want to hack on Caspian? Here's how to get started.
git clone https://github.com/TheCaspianAI/Caspian.git
cd Caspian
bun install
bun devThat's it. The app should launch in development mode.
- Fork the repo and create a branch for your work
- Make your changes — keep commits focused and atomic
- Open a PR with a clear description of what you changed and why
- Enable "Allow edits from maintainers" so we can help move things along
For anything beyond small fixes, open an issue first to discuss the approach. This saves everyone time.
Run these locally:
bun run lint # Check for lint issues
bun run typecheck # Verify types
bun test # Run the test suiteSee AGENTS.md for detailed conventions. The essentials:
- Minimal diffs — change only what's necessary
- Match existing patterns — consistency over personal preference
- No
anytypes unless there's a good reason - Object params for functions with 2+ arguments
Questions? Open an issue or start a discussion.