slashdev 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Slashdev
+
+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,56 @@
+# Slashdev CLI
+
+Skills & workflows for AI agents in the Slashdev ecosystem.
+
+```
+    _____ __           __        __
+   / ___// /___ ______/ /_  ____/ /__ _   __
+   \__ \/ / __ `/ ___/ __ \/ __  / _ \ | / /
+  ___/ / / /_/ (__  ) / / / /_/ /  __/ |/ /
+ /____/_/\__,_/____/_/ /_/\__,_/\___/|___/
+```
+
+## Installation
+
+```bash
+npm install -g slashdev
+```
+
+## Usage
+
+```bash
+# Show banner and info
+slashdev
+
+# Display help
+slashdev --help
+
+# Show version
+slashdev --version
+```
+
+## What is Slashdev?
+
+Slashdev is a collection of skills and workflows designed for AI agents. It provides:
+
+- **Agent Skills** — Reusable capabilities for AI agents
+- **Workflows** — Orchestrated sequences of agent actions
+- **MCP Integrations** — Connect with Model Context Protocol servers
+- **Team Tools** — Collaboration utilities for agent teams
+
+## Roadmap
+
+- [x] v0.1.0 — Initial CLI with banner display
+- [ ] v0.2.0 — `slashdev init` for project scaffolding
+- [ ] v0.3.0 — Skill management commands
+- [ ] v0.4.0 — Workflow definitions
+- [ ] v0.5.0 — MCP server integration
+- [ ] v1.0.0 — Stable API release
+
+## Requirements
+
+- Node.js >= 18.0.0
+
+## License
+
+MIT

package/bin/slashdev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { run } from '../src/cli.js';
+
+run(process.argv.slice(2));

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "slashdev",
+  "version": "0.1.0",
+  "description": "Skills & workflows for AI agents in the Slashdev ecosystem",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "slashdev": "./bin/slashdev.js"
+  },
+  "scripts": {
+    "start": "node bin/slashdev.js",
+    "test": "node bin/slashdev.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "cli",
+    "ai",
+    "agents",
+    "skills",
+    "workflows",
+    "slashdev",
+    "mcp",
+    "claude"
+  ],
+  "author": "Slashdev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/slashdev/cli.git"
+  },
+  "homepage": "https://slashdev.io",
+  "bugs": {
+    "url": "https://github.com/slashdev/cli/issues"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "figlet": "^1.7.0"
+  }
+}

package/src/banner.js

@@ -0,0 +1,74 @@
+import chalk from 'chalk';
+
+// Primary brand color
+const BRAND_BLUE = '#215ff6';
+
+// Blue gradient palette based on brand color
+const blue = {
+  brand: chalk.hex(BRAND_BLUE).bold,
+  bright: chalk.hex('#4d7fff').bold,
+  light: chalk.hex('#7a9fff'),
+  soft: chalk.hex('#a6bfff'),
+  pale: chalk.hex('#d3dfff'),
+  dark: chalk.hex('#1a4cc7').bold,
+};
+
+export { blue, BRAND_BLUE };
+
+// Clean block text
+const SLASHDEV_TEXT = [
+  '   ███████╗██╗      █████╗ ███████╗██╗  ██╗██████╗ ███████╗██╗   ██╗',
+  '   ██╔════╝██║     ██╔══██╗██╔════╝██║  ██║██╔══██╗██╔════╝██║   ██║',
+  '   ███████╗██║     ███████║███████╗███████║██║  ██║█████╗  ██║   ██║',
+  '   ╚════██║██║     ██╔══██║╚════██║██╔══██║██║  ██║██╔══╝  ╚██╗ ██╔╝',
+  '   ███████║███████╗██║  ██║███████║██║  ██║██████╔╝███████╗ ╚████╔╝ ',
+  '   ╚══════╝╚══════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═════╝ ╚══════╝  ╚═══╝  ',
+];
+
+const AGENT_SWARM_TEXT = [
+  '            █████╗  ██████╗ ███████╗███╗   ██╗████████╗',
+  '           ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝',
+  '           ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   ',
+  '           ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   ',
+  '           ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   ',
+  '           ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ',
+  '',
+  '          ███████╗██╗    ██╗ █████╗ ██████╗ ███╗   ███╗',
+  '          ██╔════╝██║    ██║██╔══██╗██╔══██╗████╗ ████║',
+  '          ███████╗██║ █╗ ██║███████║██████╔╝██╔████╔██║',
+  '          ╚════██║██║███╗██║██╔══██║██╔══██╗██║╚██╔╝██║',
+  '          ███████║╚███╔███╔╝██║  ██║██║  ██║██║ ╚═╝ ██║',
+  '          ╚══════╝ ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝',
+];
+
+const textGradient = [
+  '#1a4cc7',  // Dark blue
+  '#1e54d9',
+  '#215ff6',  // Brand blue
+  '#215ff6',  // Brand blue
+  '#4d7fff',  // Bright
+  '#7a9fff',  // Light
+];
+
+export function displayBanner() {
+  console.log();
+
+  // Display SLASHDEV text with gradient
+  SLASHDEV_TEXT.forEach((line, i) => {
+    const colorIndex = i % textGradient.length;
+    console.log(chalk.hex(textGradient[colorIndex]).bold(line));
+  });
+
+  console.log();
+
+  // Display AGENT SWARM in lighter blue
+  AGENT_SWARM_TEXT.forEach(line => {
+    console.log(chalk.hex('#4d7fff')(line));
+  });
+
+  // Tagline separator
+  console.log();
+  console.log(chalk.hex('#4d7fff')('                    ╔══════════════════════════════════╗'));
+  console.log(chalk.hex(BRAND_BLUE).bold('                    ║       ╱╱  slashdev.io  ╱╱         ║'));
+  console.log(chalk.hex('#4d7fff')('                    ╚══════════════════════════════════╝'));
+}

package/src/cli.js

@@ -0,0 +1,23 @@
+import { displayBanner } from './banner.js';
+import { displayInfo, displayVersion, displayHelp } from './info.js';
+
+export async function run(args) {
+  const flags = new Set(args);
+
+  // Handle --version / -v
+  if (flags.has('--version') || flags.has('-v')) {
+    displayVersion();
+    return;
+  }
+
+  // Handle --help / -h
+  if (flags.has('--help') || flags.has('-h')) {
+    await displayBanner();
+    displayHelp();
+    return;
+  }
+
+  // Default: show banner + info
+  await displayBanner();
+  displayInfo();
+}

package/src/index.js

@@ -0,0 +1,6 @@
+// Slashdev CLI - Main Export
+// Skills & workflows for AI agents in the Slashdev ecosystem
+
+export { run } from './cli.js';
+export { displayBanner, generateBanner, colorize } from './banner.js';
+export { getPackageInfo, displayInfo, displayVersion, displayHelp } from './info.js';

package/src/info.js

@@ -0,0 +1,94 @@
+import chalk from 'chalk';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Primary brand color
+const BRAND_BLUE = '#215ff6';
+
+// Blue color palette based on brand
+const blue = {
+  brand: chalk.hex(BRAND_BLUE),
+  bright: chalk.hex('#4d7fff'),
+  light: chalk.hex('#7a9fff'),
+  soft: chalk.hex('#a6bfff'),
+  pale: chalk.hex('#d3dfff'),
+  dark: chalk.hex('#1a4cc7'),
+};
+
+export function getPackageInfo() {
+  const packagePath = join(__dirname, '..', 'package.json');
+  const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
+  return {
+    name: packageJson.name,
+    version: packageJson.version,
+    description: packageJson.description,
+  };
+}
+
+export function displayInfo() {
+  const pkg = getPackageInfo();
+  const dim = chalk.dim;
+
+  console.log();
+  console.log(`  ${blue.brand.bold(pkg.name)} ${dim('v' + pkg.version)}`);
+  console.log();
+
+  // Main value proposition
+  console.log(`  ${blue.light('Organize your agent skills. Improve your workflows.')}`);
+  console.log(`  ${blue.light('Add QA processes. Build on the best practices of')}`);
+  console.log(`  ${blue.light('the Slashdev engineering team.')}`);
+  console.log();
+
+  console.log(`  ${blue.brand.bold('What we do')}`);
+  console.log(`  ${blue.dark('────────────────────────────────────────────────────────')}`);
+  console.log(`    ${blue.bright('◈')} ${blue.soft('Skill Organization')}    ${dim('Structure and manage agent capabilities')}`);
+  console.log(`    ${blue.bright('◈')} ${blue.soft('Workflow Automation')}   ${dim('Streamline tasks with smart workflows')}`);
+  console.log(`    ${blue.bright('◈')} ${blue.soft('QA Processes')}          ${dim('Built-in quality assurance for outputs')}`);
+  console.log(`    ${blue.bright('◈')} ${blue.soft('Best Practices')}        ${dim('The Slashdev engineering playbook')}`);
+  console.log();
+
+  console.log(`  ${blue.brand.bold('Commands')}`);
+  console.log(`  ${blue.dark('────────────────────────────────────────────────────────')}`);
+  console.log(`    ${blue.bright('slashdev')}              ${dim('Show this banner')}`);
+  console.log(`    ${blue.bright('slashdev --help')}       ${dim('Display help information')}`);
+  console.log(`    ${blue.bright('slashdev --version')}    ${dim('Show version number')}`);
+  console.log();
+
+  console.log(`  ${blue.brand.bold('Coming Soon')}`);
+  console.log(`  ${blue.dark('────────────────────────────────────────────────────────')}`);
+  console.log(`    ${blue.bright('▸')} Agent skills & workflow library`);
+  console.log(`    ${blue.bright('▸')} MCP server integrations`);
+  console.log(`    ${blue.bright('▸')} Team collaboration tools`);
+  console.log(`    ${blue.bright('▸')} Slashdev skill marketplace`);
+  console.log();
+
+  console.log(`  ${dim('Learn more at')} ${blue.brand.underline('https://slashdev.io')}`);
+  console.log();
+}
+
+export function displayVersion() {
+  const pkg = getPackageInfo();
+  console.log(`${blue.brand(pkg.name)} ${chalk.dim('v' + pkg.version)}`);
+}
+
+export function displayHelp() {
+  const dim = chalk.dim;
+
+  console.log();
+  console.log(`  ${blue.brand.bold('Usage')} ${dim('slashdev [command] [options]')}`);
+  console.log();
+  console.log(`  ${blue.brand.bold('Options')}`);
+  console.log(`  ${blue.dark('──────────────────────────────')}`);
+  console.log(`    ${blue.bright('-h, --help')}       ${dim('Display this help message')}`);
+  console.log(`    ${blue.bright('-v, --version')}    ${dim('Display version number')}`);
+  console.log();
+  console.log(`  ${blue.brand.bold('Examples')}`);
+  console.log(`  ${blue.dark('──────────────────────────────')}`);
+  console.log(`    ${dim('$')} slashdev              ${dim('# Show banner and info')}`);
+  console.log(`    ${dim('$')} slashdev --version    ${dim('# Print version')}`);
+  console.log();
+}