Contributing

AccessAgent is open source under the MIT License and welcomes contributions of all kinds.

Ways to contribute

• Bug reports — open an issue on GitHub describing what happened and what you expected
• Feature requests — open an issue with your idea and the problem it solves
• Documentation — improve or extend the docs site (this site is in the web/ repo)
• Code — fix bugs or implement features from the issue tracker

Development setup

1. Fork and clone

   git clone https://github.com/your-username/accessagent-core
   cd accessagent-core

2. Install dependencies

   bun install

3. Set up environment

   cp .env.example .env
   # Edit .env with your DATABASE_URL and OPENAI_API_KEY

4. Run database migrations

   bun run db:migrate

5. Start the development server

   bun run dev

   The app runs at http://localhost:3000 with hot reload.

Code standards

• TypeScript everywhere — no .js files
• No comments unless the WHY is non-obvious — good names are documentation
• No Python — all scripts and tooling use TypeScript/Bun
• Adapter pattern — auth, storage, and any new external dependencies must go through their interface

Pull requests

• One PR per feature or bug fix
• Write a clear description of what the PR does and why
• If your PR fixes an issue, reference it: “Fixes #123”
• Keep PRs small — easier to review, more likely to merge

Note

For large features, open an issue first to discuss the approach before writing code. This avoids PRs that conflict with planned work.

Reporting security issues

For security vulnerabilities, do not open a public GitHub issue. Email steban@gmail.com with details. We’ll respond within 48 hours.