@tnqai/alim 1.0.0

package/README.md

@@ -0,0 +1,67 @@
+# alim
+
+A simple and elegant alias manager for your shell.
+
+## Features
+
+- 📦 Organize aliases by category (git, docker, system, npm, misc)
+- 🔍 Search aliases by name or command
+- 💾 Export/import aliases as JSON
+- 🎯 Auto-configure shell (bash/zsh)
+- 🚀 Simple CLI interface
+
+## Installation
+
+```bash
+npm install -g alim
+```
+
+## Usage
+
+```bash
+# List all aliases
+alm list
+
+# List aliases by category
+alm list git
+
+# Add a new alias
+alm add gst "git status" git
+
+# Search aliases
+alm find push
+
+# Remove an alias
+alm remove gst
+
+# Show categories
+alm categories
+
+# Export aliases
+alm export backup.json
+
+# Import aliases
+alm import backup.json
+```
+
+## Categories
+
+- `git` - Git-related aliases
+- `docker` - Docker commands
+- `system` - System utilities
+- `npm` - NPM/Node.js commands
+- `misc` - Miscellaneous aliases
+
+## How it works
+
+alim stores your aliases in `~/.aliases/` directory, organized by category. It automatically adds source commands to your shell config file (`.bashrc` or `.zshrc`).
+
+After adding or removing aliases, run:
+
+```bash
+source ~/.bashrc  # or ~/.zshrc
+```
+
+## License
+
+MIT

package/alias-manager.js

@@ -0,0 +1,273 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const ALIAS_DIR = path.join(os.homedir(), '.aliases');
+const CATEGORIES = ['git', 'docker', 'system', 'npm', 'misc'];
+
+// Ensure alias directory exists
+if (!fs.existsSync(ALIAS_DIR)) {
+  fs.mkdirSync(ALIAS_DIR, { recursive: true });
+}
+
+// Get shell config file
+function getShellConfig() {
+  const shell = process.env.SHELL || '';
+  if (shell.includes('zsh')) return path.join(os.homedir(), '.zshrc');
+  if (shell.includes('bash')) return path.join(os.homedir(), '.bashrc');
+  return path.join(os.homedir(), '.bashrc');
+}
+
+// Load aliases from category file
+function loadCategory(category) {
+  const file = path.join(ALIAS_DIR, `${category}.sh`);
+  if (!fs.existsSync(file)) return [];
+  
+  const content = fs.readFileSync(file, 'utf8');
+  const aliases = [];
+  
+  content.split('\n').forEach(line => {
+    const match = line.match(/^alias\s+([^=]+)=['"](.+)['"]/);
+    if (match) {
+      aliases.push({ name: match[1], command: match[2], category });
+    }
+  });
+  
+  return aliases;
+}
+
+// Load all aliases
+function loadAllAliases() {
+  const all = [];
+  CATEGORIES.forEach(cat => {
+    all.push(...loadCategory(cat));
+  });
+  return all;
+}
+
+// Save alias to category file
+function saveAlias(name, command, category) {
+  const file = path.join(ALIAS_DIR, `${category}.sh`);
+  const line = `alias ${name}='${command}'\n`;
+  fs.appendFileSync(file, line);
+}
+
+// Remove alias from category file
+function removeAlias(name, category) {
+  const file = path.join(ALIAS_DIR, `${category}.sh`);
+  if (!fs.existsSync(file)) return false;
+  
+  const content = fs.readFileSync(file, 'utf8');
+  const lines = content.split('\n').filter(line => {
+    const match = line.match(/^alias\s+([^=]+)=/);
+    return !match || match[1] !== name;
+  });
+  
+  fs.writeFileSync(file, lines.join('\n'));
+  return true;
+}
+
+// Ensure shell config sources alias files
+function ensureShellConfig() {
+  const shellConfig = getShellConfig();
+  const sourceLines = CATEGORIES.map(cat => 
+    `[ -f ~/.aliases/${cat}.sh ] && source ~/.aliases/${cat}.sh`
+  ).join('\n');
+  
+  if (!fs.existsSync(shellConfig)) {
+    fs.writeFileSync(shellConfig, sourceLines + '\n');
+    return;
+  }
+  
+  const content = fs.readFileSync(shellConfig, 'utf8');
+  if (!content.includes('.aliases/')) {
+    fs.appendFileSync(shellConfig, '\n# Alias Manager\n' + sourceLines + '\n');
+  }
+}
+
+// Commands
+const commands = {
+  list(args) {
+    const category = args[0];
+    const aliases = category ? loadCategory(category) : loadAllAliases();
+    
+    if (aliases.length === 0) {
+      console.log('No aliases found.');
+      return;
+    }
+    
+    console.log('\n📋 Aliases:\n');
+    
+    if (category) {
+      aliases.forEach(a => {
+        console.log(`  ${a.name.padEnd(20)} → ${a.command}`);
+      });
+    } else {
+      const grouped = {};
+      aliases.forEach(a => {
+        if (!grouped[a.category]) grouped[a.category] = [];
+        grouped[a.category].push(a);
+      });
+      
+      Object.entries(grouped).forEach(([cat, items]) => {
+        console.log(`\n[${cat}]`);
+        items.forEach(a => {
+          console.log(`  ${a.name.padEnd(20)} → ${a.command}`);
+        });
+      });
+    }
+    console.log();
+  },
+  
+  find(args) {
+    const keyword = args[0];
+    if (!keyword) {
+      console.error('Usage: alias-manager find <keyword>');
+      process.exit(1);
+    }
+    
+    const aliases = loadAllAliases();
+    const matches = aliases.filter(a => 
+      a.name.includes(keyword) || a.command.includes(keyword)
+    );
+    
+    if (matches.length === 0) {
+      console.log(`No aliases found matching "${keyword}"`);
+      return;
+    }
+    
+    console.log(`\n🔍 Found ${matches.length} matches:\n`);
+    matches.forEach(a => {
+      console.log(`  [${a.category}] ${a.name.padEnd(20)} → ${a.command}`);
+    });
+    console.log();
+  },
+  
+  add(args) {
+    const [name, command, category = 'misc'] = args;
+    
+    if (!name || !command) {
+      console.error('Usage: alias-manager add <name> <command> [category]');
+      console.error('Categories:', CATEGORIES.join(', '));
+      process.exit(1);
+    }
+    
+    if (!CATEGORIES.includes(category)) {
+      console.error(`Invalid category. Choose from: ${CATEGORIES.join(', ')}`);
+      process.exit(1);
+    }
+    
+    // Check if alias already exists
+    const existing = loadAllAliases().find(a => a.name === name);
+    if (existing) {
+      console.error(`Alias "${name}" already exists in category "${existing.category}"`);
+      process.exit(1);
+    }
+    
+    saveAlias(name, command, category);
+    ensureShellConfig();
+    
+    console.log(`✅ Added alias: ${name} → ${command} [${category}]`);
+    console.log(`\nRun: source ${getShellConfig()}`);
+  },
+  
+  remove(args) {
+    const name = args[0];
+    if (!name) {
+      console.error('Usage: alias-manager remove <name>');
+      process.exit(1);
+    }
+    
+    const aliases = loadAllAliases();
+    const alias = aliases.find(a => a.name === name);
+    
+    if (!alias) {
+      console.error(`Alias "${name}" not found`);
+      process.exit(1);
+    }
+    
+    removeAlias(name, alias.category);
+    console.log(`✅ Removed alias: ${name} [${alias.category}]`);
+    console.log(`\nRun: source ${getShellConfig()}`);
+  },
+  
+  categories() {
+    console.log('\n📁 Available categories:\n');
+    CATEGORIES.forEach(cat => {
+      const count = loadCategory(cat).length;
+      console.log(`  ${cat.padEnd(15)} (${count} aliases)`);
+    });
+    console.log();
+  },
+  
+  export(args) {
+    const outputFile = args[0] || 'aliases-backup.json';
+    const aliases = loadAllAliases();
+    fs.writeFileSync(outputFile, JSON.stringify(aliases, null, 2));
+    console.log(`✅ Exported ${aliases.length} aliases to ${outputFile}`);
+  },
+  
+  import(args) {
+    const inputFile = args[0];
+    if (!inputFile || !fs.existsSync(inputFile)) {
+      console.error('Usage: alias-manager import <file.json>');
+      process.exit(1);
+    }
+    
+    const aliases = JSON.parse(fs.readFileSync(inputFile, 'utf8'));
+    let count = 0;
+    
+    aliases.forEach(a => {
+      const existing = loadAllAliases().find(e => e.name === a.name);
+      if (!existing) {
+        saveAlias(a.name, a.command, a.category);
+        count++;
+      }
+    });
+    
+    ensureShellConfig();
+    console.log(`✅ Imported ${count} aliases`);
+    console.log(`\nRun: source ${getShellConfig()}`);
+  },
+  
+  help() {
+    console.log(`
+📦 Alias Manager
+
+Usage:
+  alias-manager <command> [args]
+
+Commands:
+  list [category]           List all aliases (or by category)
+  find <keyword>            Search aliases
+  add <name> <cmd> [cat]    Add new alias
+  remove <name>             Remove alias
+  categories                Show all categories
+  export [file]             Export aliases to JSON
+  import <file>             Import aliases from JSON
+  help                      Show this help
+
+Categories: ${CATEGORIES.join(', ')}
+
+Examples:
+  alias-manager list
+  alias-manager list git
+  alias-manager find push
+  alias-manager add gp "git push" git
+  alias-manager remove gp
+  alias-manager export backup.json
+    `);
+  }
+};
+
+// Main
+const [,, command, ...args] = process.argv;
+
+if (!command || !commands[command]) {
+  commands.help();
+  process.exit(command ? 1 : 0);
+}
+
+commands[command](args);

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@tnqai/alim",
+  "version": "1.0.0",
+  "description": "A simple and elegant alias manager for your shell",
+  "main": "alias-manager.js",
+  "bin": {
+    "alm": "./alias-manager.js"
+  },
+  "keywords": [
+    "alias",
+    "shell",
+    "bash",
+    "zsh",
+    "cli",
+    "terminal",
+    "productivity"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=12.0.0"
+  }
+}