evophp 1.1.0 → 1.1.2

package/README.md

@@ -1,152 +1,177 @@
 # EvoPHP CLI - Comprehensive Guide
 
 ## Overview
+
 EvoPHP CLI is a command-line interface designed to simplify the development and management of projects, plugins, and themes within the EvoPHP ecosystem. With intuitive commands and shorthands, developers can quickly set up projects, manage dependencies, and handle plugin/theme creation and installation with ease.
 
 ---
 
 ## Table of Contents
-- [Installation](#installation)
-- [All Commands](#all-commands)
-  - [Initialization](#initialization)
-  - [Plugin/Theme Creation](#plugintheme-creation)
-  - [Plugin/Theme Installation](#plugintheme-installation)
-  - [Plugin/Theme Uninstallation](#plugintheme-uninstallation)
-  - [Dependency Management](#dependency-management)
-- [Notes](#notes)
-- [Further Documentation](#further-documentation)
+
+* [Installation](#installation)
+* [All Commands](#all-commands)
+
+  * [Initialization](#initialization)
+  * [Plugin/Theme Creation](#plugintheme-creation)
+  * [Plugin/Theme Installation](#plugintheme-installation)
+  * [Plugin/Theme Uninstallation](#plugintheme-uninstallation)
+  * [Dependency Management](#dependency-management)
+* [Authentication & PAT Storage](#authentication--pat-storage)
+* [Further Documentation](#further-documentation)
 
 ---
 
 ## Installation
 
 ### Prerequisites
+
 Ensure the following are installed on your system:
-- **Node.js**: Verify by running `node -v` and `npm -v`.
-- **Composer**: For managing PHP dependencies.
+
+* **Node.js**: Verify with `node -v` and `npm -v`
+* **Composer**: Required for PHP dependencies
 
 ### Install EvoPHP
-To install EvoPHP globally, run:
+
 ```bash
 npm install -g evophp
 ```
 
-This command makes the `evophp` CLI available system-wide.
+This makes the `evophp` CLI available globally.
 
 ---
 
 ## All Commands
 
 ### Initialization
+
 ```bash
-evophp init ?<project-name>
+evophp init [project-name]
 ```
-- Initialize a new project.
-- Examples:
+
+* Initializes a new EvoPHP project.
+* Examples:
+
   ```bash
   evophp init
-  evophp init example-project
+  evophp init my-project
   ```
 
 ---
 
 ### Plugin/Theme Creation
+
 ```bash
-evophp n | new plugin | theme <author>/<name>
+evophp new plugin <name>
+evophp new theme <name>
+evophp n plugin <name>
+evophp n theme <name>
 ```
-- Create a new plugin or theme.
-- Examples:
-  - Plugin:
-    ```bash
-    evophp new plugin example-author/example-plugin
-    evophp n plugin example-author/example-plugin
-    ```
-  - Theme:
-    ```bash
-    evophp new theme example-author/example-theme
-    evophp n theme example-author/example-theme
-    ```
+
+* Creates a new plugin or theme from a template in **your own GitHub account**.
+
+* Supports:
+
+  * Just `<name>` → Uses your GitHub account (token required)
+  * ⚠️ You can only create repositories under your GitHub account.
+
+* Examples:
+
+  ```bash
+  evophp new plugin MyPlugin              # Creates in your GitHub
+  evophp n theme MyTheme                  # Creates in your GitHub
+  ```
 
 ---
 
 ### Plugin/Theme Installation
+
 ```bash
-evophp i | install plugin | theme <author>/<name>
+evophp install plugin <name>
+evophp install theme <name>
+evophp i plugin <name>
+evophp i theme <name>
 ```
-- Install a plugin or theme.
-- Examples:
-  - Plugin:
-    ```bash
-    evophp install plugin example-author/example-plugin
-    evophp i plugin example-author/example-plugin
-    ```
-  - Theme:
-    ```bash
-    evophp install theme example-author/example-theme
-    evophp i theme example-author/example-theme
-    ```
+
+* Installs a plugin or theme from GitHub into your project.
+
+* Supports:
+
+  * Just `<name>` → Clones from your GitHub account (token required)
+  * `<author>/<name>` → Clones from public GitHub repo (no token required)
+
+* Examples:
+
+  ```bash
+  evophp install plugin MyPlugin
+  evophp i theme johndoe/EvoTheme
+  ```
 
 ---
 
 ### Plugin/Theme Uninstallation
+
 ```bash
-evophp u | uninstall plugin | theme <plugin-name>
+evophp uninstall plugin <name>
+evophp uninstall theme <name>
+evophp u plugin <name>
+evophp u theme <name>
 ```
-- Uninstall a plugin or theme.
-- Examples:
-  - Plugin:
-    ```bash
-    evophp uninstall plugin example-plugin
-    evophp u plugin example-plugin
-    ```
-  - Theme:
-    ```bash
-    evophp uninstall theme example-theme
-    evophp u theme example-theme
-    ```
+
+* Removes the installed plugin or theme from the project.
+
+* Examples:
+
+  ```bash
+  evophp uninstall plugin MyPlugin
+  evophp u theme EvoTheme
+  ```
 
 ---
 
 ### Dependency Management
+
 ```bash
-evophp d | install-dependencies <plugin-name>
+evophp install-dependencies <plugin-name>
+evophp d <plugin-name>
 ```
-- Install npm production dependencies.
-- Examples:
-  ```bash
-  evophp install-dependencies example-plugin
-  evophp d example-plugin
-  ```
 
-#### Development Dependencies
+* Adds or installs plugin dependencies.
+
+#### Production (npm):
+
 ```bash
-evophp d | install-dependencies <plugin-name> --dev | --save-dev
+evophp d MyPlugin
 ```
-- Install npm development dependencies.
-- Examples:
-  ```bash
-  evophp install-dependencies example-plugin --dev
-  evophp d example-plugin --dev
-  ```
 
-#### Composer Dependencies
+#### Development (npm):
+
 ```bash
-evophp d | install-dependencies <plugin-name> --composer
+evophp d MyPlugin --dev
+```
+
+#### PHP (Composer):
+
+```bash
+evophp d MyPlugin --composer
 ```
-- Install composer dependencies.
-- Examples:
-  ```bash
-  evophp install-dependencies example-plugin --composer
-  evophp d example-plugin --composer
-  ```
 
 ---
 
-## Notes
-- `<author>` must be a valid GitHub username.
-- `<name>` must be a unique repository name (not already existing on GitHub).
+## Authentication & PAT Storage
+
+When using a command with just `<name>` (e.g. `evophp new plugin MyPlugin`), EvoPHP CLI will:
+
+* Prompt you for a **GitHub Personal Access Token** (PAT) the first time
+* Automatically store it in `.env.development` for future use
+* Use that token to fetch your GitHub username and manage private/public repos
+
+> ⚠️ You can only create repositories in your own GitHub account.
+
+> To change your token later, simply edit or delete `.env.development`.
 
 ---
 
 ## Further Documentation
-For additional details, best practices, and advanced usage, please refer to the [official EvoPHP documentation](#).
+
+More advanced use cases, templates, and configuration details coming soon at:
+📘 [Official EvoPHP Documentation](#)

package/bin/evophp.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 
-const yargs = require("yargs/yargs")(process.argv.slice(2));
+const yargs = require("yargs");
 const { hideBin } = require("yargs/helpers");
 
 yargs(hideBin(process.argv))
-  .command(require("../commands/new"))
   .command(require("../commands/init"))
+  .command(require("../commands/new"))
+  .command(require("../commands/install"))
   .command(require("../commands/uninstall"))
   .command(require("../commands/dependencies"))
   .command(require("../commands/help"))

package/commands/help.js

@@ -9,52 +9,53 @@ module.exports = {
         EvoPHP CLI - Help Guide
 ==========================================
 
-Initialization:
-  evophp init [project-name]         
+📦 Initialization:
+  evophp init [project-name]
       → Initialize a new Evolution PHP project.
       → Aliases: none
-      → Example: evophp init my-project
+      → Example: evophp init my-coop-project
 
-Plugin/Theme Creation:
-  evophp new plugin <author>/<name>  
-  evophp n plugin <author>/<name>    
-      → Create a new plugin from template.
-      → Aliases: new → n
-      → Example: evophp n plugin johndoe/exampleplugin
+🛠️  Plugin & Theme Creation:
+  evophp new plugin <name>
+  evophp new theme <name>
+  evophp n plugin <name>
+  evophp n theme <name>
+      → Create a plugin or theme from template repo.
+      → Supports:
+         • just <name> → uses your GitHub account
+         • author/name → uses any GitHub account
 
-  evophp new theme <author>/<name>   
-  evophp n theme <author>/<name>     
-      → Create a new theme from template.
+⬇️  Plugin & Theme Installation:
+  evophp install plugin <name>
+  evophp install plugin author/name
+  evophp i theme <name>
+  evophp i theme author/name
+      → Install a plugin or theme from GitHub into your project.
+      → Format options:
+         • just <name> → installs from your GitHub account
+         • author/name → installs from public GitHub repo
 
-Plugin/Theme Installation:
-  evophp install plugin <author>/<name>  
-  evophp i plugin <author>/<name>        
-      → Install a plugin from GitHub.
-      → Aliases: install → i
+🗑️  Plugin & Theme Uninstallation:
+  evophp uninstall plugin <name>
+  evophp uninstall theme <name>
+  evophp u plugin <name>
+  evophp u theme <name>
+      → Remove an installed plugin or theme and update config.
 
-  evophp install theme <author>/<name>   
-  evophp i theme <author>/<name>         
-      → Install a theme from GitHub.
-
-Plugin/Theme Uninstallation:
-  evophp uninstall plugin <name>     
-  evophp u plugin <name>             
-      → Remove installed plugin.
-      → Aliases: uninstall → u
-
-  evophp uninstall theme <name>      
-  evophp u theme <name>              
-      → Remove installed theme.
-
-Dependency Management:
+🔧 Dependency Management:
   evophp install-dependencies <plugin>
   evophp d <plugin> [--dev|--composer]
-      → Add and install dependencies.
-      → JS dev: --dev
-      → PHP: --composer
+      → Add and install dependencies for a plugin:
+         --dev      → JavaScript development dependencies
+         --composer → PHP dependencies via Composer
       → Aliases: install-dependencies → d
 
-General:
+🔐 GitHub Authentication:
+  When installing or creating with just <name>,
+  the CLI will prompt for your GitHub PAT and store it
+  in .env.development for future runs.
+
+❓ General:
   evophp help
   evophp h
       → Show this help guide.
@@ -62,7 +63,7 @@ General:
 
 ==========================================
   Tip: Use --help after any command
-       for command-specific usage.
+       for more usage examples.
 ==========================================
     `);
     process.exit(0);

package/commands/install.js

@@ -1,22 +1,24 @@
 const path = require('path');
 const fs = require('fs');
 const { execSync } = require('child_process');
-const { readLineAsync, splitPluginName, mergeConfig } = require('../utils/helpers');
+const { readLineAsync, mergeConfig, saveToEnv } = require('../utils/helpers');
+const { getUserData } = require('../utils/github');
 const { cloneRepo } = require('../utils/git');
 const { installDependencies } = require('../utils/dependencies');
 const log = require('../utils/logger');
+require("dotenv").config({ path: "./.env.development" });
 
 module.exports = {
   command: 'install [type] [name]',
   aliases: ['i'],
   describe: 'Install a plugin or theme',
+
   builder: yargs => yargs
     .positional('type', { describe: 'plugin or theme', type: 'string' })
-    .positional('name', { describe: 'author/plugin-name', type: 'string' }),
+    .positional('name', { describe: 'name or author/name', type: 'string' }),
 
   handler: async ({ type, name }) => {
     try {
-      // Prompt if missing
       if (!type || !['plugin', 'theme'].includes(type.toLowerCase())) {
         type = await readLineAsync("What are you installing? (plugin/theme): ");
         type = type.toLowerCase();
@@ -27,30 +29,46 @@ module.exports = {
       }
 
       if (!name) {
-        name = await readLineAsync(`Enter the ${type} name (e.g., johndoe/example${type}): `);
+        name = await readLineAsync(`Enter the ${type} name (e.g., myplugin or johndoe/myplugin): `);
       }
 
-      const [author, itemName] = await splitPluginName(name);
+      let author, pluginName;
+      let gitHubToken = process.env.GITHUB_TOKEN;
+
+      if (name.includes("/")) {
+        // Full author/name provided — no auth required
+        [author, pluginName] = name.split("/");
+      } else {
+        // Token required to determine user
+        if (!gitHubToken) {
+          gitHubToken = await readLineAsync("Enter your GitHub Personal Access Token: ");
+          saveToEnv("GITHUB_TOKEN", gitHubToken);
+          log.success("GitHub token saved to .env.development");
+        }
+        const userData = await getUserData(gitHubToken);
+        author = userData.login;
+        pluginName = name;
+        log.info(`Authenticated as ${author}`);
+      }
 
       const paths = type === 'plugin'
-        ? [path.join('Public', 'Modules', itemName), path.join('EvoJsDev', 'Modules', itemName)]
-        : [path.join('Public', 'Themes', itemName)];
+        ? [path.join('Public', 'Modules', pluginName), path.join('EvoJsDev', 'Modules', pluginName)]
+        : [path.join('Public', 'Themes', pluginName)];
 
-      // Check existing
       for (const p of paths) {
         if (fs.existsSync(p)) {
-          log.warn(`${type} "${itemName}" already exists at ${p}`);
+          log.warn(`${type} "${pluginName}" already exists at ${p}`);
           process.exit(0);
         }
       }
 
-      log.info(`Installing ${type} "${itemName}" by ${author}...`);
+      log.info(`Installing ${type} "${pluginName}" from ${author}...`);
 
       if (type === 'plugin') {
-        await cloneRepo(`https://github.com/${author}/${itemName}.git`, paths[0]);
-        await cloneRepo(`https://github.com/${author}/${itemName}.js.git`, paths[1]);
+        await cloneRepo(`${author}/${pluginName}`, null, paths[0]);
+        await cloneRepo(`${author}/${pluginName}.js`, null, paths[1]);
 
-        const configFile = path.resolve(`./EvoJsDev/Modules/${itemName}/config.json`);
+        const configFile = path.resolve(`./EvoJsDev/Modules/${pluginName}/config.json`);
         if (fs.existsSync(configFile)) {
           const pluginConfig = require(configFile);
           mergeConfig(pluginConfig);
@@ -60,10 +78,11 @@ module.exports = {
         await installDependencies(paths[0], 'php');
 
       } else if (type === 'theme') {
-        await cloneRepo(`https://github.com/${author}/${itemName}.git`, paths[0]);
+        await cloneRepo(`${author}/${pluginName}`, null, paths[0]);
       }
 
-      log.success(`The ${type} "${itemName}" has been installed successfully.`);
+      log.success(`The ${type} "${pluginName}" has been installed successfully.`);
+
     } catch (err) {
       log.error(`Install failed: ${err.message}`);
       process.exit(1);

package/commands/new.js

@@ -1,25 +1,41 @@
 const path = require("path");
 const fs = require("fs");
-const { readLineAsync, splitPluginName, mergeConfig } = require("../utils/helpers");
+const { readLineAsync, mergeConfig } = require("../utils/helpers");
 const { getUserData, createGitHubRepo } = require("../utils/github");
-const { cloneRepository } = require("../utils/git");
+const { cloneRepo } = require("../utils/git");
 const { editFile, renameFile } = require("../utils/edit");
 const { test } = require("../utils/validate");
 const log = require("../utils/logger");
 require("dotenv").config({ path: "./.env.development" });
 
 module.exports = {
-  command: "new <type> <author>/<name>",
+  command: "new <type> <name>",
   aliases: ["n"],
   describe: "Create a new plugin or theme from template",
-  builder: yargs =>
+
+  builder: (yargs) =>
     yargs
-      .positional("type", { describe: "plugin or theme", type: "string" })
-      .positional("author/name", { describe: "GitHub format name", type: "string" }),
+      .positional("type", {
+        describe: "plugin or theme",
+        type: "string",
+      })
+      .positional("name", {
+        describe: "The plugin or theme name (without author)",
+        type: "string",
+      }),
 
   handler: async ({ type, name }) => {
     try {
-      const gitHubToken = process.env.GITHUB_TOKEN || await readLineAsync("Enter GitHub PAT: ");
+      let gitHubToken = process.env.GITHUB_TOKEN;
+
+      if (!gitHubToken) {
+        gitHubToken = await readLineAsync(
+          "Enter GitHub Personal Access Token: "
+        );
+        const { saveToEnv } = require("../utils/helpers");
+        saveToEnv("GITHUB_TOKEN", gitHubToken);
+        log.success("GitHub token saved to .env.development");
+      }
       type = type.toLowerCase();
 
       if (!["plugin", "theme"].includes(type)) {
@@ -27,14 +43,13 @@ module.exports = {
         process.exit(1);
       }
 
-      const [author, pluginName] = await splitPluginName(name);
+      // Get authenticated username from token
       const userData = await getUserData(gitHubToken);
-      if (userData.login !== author) {
-        log.error(`Token belongs to ${userData.login}, expected ${author}`);
-        process.exit(1);
-      }
+      const author = userData.login;
+      const pluginName = name;
 
-      log.info(`Authenticated as ${userData.login}`);
+      log.info(`Authenticated as ${author}`);
+      log.info(`Creating ${type} "${pluginName}"...`);
 
       if (type === "plugin") {
         const entry = await setupPlugin(gitHubToken, author, pluginName);
@@ -43,12 +58,11 @@ module.exports = {
         await setupTheme(gitHubToken, author, pluginName);
         log.success(`Theme "${pluginName}" created`);
       }
-
     } catch (err) {
       log.error(`Creation failed: ${err.message}`);
       process.exit(1);
     }
-  }
+  },
 };
 
 async function setupPlugin(token, author, pluginName) {
@@ -56,32 +70,55 @@ async function setupPlugin(token, author, pluginName) {
   const pluginPrefix = entry.replace("Main", "");
 
   await editFile(`./Public/Modules/${pluginName}/Routes.php`, {
-    pluginName, entry, entryURI: entry.toLowerCase(), pluginPrefix
+    pluginName,
+    entry,
+    entryURI: entry.toLowerCase(),
+    pluginPrefix,
   });
 
   const controllerPath = `./Public/Modules/${pluginName}/Controller.php`;
   if (fs.existsSync(controllerPath)) {
     await editFile(controllerPath, { pluginName, pluginPrefix });
-    await renameFile(controllerPath, `./Public/Modules/${pluginName}/${pluginPrefix}Controller.php`);
-    await renameFile(`./Public/Modules/${pluginName}/Views/Entry`, `./Public/Modules/${pluginName}/Views/${entry}`);
+    await renameFile(
+      controllerPath,
+      `./Public/Modules/${pluginName}/${pluginPrefix}Controller.php`
+    );
+    await renameFile(
+      `./Public/Modules/${pluginName}/Views/Entry`,
+      `./Public/Modules/${pluginName}/Views/${entry}`
+    );
   }
 
   return entry;
 }
 
 async function setupPluginRepo(token, author, pluginName) {
-  await createGitHubRepo(token, 'kinsokafor/EvoPlugin', pluginName);
-  await cloneRepository(author, pluginName, path.join('Public', 'Modules', pluginName));
-
-  await createGitHubRepo(token, 'kinsokafor/EvoPlugin.js', `${pluginName}.js`);
-  await cloneRepository(author, `${pluginName}.js`, path.join('EvoJsDev', 'Modules', pluginName));
-
-  const pluginPrefix = await getValidatedInput("Enter Plugin Prefix?", 3, true).then(x => x.toUpperCase());
-  const entryURI = await getValidatedInput("Entry URI?", 20).then(x => x.toLowerCase());
+  await createGitHubRepo(token, "kinsokafor/EvoPlugin", pluginName);
+  await cloneRepo(
+    author,
+    pluginName,
+    path.join("Public", "Modules", pluginName)
+  );
+
+  await createGitHubRepo(token, "kinsokafor/EvoPlugin.js", `${pluginName}.js`);
+  await cloneRepo(
+    author,
+    `${pluginName}.js`,
+    path.join("EvoJsDev", "Modules", pluginName)
+  );
+
+  const pluginPrefix = await getValidatedInput("Enter Plugin Prefix?", 3, true);
+  const entryURI = await getValidatedInput("Entry URI?", 20);
   const entry = pluginPrefix + "Main";
 
-  await editFile(`./EvoJsDev/Modules/${pluginName}/config.json`, { pluginName, entry });
-  await renameFile(`./EvoJsDev/Modules/${pluginName}/Entry`, `./EvoJsDev/Modules/${pluginName}/${entry}`);
+  await editFile(`./EvoJsDev/Modules/${pluginName}/config.json`, {
+    pluginName,
+    entry,
+  });
+  await renameFile(
+    `./EvoJsDev/Modules/${pluginName}/Entry`,
+    `./EvoJsDev/Modules/${pluginName}/${entry}`
+  );
 
   const configPath = `./EvoJsDev/Modules/${pluginName}/config.json`;
   if (fs.existsSync(configPath)) {
@@ -93,18 +130,32 @@ async function setupPluginRepo(token, author, pluginName) {
 }
 
 async function setupTheme(token, author, pluginName) {
-  await createGitHubRepo(token, 'kinsokafor/EvoTheme', pluginName);
-  await cloneRepository(author, pluginName, path.join('Public', 'Themes', pluginName));
-
-  await editFile(`./Public/Themes/${pluginName}/Data/index.data.php`, { pluginName });
-  await editFile(`./Public/Themes/${pluginName}/Data/login.data.php`, { pluginName });
-  await editFile(`./Public/Themes/${pluginName}/Views/index.blade.php`, { pluginName });
-  await editFile(`./Public/Themes/${pluginName}/Views/login.blade.php`, { pluginName });
+  await createGitHubRepo(token, "kinsokafor/EvoTheme", pluginName);
+  await cloneRepo(
+    author,
+    pluginName,
+    path.join("Public", "Themes", pluginName)
+  );
+
+  await editFile(`./Public/Themes/${pluginName}/Data/index.data.php`, {
+    pluginName,
+  });
+  await editFile(`./Public/Themes/${pluginName}/Data/login.data.php`, {
+    pluginName,
+  });
+  await editFile(`./Public/Themes/${pluginName}/Views/index.blade.php`, {
+    pluginName,
+  });
+  await editFile(`./Public/Themes/${pluginName}/Views/login.blade.php`, {
+    pluginName,
+  });
 }
 
 async function getValidatedInput(label, maxLength, caps = false) {
   let input = await readLineAsync(label);
-  while (!test(input, maxLength)) input = await readLineAsync(label);
+  while (!test(input, maxLength)) {
+    input = await readLineAsync(label);
+  }
   input = input.trim().replaceAll(" ", "");
   return caps ? input.toUpperCase() : input.toLowerCase();
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evophp",
-  "version": "1.1.0",
+  "version": "1.1.02",
   "description": "Command-line installer for the Evolution PHP framework",
   "bin": {
     "evophp": "./bin/evophp.js"

package/utils/git.js

@@ -1,14 +1,46 @@
-const { execSync } = require('child_process');
-const fs = require('fs');
-const log = require('./logger');
-
-async function cloneRepo(repoUrl, destination) {
-  if (fs.existsSync(destination)) {
-    log.warn(`Path already exists: ${destination}`);
-    return;
+const { execSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const rimraf = require("rimraf");
+const log = require("./logger");
+
+/**
+ * Clone a GitHub repo into a destination folder.
+ * Supports:
+ *   cloneRepo("author", "repo", "dest")
+ *   cloneRepo("author/repo", null, "dest")
+ *
+ * @param {string} authorOrFull - GitHub username OR "author/repo"
+ * @param {string|null} repo - Optional repo name if not included in first arg
+ * @param {string} dest - Local destination path
+ */
+async function cloneRepo(authorOrFull, repo, dest) {
+  let author = "";
+  let repoName = "";
+
+  if (repo === null || repo === undefined) {
+    // authorOrFull is in "author/repo" format
+    const parts = authorOrFull.split("/");
+    if (parts.length !== 2) {
+      log.error("Invalid GitHub repo format. Use 'author/repo'.");
+      process.exit(1);
+    }
+    [author, repoName] = parts;
+  } else {
+    // Passed separately
+    author = authorOrFull;
+    repoName = repo;
+  }
+
+  const cloneUrl = `https://github.com/${author}/${repoName}.git`;
+
+  if (fs.existsSync(dest)) {
+    log.warn(`Deleting existing folder: ${dest}`);
+    rimraf.sync(dest);
   }
-  log.info(`Cloning ${repoUrl} → ${destination}`);
-  execSync(`git clone ${repoUrl} ${destination}`, { stdio: 'inherit' });
+
+  log.info(`Cloning ${author}/${repoName} → ${dest}`);
+  execSync(`git clone ${cloneUrl} ${dest}`, { stdio: "inherit" });
 }
 
-module.exports = { cloneRepo };
+module.exports = { cloneRepo };

package/utils/github.js

@@ -0,0 +1,49 @@
+// utils/github.js
+const axios = require("axios");
+const log = require("./logger");
+
+async function getUserData(token) {
+  try {
+    const res = await axios.get("https://api.github.com/user", {
+      headers: {
+        Authorization: `token ${token}`,
+        Accept: "application/vnd.github.v3+json",
+      },
+    });
+    return res.data;
+  } catch (e) {
+    log.error("Failed to fetch GitHub user info.");
+    throw e;
+  }
+}
+
+async function createGitHubRepo(token, templateRepo, pluginName) {
+  try {
+    const res = await axios.post(
+      `https://api.github.com/repos/${templateRepo}/generate`,
+      {
+        name: pluginName,
+        private: true,
+        description: `A new ${templateRepo.split("/")[1]} created from template.`,
+      },
+      {
+        headers: {
+          Authorization: `token ${token}`,
+          Accept: "application/vnd.github.v3+json",
+        },
+      }
+    );
+
+    if (res.status === 201) {
+      log.success(`Created repo ${pluginName} from ${templateRepo}`);
+    } else {
+      log.error("Failed to create repo:", res.data);
+      process.exit(1);
+    }
+  } catch (e) {
+    log.error(`GitHub repo creation failed: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+module.exports = { getUserData, createGitHubRepo };

package/utils/helpers.js

@@ -122,9 +122,40 @@ function addPluginEntry(pluginName, entryName) {
   log.success(`Added entry "${entryPath}" to ${pluginName} config.`);
 }
 
+const fs = require("fs");
+const path = require("path");
+
+/**
+ * Save a key-value pair to .env.development (creates or updates)
+ * @param {string} key
+ * @param {string} value
+ */
+function saveToEnv(key, value) {
+  const envPath = path.resolve(".env.development");
+
+  let env = "";
+  if (fs.existsSync(envPath)) {
+    env = fs.readFileSync(envPath, "utf-8");
+  }
+
+  const regex = new RegExp(`^${key}=.*$`, "m");
+  const line = `${key}=${value.trim()}`;
+
+  if (regex.test(env)) {
+    // Update existing key
+    env = env.replace(regex, line);
+  } else {
+    // Append new key
+    env += (env.endsWith("\n") ? "" : "\n") + line + "\n";
+  }
+
+  fs.writeFileSync(envPath, env, "utf-8");
+}
+
 module.exports = {
   readLineAsync,
   splitPluginName,
   mergeConfig,
-  addPluginEntry
+  addPluginEntry,
+  saveToEnv
 };