git-quickcommit-cli 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,92 @@
+# quickcommit
+
+A global CLI utility that executes your full Git cycle with one command: `git add .`, `git commit -m`, and `git push`.
+
+## Install
+
+```bash
+npm install -g git-quickcommit-cli
+```
+
+## Usage
+
+```bash
+qc "your commit message"
+```
+
+## What it does
+
+When you run:
+
+```bash
+qc "update login flow"
+```
+
+it executes this flow:
+
+1. `git add .`
+2. `git commit -m "update login flow"`
+3. `git push` (or `git push --set-upstream origin <branch>` if upstream is missing)
+
+## `bin/qc.js` Logic
+
+```text
+qc "commit message"
+  |
+  +--> commit message provided?
+  |      +--> no  -> error and exit
+  |      +--> yes
+  |
+  +--> inside a git repository?
+  |      +--> no  -> error and exit
+  |      +--> yes
+  |
+  +--> detect current branch
+  +--> upstream exists?
+         +--> yes:
+         |      +--> git fetch
+         |      +--> local branch behind remote?
+         |             +--> yes -> "update branch first" and exit
+         |             +--> no  -> continue
+         |
+         +--> no:
+                +--> continue
+  |
+  +--> git add .
+  +--> git commit -m "message"
+  +--> upstream exists?
+         +--> yes -> git push
+         +--> no  -> git push --set-upstream origin <branch>
+  |
+  +--> done
+```
+
+Command sequence used internally:
+
+1. `git rev-parse --is-inside-work-tree`
+2. `git rev-parse --abbrev-ref HEAD`
+3. `git rev-parse --abbrev-ref --symbolic-full-name @{u}`
+4. If upstream exists: `git fetch`
+5. If upstream exists: `git rev-list --left-right --count HEAD...@{u}` (block when behind remote)
+6. `git add .`
+7. `git commit -m "your message"`
+8. `git push` or `git push --set-upstream origin <branch>`
+
+## Requirements
+
+- Node.js 14+
+- Git installed and available in PATH
+
+## Notes
+
+- Run `qc` only inside a git repository.
+- If your local branch is behind remote, `qc` stops and asks you to update the branch first.
+- If `git commit` fails (for example, no changes staged), the process stops and prints the git error.
+
+## License
+
+MIT
+
+## Repository
+
+https://github.com/vanholler/quickcommit.git

package/bin/qc.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+
+const COLORS = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m'
+};
+
+function logInfo(message) {
+  console.log(`${COLORS.cyan}${message}${COLORS.reset}`);
+}
+
+function logSuccess(message) {
+  console.log(`${COLORS.green}${message}${COLORS.reset}`);
+}
+
+function logWarn(message) {
+  console.log(`${COLORS.yellow}${message}${COLORS.reset}`);
+}
+
+function logError(message) {
+  console.error(`${COLORS.red}${message}${COLORS.reset}`);
+}
+
+function run(command, options = {}) {
+  return execSync(command, {
+    stdio: options.capture ? 'pipe' : 'inherit',
+    encoding: 'utf8'
+  });
+}
+
+function safeRun(command) {
+  try {
+    return run(command, { capture: true }).trim();
+  } catch (_error) {
+    return null;
+  }
+}
+
+function main() {
+  const message = process.argv.slice(2).join(' ').trim();
+
+  if (!message) {
+    logError('Error: please provide a commit message. Example: qc "my message"');
+    process.exit(1);
+  }
+
+  const insideRepo = safeRun('git rev-parse --is-inside-work-tree');
+  if (insideRepo !== 'true') {
+    logError('Error: current directory is not a git repository.');
+    process.exit(1);
+  }
+
+  try {
+    const branch = safeRun('git rev-parse --abbrev-ref HEAD');
+    if (!branch || branch === 'HEAD') {
+      logError('Error: unable to determine current branch.');
+      process.exit(1);
+    }
+
+    const upstream = safeRun('git rev-parse --abbrev-ref --symbolic-full-name @{u}');
+    if (upstream) {
+      logInfo('Checking remote updates: git fetch');
+      run('git fetch');
+
+      const counts = safeRun('git rev-list --left-right --count HEAD...@{u}');
+      const parts = counts ? counts.split(/\s+/) : [];
+      const behind = Number(parts[1] || 0);
+
+      if (behind > 0) {
+        logError('Error: local branch is behind remote. Сначала обновите ветку.');
+        process.exit(1);
+      }
+    }
+
+    logInfo('1/3 Running: git add .');
+    run('git add .');
+
+    logInfo(`2/3 Running: git commit -m "${message}"`);
+    run(`git commit -m ${JSON.stringify(message)}`);
+
+    if (upstream) {
+      logInfo('3/3 Running: git push');
+      run('git push');
+    } else {
+      logWarn(`No upstream for branch "${branch}". Setting upstream to origin/${branch}.`);
+      logInfo(`3/3 Running: git push --set-upstream origin ${branch}`);
+      run(`git push --set-upstream origin ${branch}`);
+    }
+
+    logSuccess('Done: changes added, committed, and pushed successfully.');
+  } catch (error) {
+    logError('Failed: command execution stopped due to an error.');
+    if (error && error.message) {
+      logError(error.message);
+    }
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "git-quickcommit-cli",
+  "version": "1.0.1",
+  "description": "Run git add, commit, and push in one command from the terminal.",
+  "author": {
+    "name": "vanholler",
+    "email": "vanholler@mail.ru",
+    "url": "https://github.com/vanholler"
+  },
+  "homepage": "https://github.com/vanholler/quickcommit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vanholler/quickcommit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vanholler/quickcommit/issues"
+  },
+  "bin": {
+    "qc": "bin/qc.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node ./bin/qc.js",
+    "pack:check": "npm pack --dry-run"
+  },
+  "keywords": [
+    "git",
+    "commit",
+    "push",
+    "automation",
+    "quickcommit",
+    "cli",
+    "productivity"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=14"
+  }
+}