agenttool 0.1.0

package/index.js

@@ -0,0 +1,299 @@
+#!/usr/bin/env node
+
+/**
+ * agenttool — CLI to search and check agent-readiness grades for software tools.
+ * Zero dependencies. Wraps the public agenttool.sh API.
+ */
+
+const API_BASE = process.env.AGENTTOOL_API || 'https://agenttool.sh/api'
+
+// ─── Helpers ───
+
+async function api(path) {
+  const url = `${API_BASE}${path}`
+  const res = await fetch(url, {
+    headers: { 'User-Agent': 'agenttool-cli/0.1.0' },
+    signal: AbortSignal.timeout(15000),
+  })
+  if (!res.ok) {
+    const body = await res.text().catch(() => '')
+    throw new Error(`API ${res.status}: ${body || res.statusText}`)
+  }
+  return res.json()
+}
+
+function gradeColor(grade) {
+  const colors = { 'A+': '\x1b[32m', 'A': '\x1b[32m', 'B+': '\x1b[33m', 'B': '\x1b[33m', 'C+': '\x1b[33m', 'C': '\x1b[37m', 'D': '\x1b[31m', 'F': '\x1b[31m' }
+  return `${colors[grade] || ''}${grade}\x1b[0m`
+}
+
+function pad(str, len) {
+  return String(str).padEnd(len)
+}
+
+function truncate(str, max) {
+  if (!str) return ''
+  return str.length > max ? str.slice(0, max - 1) + '…' : str
+}
+
+// ─── Commands ───
+
+async function cmdSearch(query) {
+  if (!query) {
+    console.error('Usage: agenttool search <query>')
+    process.exit(1)
+  }
+  const { data } = await api(`/search?q=${encodeURIComponent(query)}&limit=20`)
+  if (!data?.length) {
+    console.log('No tools found.')
+    return
+  }
+  console.log(`\n  ${pad('Tool', 28)} ${pad('Grade', 8)} ${pad('Score', 8)} Category`)
+  console.log(`  ${'─'.repeat(28)} ${'─'.repeat(7)} ${'─'.repeat(7)} ${'─'.repeat(20)}`)
+  for (const t of data) {
+    console.log(`  ${pad(truncate(t.name, 27), 28)} ${pad(gradeColor(t.agentGrade), 17)} ${pad(t.agentScore?.toFixed(1) || 'N/A', 8)} ${t.category || ''}`)
+  }
+  console.log(`\n  ${data.length} result${data.length === 1 ? '' : 's'}`)
+}
+
+async function cmdGrade(slug) {
+  if (!slug) {
+    console.error('Usage: agenttool grade <tool-slug>')
+    process.exit(1)
+  }
+  const { data } = await api(`/tools/${encodeURIComponent(slug)}`)
+  if (!data) {
+    console.log('Tool not found.')
+    return
+  }
+  const t = data
+
+  console.log(`\n  ${t.name}`)
+  console.log(`  ${t.url}`)
+  console.log(`  Grade: ${gradeColor(t.agentGrade)}  Score: ${t.agentScore?.toFixed(1)}/10`)
+  if (t.category) console.log(`  Category: ${t.category}`)
+  if (t.description) console.log(`\n  ${truncate(t.description, 100)}`)
+
+  // Scores breakdown
+  const scores = t.scores || {}
+  const labels = {
+    tokenEfficiency: 'Token Efficiency',
+    access: 'Programmatic Access',
+    auth: 'Autonomous Auth',
+    speed: 'Speed & Throughput',
+    discoverability: 'Discoverability',
+    reliability: 'Reliability',
+    safety: 'Safety',
+    reactivity: 'Reactivity',
+  }
+  const scored = Object.entries(labels).filter(([k]) => scores[k] && !scores[k].na)
+  if (scored.length) {
+    console.log(`\n  ${pad('Criterion', 24)} Score  Evidence`)
+    console.log(`  ${'─'.repeat(24)} ${'─'.repeat(5)}  ${'─'.repeat(40)}`)
+    for (const [key, label] of scored) {
+      const s = scores[key]
+      console.log(`  ${pad(label, 24)} ${pad(s.score + '/10', 6)}  ${truncate(s.evidence, 40)}`)
+    }
+  }
+
+  // Access methods
+  const am = t.accessMethods || {}
+  const methods = []
+  if (am.restApi) methods.push('REST API')
+  if (am.graphql) methods.push('GraphQL')
+  if (am.cli) methods.push('CLI')
+  if (am.mcpServer && am.mcpServer !== 'none') methods.push(`MCP (${am.mcpServer})`)
+  if (am.sdk?.length) methods.push(`SDKs: ${am.sdk.join(', ')}`)
+  if (methods.length) console.log(`\n  Access: ${methods.join(' | ')}`)
+
+  // Biggest friction
+  if (t.scannerData?.biggestFriction) {
+    console.log(`\n  Biggest friction: ${t.scannerData.biggestFriction}`)
+  }
+
+  // Links
+  const links = t.links || {}
+  const linkEntries = Object.entries(links).filter(([, v]) => v)
+  if (linkEntries.length) {
+    console.log(`\n  Links:`)
+    for (const [key, url] of linkEntries) {
+      console.log(`    ${key}: ${url}`)
+    }
+  }
+  console.log()
+}
+
+async function cmdCategories() {
+  const { data } = await api('/categories')
+  if (!data?.length) {
+    console.log('No categories found.')
+    return
+  }
+  console.log(`\n  ${pad('Category', 28)} ${pad('Tools', 8)} Avg Score`)
+  console.log(`  ${'─'.repeat(28)} ${'─'.repeat(7)} ${'─'.repeat(9)}`)
+  for (const c of data) {
+    console.log(`  ${pad(c.name, 28)} ${pad(c.toolCount, 8)} ${c.avgScore?.toFixed(1) || 'N/A'}`)
+  }
+  console.log(`\n  ${data.length} categories`)
+}
+
+async function cmdList(opts) {
+  const params = new URLSearchParams()
+  if (opts.category) params.set('category', opts.category)
+  if (opts.grade) params.set('minGrade', opts.grade)
+  if (opts.mcp) params.set('hasMcp', 'true')
+  if (opts.api) params.set('hasApi', 'true')
+  if (opts.cli) params.set('hasCli', 'true')
+  if (opts.sort) params.set('sort', opts.sort)
+  params.set('limit', String(opts.limit || 20))
+
+  const qs = params.toString()
+  const { data, meta } = await api(`/tools${qs ? '?' + qs : ''}`)
+  if (!data?.length) {
+    console.log('No tools found.')
+    return
+  }
+  console.log(`\n  ${pad('Tool', 28)} ${pad('Grade', 8)} ${pad('Score', 8)} Category`)
+  console.log(`  ${'─'.repeat(28)} ${'─'.repeat(7)} ${'─'.repeat(7)} ${'─'.repeat(20)}`)
+  for (const t of data) {
+    console.log(`  ${pad(truncate(t.name, 27), 28)} ${pad(gradeColor(t.agentGrade), 17)} ${pad(t.agentScore?.toFixed(1) || 'N/A', 8)} ${t.category || ''}`)
+  }
+  console.log(`\n  Showing ${data.length} of ${meta?.total || '?'} tools`)
+}
+
+async function cmdSubmit(url, name) {
+  if (!url) {
+    console.error('Usage: agenttool submit <url> [--name <name>]')
+    process.exit(1)
+  }
+  const body = { url }
+  if (name) body.name = name
+
+  const res = await fetch(`${API_BASE}/tools/submit`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', 'User-Agent': 'agenttool-cli/0.1.0' },
+    body: JSON.stringify(body),
+    signal: AbortSignal.timeout(15000),
+  })
+  const json = await res.json()
+  if (!res.ok) {
+    console.error(`Error: ${json.error || json.message || res.statusText}`)
+    process.exit(1)
+  }
+  const d = json.data
+  if (d.status === 'already_exists') {
+    console.log(`\n  Already graded: ${d.slug} (${gradeColor(d.agentGrade)})`)
+    console.log(`  View: https://agenttool.sh/tools/${d.slug}`)
+  } else {
+    console.log(`\n  Submitted: ${d.slug}`)
+    console.log(`  ${d.message}`)
+  }
+  console.log()
+}
+
+// ─── Arg Parsing ───
+
+function parseArgs(argv) {
+  const args = argv.slice(2)
+  const command = args[0]
+  const positional = []
+  const flags = {}
+
+  for (let i = 1; i < args.length; i++) {
+    if (args[i].startsWith('--')) {
+      const key = args[i].slice(2)
+      // Boolean flags
+      if (['mcp', 'api', 'cli'].includes(key)) {
+        flags[key] = true
+      } else {
+        flags[key] = args[++i]
+      }
+    } else {
+      positional.push(args[i])
+    }
+  }
+
+  return { command, positional, flags }
+}
+
+function printHelp() {
+  console.log(`
+  agenttool — Check agent-readiness grades for software tools
+
+  Usage:
+    agenttool search <query>           Search tools by name or category
+    agenttool grade <slug>             Get full grade breakdown for a tool
+    agenttool list [options]           Browse graded tools
+    agenttool categories               List all categories
+    agenttool submit <url> [--name X]  Submit a tool for scanning
+
+  List options:
+    --category <name>     Filter by category
+    --grade <min>         Minimum grade (A+, A, B+, B, C+, C, D, F)
+    --sort <field>        Sort by: score (default), name, recent
+    --limit <n>           Max results (default: 20)
+    --mcp                 Only tools with MCP servers
+    --api                 Only tools with APIs
+    --cli                 Only tools with CLIs
+
+  Environment:
+    AGENTTOOL_API         API base URL (default: https://agenttool.sh/api)
+
+  Examples:
+    agenttool search stripe
+    agenttool grade stripe
+    agenttool list --category Payments --grade B
+    agenttool list --mcp --sort score
+    agenttool submit https://linear.app --name Linear
+`)
+}
+
+// ─── Main ───
+
+async function main() {
+  const { command, positional, flags } = parseArgs(process.argv)
+
+  if (!command || command === 'help' || flags.help) {
+    printHelp()
+    return
+  }
+
+  try {
+    switch (command) {
+      case 'search':
+        await cmdSearch(positional.join(' '))
+        break
+      case 'grade':
+        await cmdGrade(positional[0])
+        break
+      case 'list':
+      case 'ls':
+        await cmdList({
+          category: flags.category,
+          grade: flags.grade,
+          sort: flags.sort,
+          limit: flags.limit ? Number(flags.limit) : 20,
+          mcp: flags.mcp,
+          api: flags.api,
+          cli: flags.cli,
+        })
+        break
+      case 'categories':
+      case 'cats':
+        await cmdCategories()
+        break
+      case 'submit':
+        await cmdSubmit(positional[0], flags.name)
+        break
+      default:
+        console.error(`Unknown command: ${command}`)
+        printHelp()
+        process.exit(1)
+    }
+  } catch (err) {
+    console.error(`Error: ${err.message}`)
+    process.exit(1)
+  }
+}
+
+main()

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "agenttool",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "CLI to search and check agent-readiness grades for software tools",
+  "bin": {
+    "agenttool": "index.js"
+  },
+  "keywords": ["ai-agents", "tool-directory", "agent-readiness", "cli"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/romainsimon/agenttool.sh"
+  },
+  "files": ["index.js", "lib/"]
+}