Open Source
MIT License. The whole platform.
Infrastructure this critical should be auditable, extensible, and owned by the teams that run it. CodeSpar is fully open source — no open-core restrictions, no feature gates, no enterprise-only modules.
The entire multi-agent platform — every agent type, every channel adapter, the supervisor, the policy engine, the audit system — is in the repo. Fork it. Self-host it. Extend it. Write a custom agent in 300 lines of TypeScript.
Monorepo
One repo. Everything included.
CodeSpar is a monorepo with clear boundaries. Each agent type has its own directory with its own tests. Channel adapters are self-contained. The core handles routing, policy enforcement, and audit logging.
Every directory is independently testable. You can run npm test agents/task to test just the Task Agent, or npm test channels/slack to test just the Slack adapter.
Adding a new agent type means creating a directory under agents/, implementing the Agent interface, and registering it with the supervisor. No framework magic.
Modular Deploy
Compose what you need. Skip what you don't.
Docker Compose is the deployment primitive. The default docker-compose.yml brings up everything. But you can selectively compose only the services you need.
Only using Slack? Run docker compose up core slack. Want to add WhatsApp later? Just docker compose up whatsapp. No restart required for running services.
For production, layer docker-compose.prod.yml on top for TLS termination, log aggregation, health checks, and horizontal scaling of Task Agent workers.
Community
Built in the open. Governed transparently.
Clear contribution paths, structured decision-making, and a code of conduct that we actually enforce.
Contributing Guide
Start with good-first-issue labels. Every PR gets a Review Agent analysis. We merge fast — 90% of PRs reviewed within 24 hours.
RFC Process
Significant changes go through an RFC. Open a discussion, get feedback, build consensus. RFCs live in docs/rfcs/ and are numbered sequentially.
Governance
BDFL model for Year 1. The maintainer makes final calls on architecture and roadmap. After Year 1, transition to a core team with lazy consensus.
Code of Conduct
Contributor Covenant v2.1. We enforce it. Be respectful, be constructive, assume good intent. Violations are handled by the core team.
Adoption
Designed to spread
Every adoption decision is deliberate. From the README to the channel strategy, CodeSpar is built to reduce friction at every step.
README with GIF
The README opens with a 30-second GIF showing a real @codespar interaction — from @mention to deployed PR. No walls of text. Show, don't tell.
One-command install
git clone + docker compose up. That's it. No environment variables for the basic setup. Sane defaults. Working in under 2 minutes.
Slack as entry point
Most engineering teams already use Slack. The Slack adapter is the most polished, best documented, and first recommended. Low barrier.
WhatsApp as differentiator
No other open-source agent platform supports WhatsApp. This is the hook for teams in markets where WhatsApp dominates — LATAM, SEA, Europe.
Join the community
Star the repo. Read the contributing guide. Ship your first PR. MIT License — no strings attached.