Project Info
๐
Inspiration
Code Sentinel Bot was born out of a pressing need: preventable security breaches caused by overlooked vulnerabilities in pull requests. Developers often lack the time or expertise for deep security reviews. With the rise of AI and increasingly complex cyber threats, we saw an opportunity to democratize security expertise by creating an intelligent assistant that embeds security into everyday development. Our goal is to shift security left โ enabling every developer to become a security-conscious developer. ๐ง What It Does Code Sentinel Bot is an AI-powered GitHub repository security analyzer that helps developers identify vulnerabilities before code is merged. ๐ Core Features ๐ GitHub Integration: Analyzes public GitHub repositories and pull requests in real-time ๐ค AI-Powered Risk Assessment: Uses Claude AI to assign risk scores (0โ100%) per PR ๐ ๏ธ Security Detection: Flags issues like SQL injection, insecure auth, and more ๐ฌ RAG Chatbot: A Retrieval-Augmented Generation assistant that answers repo-specific questions ๐ Detailed Reports: Provides recommendations and technical analysis ๐ Analysis History: Saves analyzed repositories for continued monitoring ๐ Modern UI: Responsive dashboard with live updates and intuitive design ๐๏ธ How We Built It ๐ฅ๏ธ Frontend React 18 + TypeScript โ Modern, type-safe, and component-based Vite โ For fast dev builds and optimized production shadcn/ui + Tailwind CSS โ Beautiful and accessible UI React Query โ API caching and efficient state management โ๏ธ Backend & AI Integration Express.js Server โ Backend proxy for AI and GitHub API Supabase Edge Functions โ Serverless GitHub repo analysis Claude 3.5 Sonnet (Anthropic) โ Natural language processing and code analysis Octokit GitHub API โ Pull request and repo data fetching ๐งฌ AI & Security Pipeline ๐ RAG System: Context-aware query responses ๐ Semantic Matching: Cosine similarity for code analysis ๐ก๏ธ Security Rule Engine: Detects common vulnerability patterns ๐ Risk Scoring: Multi-factor algorithm for threat estimation โ๏ธ Deployment Full-Stack Deployment: With secure environment management CORS + API Keys: Secure backend services WebSocket-like Updates: Live stream of analysis results ๐งโโ๏ธ Challenges We Faced Technical GitHub API Rate Limits: Solved via caching and batching Claude Token Limits: Overcame with chunking strategy Balancing Speed vs Accuracy: Used prompt engineering + parallel processing Integration Cross-Browser Compatibility: Required extensive testing State Management: Complex UI and backend state syncing Robust Error Handling: Built for network failures, invalid repos, etc. Performance Bundle Optimization: Lazy loading and code splitting Memory Management: Efficient handling of large repos ๐ Accomplishments โ Seamless integration of GitHub and AI platforms โก Sub-30-second real-time security analysis ๐ Smart risk scoring algorithm for PRs ๐ก RAG implementation for contextual developer Q&A ๐จ Responsive, intuitive UI for all devices ๐ Democratizing security for small teams and solo devs ๐ What We Learned ๐ AI Prompt Engineering & Token Management ๐งฉ Advanced React patterns (hooks, context, performance) ๐ Secure, scalable API design ๐จโ๐ป UI/UX matters: User testing and feedback made a huge impact ๐ฆ Trade-offs: Performance vs features ๐ง Building with security in mind from day one ๐ค Cross-functional collaboration & Agile workflows ๐ฎ Whatโs Next ๐ Immediate (0โ3 months) ๐ Private & Enterprise GitHub support โ๏ธ Advanced vulnerability detection ๐ฅ Team features & account management ๐ฑ Mobile app for real-time monitoring ๐๏ธ Medium Term (6โ12 months) ๐งช CI/CD integration (GitHub Actions, Jenkins, etc.) ๐งท Support for GitLab, Bitbucket, etc. ๐ Customizable security policies ๐ Predictive security trend analytics ๐ Long-Term Vision (1โ2 years) ๐ง AI Security Advisor โ proactive recommendations ๐ Open Source Vulnerability DB ๐งโ๐ซ Integrated Security Education Platform ๐ Blockchain-based audit trails ๐งฌ ML pipelines for zero-day detection ๐ง Technical Enhancements (Ongoing) โก Faster access with edge computing & caching ๐ง Multi-model AI integration for specialized tasks ๐ Blockchain compliance logging ๐ Custom-trained ML models for security pattern recognition Code Sentinel Bot is our commitment to a future where security isn't an afterthought โ it's AI-assisted, real-time, and developer-first. Together, we can build a safer internet, one pull request at a time.
Code Sentinel Bot
A modern web application for code analysis and monitoring, built with React and TypeScript.
๐ Table of Contents
- Features
- Technologies
- Getting Started
- Deployment
- Custom Domain
- Project Structure
- Contributing
- License
โจ Features
- Modern, responsive UI built with shadcn-ui components
- Code analysis and monitoring capabilities
- Real-time updates and notifications
- Customizable dashboard views
- Comprehensive reporting tools
๐ ๏ธ Technologies
This project is built with:
- Vite - Next generation frontend tooling
- TypeScript - Typed JavaScript at any scale
- React - A JavaScript library for building user interfaces
- shadcn-ui - Beautifully designed components
- Tailwind CSS - A utility-first CSS framework
๐ Getting Started
Prerequisites
- Node.js (v16 or later)
- npm or yarn
Development Setup
There are several ways to set up your development environment:
Option 1: Use your preferred IDE
If you want to work locally using your own IDE, you can clone this repo and push changes. Pushed changes will also be reflected in Lovable.
# Step 1: Clone the repository using the project's Git URL
git clone <YOUR_GIT_URL>
# Step 2: Navigate to the project directory
cd <YOUR_PROJECT_NAME>
# Step 3: Install the necessary dependencies
npm install
# Step 4: Start the development server with auto-reloading
npm run dev
Option 2: Edit files directly in GitHub
- Navigate to the desired file(s)
- Click the "Edit" button (pencil icon) at the top right of the file view
- Make your changes and commit them
Option 3: Use GitHub Codespaces
- Navigate to the main page of your repository
- Click on the "Code" button (green button) near the top right
- Select the "Codespaces" tab
- Click on "New codespace" to launch a new Codespace environment
- Edit files directly within the Codespace and commit and push your changes
๐ฆ Deployment
Deploying your project is simple with Lovable:
- Open Lovable
- Navigate to Share -> Publish
- Follow the on-screen instructions to complete the deployment
๐ Custom Domain
Yes, you can connect a custom domain to your Lovable project!
To connect a domain:
- Navigate to Project > Settings > Domains
- Click "Connect Domain"
- Follow the instructions to set up DNS records
- Verify ownership and wait for DNS propagation
Read more here: Setting up a custom domain
๐ Project Structure
code-sentinel-bot/
โโโ public/ # Static assets
โ โโโ components/ # UI components
โ โโโ lib/ # Utility functions
โ โโโ pages/ # Application pages
โ โโโ styles/ # Global styles
โ โโโ App.tsx # Main application component
โ โโโ main.tsx # Entry point
โโโ package.json # Dependencies and scripts
โโโ README.md # Project documentation
๐ฅ Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
๐ License
This project is licensed under the MIT License - see the LICENSE file for details.
Analysis
View
Metric
- 6
- 4
- 2
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- AnthropicIn code
- CSSIn code
- ExpressIn code
- HTMLIn code
- JavaScriptIn code
- ReactIn code
- SupabaseIn code
- Tailwind CSSIn code
- TypeScriptIn code
- Node.jsClaimed
9 of 10 appear in the indexed code. 1 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
356 KB
Source files
84
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
thekavishshah/code-sentinel-bot
97 files ยท 959 KB ยท @ 6cf4946
Structure
Interface
61 files ยท 63%Screens, components and styles rendered to the user.
Application logic
16 files ยท 16%Domain rules, services and shared utilities.
Data & schema
5 files ยท 5%Schema definitions, migrations and data access.
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here โ open the file browser to check anything the diagram implies.
Languages
- TypeScript97%
- Markdown1%
- JavaScript1%
- CSS1%
- HTML0%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
package.json
npm ยท 76- @anthropic-ai/sdk
- @hookform/resolvers
- @octokit/rest
- @radix-ui/react-accordion
- @radix-ui/react-alert-dialog
- @radix-ui/react-aspect-ratio
- @radix-ui/react-avatar
- @radix-ui/react-checkbox
- @radix-ui/react-collapsible
- @radix-ui/react-context-menu
- @radix-ui/react-dialog
- @radix-ui/react-dropdown-menu
- @radix-ui/react-hover-card
- @radix-ui/react-label
- @radix-ui/react-menubar
- @radix-ui/react-navigation-menu
- @radix-ui/react-popover
- @radix-ui/react-progress
- +58 more
Declared in the repositoryโs manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
This projectโs features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.