gims 0.4.2

package/README.md

@@ -0,0 +1,150 @@
+Here’s a **complete usage guide** for `gims` (Git Made Simple) CLI tool:
+
+---
+
+## 🚀 Installation
+
+```bash
+npm install -g gims
+```
+
+This installs the `gims` command and a shortcut alias:
+
+```bash
+g  # shortcut for gims
+```
+
+---
+
+## 🔧 Environment Setup (Optional for AI)
+
+To enable AI-generated commit messages:
+
+### ✅ Option 1: Gemini API
+
+```bash
+export GEMINI_API_KEY='your_gemini_api_key'
+```
+
+### ✅ Option 2: OpenAI API (used if Gemini key not found)
+
+```bash
+export OPENAI_API_KEY='your_openai_api_key'
+```
+
+If neither is set, it defaults to a generic commit message.
+
+---
+
+## 🧠 AI Commit Modes
+
+### 1. Commit Locally with AI Message
+
+```bash
+g l      # or gims local
+```
+
+→ Adds and commits current changes locally with a descriptive commit message generated by AI.
+
+### 2. Commit & Push with AI Message
+
+```bash
+g o      # or gims online
+```
+
+→ Adds, commits, and pushes the current changes to the remote branch.
+
+---
+
+## 📚 Version History Navigation
+
+### View Git Logs (Short)
+
+```bash
+g ls     # or gims list
+```
+
+→ Shows a numbered short log:
+
+```
+1. 1234abc Added login feature
+2. 5678def Fixed bug in auth flow
+```
+
+### View Git Logs (Full)
+
+```bash
+g ll     # or gims largelist
+```
+
+→ Full `git log` (without pager).
+
+---
+
+## 🌿 Branching & Resetting
+
+### Create Branch from a Commit or Number
+
+```bash
+g b 2 try-new-idea
+```
+
+→ Branches off from commit #2 (resolved via `g ls`) into a new branch `try-new-idea`.
+
+### Reset to a Commit or Number
+
+```bash
+g r 1 --hard
+```
+
+→ Resets the current branch to commit #1 permanently (`--hard` is optional).
+
+### Revert a Commit or Number
+
+```bash
+g rv 3
+```
+
+→ Reverts changes made by commit #3 (safe, non-destructive).
+
+---
+
+## 🆕 Git Init
+
+```bash
+g i      # or gims init
+```
+
+→ Initializes a new Git repository.
+
+---
+
+## 📝 Example Workflow
+
+```bash
+cd myproject/
+g i                         # Initialize repository
+touch index.js              # Add file
+g l                         # Auto commit locally with AI
+g ls                        # See commit history
+g b 1 try-feature           # Branch out from earlier version
+```
+
+---
+
+## 📦 Dependencies Used
+
+* [`simple-git`](https://www.npmjs.com/package/simple-git) – Git CLI wrapper
+* [`openai`](https://www.npmjs.com/package/openai) – OpenAI SDK
+* [`@google-ai/gemini`](https://www.npmjs.com/package/@google-ai/gemini) – Gemini SDK
+* [`commander`](https://www.npmjs.com/package/commander) – CLI argument parser
+
+---
+
+Let me know if you’d like to:
+
+* Add auto-push branch creation
+* Show full diff preview
+* Add emojis, scopes, or conventional commits
+* Bundle this as a GUI as well!
+

package/bin/gims.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+
+/*
+  gims (Git Made Simple) CLI
+  Features:
+    - Initialize repository (init alias: i)
+    - Auto commit with AI-generated messages (Gemini or OpenAI)
+      Modes:
+        * local (alias: l)
+        * online (alias: o)
+    - Navigation:
+        * list (alias: ls): numbered git log --oneline
+        * largelist (alias: ll): full git log --no-pager
+        * branch <commit|#> [name] (alias: b)
+        * reset <commit|#> [--hard] (alias: r)
+        * revert <commit|#> (alias: rv)
+
+  Env vars:
+    - GEMINI_API_KEY: use Google Gemini API
+    - OPENAI_API_KEY: fallback to OpenAI if Gemini not set
+    - none: fallback to generic commit messages
+
+  Usage:
+    npm install -g gims
+    export GEMINI_API_KEY=...
+    export OPENAI_API_KEY=...
+    gims init   # or g i
+    gims local  # or g l
+*/
+
+const { Command } = require('commander');
+const simpleGit = require('simple-git');
+const process = require('process');
+const { OpenAI } = require('openai');
+const { GoogleGenAI } = require('@google/genai');
+
+const program = new Command();
+const git = simpleGit();
+
+// Setup AI clients
+const hasGemini = !!process.env.GEMINI_API_KEY;
+const hasOpenAI = !hasGemini && !!process.env.OPENAI_API_KEY;
+let genai, openai;
+
+if (hasGemini) {
+  genai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
+} else if (hasOpenAI) {
+  openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+}
+
+async function generateCommitMessage(diff) {
+  if (hasGemini) {
+    const res = await genai.models.generateContent({
+      model: 'gemini-2.0-flash',
+      contents: `Write a concise git commit message for these changes:\n${diff}`,
+    });
+    return res.text.trim();
+  }
+
+  if (hasOpenAI) {
+    const res = await openai.chat.completions.create({
+      model: 'gpt-4o-mini',
+      messages: [{ role: 'user', content: `Write a concise git commit message for these changes:\n${diff}` }],
+      temperature: 0.5,
+    });
+    return res.choices[0].message.content.trim();
+  }
+
+  // fallback generic
+  return 'Update project code';
+}
+
+async function resolveCommit(input) {
+  if (/^\d+$/.test(input)) {
+    const { all } = await git.log();
+    const idx = parseInt(input, 10) - 1;
+    if (idx < 0 || idx >= all.length) throw new Error('Index out of range');
+    return all[idx].hash;
+  }
+  return input;
+}
+
+program.name('gims').alias('g').version('0.4.2');
+
+program.command('init').alias('i')
+  .description('Initialize a new Git repository')
+  .action(async () => {
+    await git.init();
+    console.log('Initialized repo.');
+  });
+
+// Local commit: stage all, get staged diff, AI message, commit
+program.command('local').alias('l')
+  .description('AI-powered local commit')
+  .action(async () => {
+    // stage all changes first
+    await git.add('.');
+    // get diff of staged changes
+    const diff = await git.diff(['--cached']);
+    if (!diff) return console.log('No changes to commit.');
+    console.log('Generating commit message...');
+    const msg = await generateCommitMessage(diff);
+    await git.commit(msg);
+    console.log(`Committed locally: "${msg}"`);
+  });
+
+// Online commit: stage, diff, message, commit, push
+program.command('online').alias('o')
+  .description('AI commit + push')
+  .action(async () => {
+    await git.add('.');
+    const diff = await git.diff(['--cached']);
+    if (!diff) return console.log('No changes to commit.');
+    console.log('Generating commit message...');
+    const msg = await generateCommitMessage(diff);
+    await git.commit(msg);
+    await git.push();
+    console.log(`Committed & pushed: "${msg}"`);
+  });
+
+program.command('list').alias('ls')
+  .description('Short numbered git log')
+  .action(async () => {
+    const { all } = await git.log();
+    all.forEach((c, i) => console.log(`${i+1}. ${c.hash.slice(0,7)} ${c.message}`));
+  });
+
+program.command('largelist').alias('ll')
+  .description('Full git log without pager')
+  .action(async () => {
+    console.log(await git.raw(['--no-pager', 'log']));
+  });
+
+program.command('branch <c> [name]').alias('b')
+  .description('Branch from commit/index')
+  .action(async (c, name) => {
+    try {
+      const sha = await resolveCommit(c);
+      const br = name || `branch-${sha.slice(0,7)}`;
+      await git.checkout(['-b', br, sha]);
+      console.log(`Switched to branch ${br} at ${sha}`);
+    } catch (e) { console.error(e.message); }
+  });
+
+program.command('reset <c>').alias('r')
+  .description('Reset branch to commit/index')
+  .option('--hard', 'hard reset')
+  .action(async (c, opts) => {
+    try {
+      const sha = await resolveCommit(c);
+      const mode = opts.hard ? '--hard' : '--soft';
+      await git.raw(['reset', mode, sha]);
+      console.log(`Reset (${mode}) to ${sha}`);
+    } catch (e) { console.error(e.message); }
+  });
+
+program.command('revert <c>').alias('rv')
+  .description('Revert commit/index safely')
+  .action(async (c) => {
+    try {
+      const sha = await resolveCommit(c);
+      await git.revert(sha);
+      console.log(`Reverted ${sha}`);
+    } catch (e) { console.error(e.message); }
+  });
+
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "gims",
+  "version": "0.4.2",
+  "description": "Git Made Simple – AI‑powered git helper using Gemini / OpenAI",
+  "author": "S41R4J",
+  "license": "MIT",
+  "bin": {
+    "gims": "bin/gims.js",
+    "g": "bin/gims.js"
+  },
+  "keywords": [
+    "git",
+    "cli",
+    "ai",
+    "commit",
+    "gpt",
+    "gemini",
+    "openai",
+    "developer-tools",
+    "version-control"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/s41r4j/gims.git"
+  },
+  "bugs": {
+    "url": "https://github.com/s41r4j/gims/issues"
+  },
+  "homepage": "https://github.com/s41r4j/gims#readme",
+  "main": "bin/gims.js",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@google/genai": "^1.5.1",
+    "commander": "^11.1.0",
+    "openai": "^4.0.0",
+    "simple-git": "^3.19.1"
+  },
+  "type": "commonjs",
+  "scripts": {
+    "test": "echo \"No tests yet\" && exit 0"
+  }
+}