๐ AI-powered Git auto commit & push CLI with smart commit messages
npm install @jashg91/gitpusherbash
npm install -g @jashg91/gitpusher
``
$3
`bash
gitpusher --version
// OR you can use
gipusher -v
`
---
๐ Getting Started (Step-by-Step Setup)
$3
Go to GitPusher Dashboard and sign up with your email.
---
$3
* After login, add your API key in the dashboard.
* GitPusher securely stores your key in the DataBase (hashed) and gives you a one-time setup token.
* Copy this token โ youโll use it to link your CLI.
---
$3
In your project folder, run:
`bash
gitpusher config
? What would you like to do? (Use arrow keys)
โฏ ๐ Add Token
๐ View Usage Info
๐ Sync Usage Cache
๐๏ธ Delete Configuration
โ Exit
`
Choose โAdd Tokenโ and paste the token you copied from the dashboard.
GitPusher automatically:
* Validates your token with the backend
* Retrieves your encrypted API key
* Generates a local config file
๐งฑ Important:
Add this line to your .gitignore file:
`
gitpusher_config.json
gitpusher_usage_cache.json
`
This ensures your configuration never leaves your local system.
---
$3
`bash
Generate AI-powered commit message and push automatically
gitpusher "add new features"
Push to specific remote or branch
gitpusher "deploy to production" --remote origin
`
The CLI:
* Uses your securely stored API key for AI commits
* Tracks your usage
* Syncs data with the dashboard every 3 runs automatically
---
๐ Security Highlights
| Layer | Protection | Description |
| --------------------------- | --------------------------------------- | -------------------------------------------- |
| API Key | ๐ Hashed and never shown in plain text | Stored securely in backend |
| Dashboard Communication | ๐ช JWT in httpOnly cookie | Prevents frontend access to sensitive tokens |
| CLI Auth | ๐งฉ One-time setup token | Prevents direct key exposure |
| IP Verification | ๐ IP stored during first use | Prevents token theft or key reuse |
| Config File | ๐งฑ Local only + gitignored | Prevents accidental upload to GitHub |
| Usage Sync | ๐ Auto sync every 3 uses | Keeps analytics and usage limits accurate |
Every layer of GitPusher is designed to protect both your API credentials and your development environment.
---
๐ง How It Works (End-to-End Flow)
`text
[Frontend Dashboard] โ [Backend Server] โ [CLI Config] โ [Git Operations] โ [Dashboard Analytics]
`
$3
1. User registers/login on the GitPusher Dashboard.
2. Dashboard securely generates a hashed API key and returns a token to the user.
3. User runs gitpusher config in the CLI and enters that token.
4. CLI calls the backend to verify and store the API key securely in .gitpusher_config.json.
5. GitPusher performs smart git operations using that key (AI commits, pushes).
6. Every 3rd CLI use, usage data syncs back to the dashboard for analytics and tracking.
---
๐ Example Workflow
`
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ ๐ GitPusher โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
๐ Files to commit:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโ ๐ Modified: src/App.js
โโโ โ Added: src/utils/aiCommit.js
โโโ ๐ New: README.md
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
Files staged successfully
โ
Commit created: "feat: add AI-powered commit system"
โ
Pushed to origin/main
๐ Push Summary:
โโโ ๐ฟ Branch: main
โโโ ๐ก Remote: origin
โโโ ๐ฌ Message: feat: add AI-powered commit system
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ Done! Synced with your dashboard.
``