agent-cli-kit 1.0.0

package/README.md

@@ -0,0 +1,80 @@
+# agent-cli-kit
+
+A starter kit for AI agents building CLI tools. Handles config, logging, API calls, and auth.
+
+## Install
+
+```bash
+npm install agent-cli-kit
+```
+
+## Quick Start
+
+```javascript
+const { AgentCLI } = require('agent-cli-kit');
+const { program } = require('commander');
+
+// Create your agent
+const agent = new AgentCLI('my-agent', '1.0.0');
+
+// Add commands
+program
+  .command('action <target>')
+  .action((target) => {
+    agent.log.success(`Action on ${target}`);
+  });
+
+program.parse(process.argv);
+```
+
+## Features
+
+✅ Config management (auto-saved to ~/.agent-config/)
+✅ Logging helpers (success, error, warn, info)
+✅ API call wrapper with timeout
+✅ Commander.js pre-integrated
+✅ Zero additional setup needed
+
+## Built-in Methods
+
+### Logging
+- `agent.log.success(msg)` — ✅ messages
+- `agent.log.error(msg)` — ❌ errors
+- `agent.log.warn(msg)` — ⚠️ warnings
+- `agent.log.info(msg)` — ℹ️ info
+- `agent.log.section(title)` — 📍 section header
+- `agent.log.json(obj)` — Pretty-print JSON
+
+### Config
+- `agent.get(key)` — Get config value
+- `agent.set(key, value)` — Save config value
+
+### API
+- `await agent.api(url, options)` — Fetch with timeout + error handling
+
+## Example: Weather Agent
+
+```javascript
+const { AgentCLI } = require('agent-cli-kit');
+const { program } = require('commander');
+
+const agent = new AgentCLI('weather-agent', '1.0.0');
+
+program
+  .command('weather <city>')
+  .action(async (city) => {
+    try {
+      const data = await agent.api(`https://api.example.com/weather?city=${city}`);
+      agent.log.section(`Weather in ${city}`);
+      agent.log.info(`Temperature: ${data.temp}°C`);
+    } catch (err) {
+      agent.log.error(`Could not fetch weather`);
+    }
+  });
+
+program.parse(process.argv);
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+const { AgentCLI } = require('../lib/index.js');
+const { program } = require('commander');
+
+// Initialize your agent CLI
+const agent = new AgentCLI('my-agent', '1.0.0');
+
+program
+  .name(agent.name)
+  .version(agent.version)
+  .description('Your AI agent CLI');
+
+// Example: config command
+program
+  .command('config')
+  .description('Manage configuration')
+  .action(() => {
+    agent.log.section('Configuration');
+    agent.log.json(agent.config);
+  });
+
+// Example: set API key
+program
+  .command('auth <key>')
+  .description('Set API key')
+  .action((key) => {
+    agent.set('api_key', key);
+    agent.log.success('API key saved');
+  });
+
+// Example: status command
+program
+  .command('status')
+  .description('Check agent status')
+  .action(() => {
+    agent.log.section('Agent Status');
+    agent.log.info(`Name: ${agent.name}`);
+    agent.log.info(`Version: ${agent.version}`);
+    agent.log.info(`Configured: ${Object.keys(agent.config).length > 0 ? 'Yes' : 'No'}`);
+  });
+
+program.parse(process.argv);

package/lib/index.js

@@ -0,0 +1,78 @@
+// Agent CLI Framework - Core Library
+
+const chalk = require('chalk');
+const fs = require('fs-extra');
+const path = require('path');
+
+class AgentCLI {
+  constructor(name, version) {
+    this.name = name;
+    this.version = version;
+    this.config = {};
+    this.loadConfig();
+  }
+
+  // Load config from ~/.agent-config/[name].json
+  loadConfig() {
+    const configDir = path.join(process.env.HOME || '/tmp', '.agent-config');
+    const configFile = path.join(configDir, `${this.name}.json`);
+    
+    if (fs.existsSync(configFile)) {
+      this.config = fs.readJsonSync(configFile);
+    }
+  }
+
+  // Save config
+  saveConfig() {
+    const configDir = path.join(process.env.HOME || '/tmp', '.agent-config');
+    const configFile = path.join(configDir, `${this.name}.json`);
+    
+    fs.ensureDirSync(configDir);
+    fs.writeJsonSync(configFile, this.config, { spaces: 2 });
+  }
+
+  // Logger helper
+  log = {
+    success: (msg) => console.log(chalk.green(`✅ ${msg}`)),
+    error: (msg) => console.error(chalk.red(`❌ ${msg}`)),
+    warn: (msg) => console.warn(chalk.yellow(`⚠️  ${msg}`)),
+    info: (msg) => console.log(chalk.blue(`ℹ️  ${msg}`)),
+    section: (msg) => console.log(chalk.cyan(`\n📍 ${msg}\n`)),
+    json: (obj) => console.log(JSON.stringify(obj, null, 2))
+  };
+
+  // API call helper
+  async api(url, options = {}) {
+    try {
+      const response = await fetch(url, {
+        timeout: options.timeout || 10000,
+        headers: {
+          'Content-Type': 'application/json',
+          ...options.headers
+        },
+        ...options
+      });
+      
+      if (!response.ok) {
+        throw new Error(`API Error: ${response.status}`);
+      }
+      
+      return await response.json();
+    } catch (err) {
+      this.log.error(`API call failed: ${err.message}`);
+      throw err;
+    }
+  }
+
+  // Config getter/setter
+  get(key) {
+    return this.config[key];
+  }
+
+  set(key, value) {
+    this.config[key] = value;
+    this.saveConfig();
+  }
+}
+
+module.exports = { AgentCLI };

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "agent-cli-kit",
+  "version": "1.0.0",
+  "description": "Starter kit for AI agents building CLIs. Includes auth, config, logging, API helpers.",
+  "main": "lib/index.js",
+  "bin": {
+    "agent-cli-kit": "bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo 'tests coming soon'"
+  },
+  "keywords": [
+    "agent",
+    "cli",
+    "framework",
+    "starter",
+    "template",
+    "ai"
+  ],
+  "author": "Bagalobsta <bagalobsta@protonmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bagalobsta/agent-cli-kit.git"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "dotenv": "^16.3.1",
+    "fs-extra": "^11.2.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}