What is CodePulse?
CodePulse is a local-first development assistant that connects Claude Code to Telegram. It monitors your AI coding sessions, catches every commit for review, and lets you control everything from your phone.
Prerequisites
Before installing CodePulse, make sure you have:
- Node.js 20+ installed
- Claude Code CLI installed and configured
- A Telegram account with a bot token
Installation
Getting started takes just a few commands:
git clone https://github.com/4brainiacs/codepulse.git
cd codepulse
npm install
npm run install:hooks
Configuration
Copy the environment template and add your credentials:
cp .env.example .env
You'll need to set:
TELEGRAM_BOT_TOKEN— your Telegram bot token from BotFatherTELEGRAM_CHAT_ID— your chat or group ID
Your First Session
Start CodePulse and send /start to your Telegram bot:
npm start
You should see a welcome message in Telegram confirming the connection.
What Happens Next
Once connected, CodePulse automatically:
- Intercepts commits for your review before they're pushed
- Sends permission requests when Claude needs to modify files
- Delivers a Morning Briefing summarizing overnight activity