claudient 0.3.0 → 0.5.0

package/README.md

@@ -2,6 +2,8 @@
 
 > The definitive knowledge system for Claude Code — skills, agents, hooks, rules, workflows, and prompts that multiply what you can build.
 
+![Claudient](web/public/social-preview.svg)
+
 [![npm](https://img.shields.io/npm/v/claudient)](https://www.npmjs.com/package/claudient)
 [![License: MIT](https://img.shields.io/badge/License-MIT-black.svg)](LICENSE)
 [![Languages](https://img.shields.io/badge/languages-EN%20%7C%20FR%20%7C%20DE%20%7C%20NL%20%7C%20ES-orange)](#translations)

package/index.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.3.0",
-  "generated": "2026-05-16T17:05:17.016Z",
+  "version": "0.5.0",
+  "generated": "2026-05-16T17:33:40.657Z",
   "skills": [
     {
       "id": "backend/dotnet/csharp",
@@ -72,6 +72,34 @@
       "title": "Go Skill",
       "file": "skills/backend/go/nl/go.md"
     },
+    {
+      "id": "backend/java/spring-boot",
+      "category": "backend",
+      "lang": "de",
+      "title": "Spring Boot Skill",
+      "file": "skills/backend/java/de/spring-boot.md"
+    },
+    {
+      "id": "backend/java/spring-boot",
+      "category": "backend",
+      "lang": "es",
+      "title": "Skill Spring Boot",
+      "file": "skills/backend/java/es/spring-boot.md"
+    },
+    {
+      "id": "backend/java/spring-boot",
+      "category": "backend",
+      "lang": "fr",
+      "title": "Skill Spring Boot",
+      "file": "skills/backend/java/fr/spring-boot.md"
+    },
+    {
+      "id": "backend/java/spring-boot",
+      "category": "backend",
+      "lang": "nl",
+      "title": "Spring Boot Skill",
+      "file": "skills/backend/java/nl/spring-boot.md"
+    },
     {
       "id": "backend/java/spring-boot",
       "category": "backend",
@@ -610,6 +638,34 @@
       "lang": "en",
       "title": "Caveman Mode Skill",
       "file": "skills/productivity/caveman.md"
+    },
+    {
+      "id": "productivity/caveman",
+      "category": "productivity",
+      "lang": "de",
+      "title": "Caveman Mode Skill",
+      "file": "skills/productivity/de/caveman.md"
+    },
+    {
+      "id": "productivity/caveman",
+      "category": "productivity",
+      "lang": "es",
+      "title": "Skill Modo Caveman",
+      "file": "skills/productivity/es/caveman.md"
+    },
+    {
+      "id": "productivity/caveman",
+      "category": "productivity",
+      "lang": "fr",
+      "title": "Skill Mode Caveman",
+      "file": "skills/productivity/fr/caveman.md"
+    },
+    {
+      "id": "productivity/caveman",
+      "category": "productivity",
+      "lang": "nl",
+      "title": "Caveman Mode Skill",
+      "file": "skills/productivity/nl/caveman.md"
     }
   ],
   "agents": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudient",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "The definitive Claude Code knowledge system — skills, agents, hooks, rules, and workflows.",
   "keywords": [
     "claude-code",

package/scripts/cli.js

@@ -19,6 +19,7 @@ const SKILL_CATEGORIES = [
   'database',
   'finance-payments',
   'ai-engineering',
+  'productivity',
 ]
 
 const SUPPORTED_LANGS = ['en', 'fr', 'de', 'nl', 'es']
@@ -28,9 +29,10 @@ function usage() {
 claudient — Claude Code knowledge system
 
 Usage:
+  npx claudient init                          Interactive first-run setup
   npx claudient add skills [category] [--lang <lang>]
   npx claudient add agents
-  npx claudient add rules
+  npx claudient add rules [--write]
   npx claudient add hooks
   npx claudient add all [--lang <lang>]
   npx claudient remove skills [category]
@@ -334,8 +336,100 @@ function updateCommand() {
   }
 }
 
+function loadIndex() {
+  // Try index.json next to package.json first (installed package),
+  // then fall back to filesystem scan (dev/repo context)
+  const indexPath = path.join(REPO_ROOT, 'index.json')
+  if (fs.existsSync(indexPath)) {
+    try { return JSON.parse(fs.readFileSync(indexPath, 'utf-8')) } catch {}
+  }
+  return null
+}
+
 function listCommand(type) {
-  const listSkills = () => {
+  const index = loadIndex()
+
+  if (index) {
+    // Fast path: use pre-built index.json
+    const enOnly = (arr) => arr.filter(i => !i.lang || i.lang === 'en')
+
+    const listSkills = () => {
+      const byCategory = {}
+      for (const s of enOnly(index.skills)) {
+        if (!byCategory[s.category]) byCategory[s.category] = []
+        byCategory[s.category].push(s)
+      }
+      console.log('Skills:\n')
+      for (const [cat, items] of Object.entries(byCategory)) {
+        console.log(`  ${cat}/ (${items.length})`)
+        for (const s of items) console.log(`    ${s.id.split('/').slice(1).join('/')}.md`)
+      }
+      console.log(`\n  Total: ${enOnly(index.skills).length} skills in ${Object.keys(byCategory).length} categories`)
+    }
+
+    const listAgents = () => {
+      const agents = enOnly(index.agents)
+      const byCategory = {}
+      for (const a of agents) {
+        const cat = a.id.split('/')[0]
+        if (!byCategory[cat]) byCategory[cat] = []
+        byCategory[cat].push(a)
+      }
+      console.log('Agents:\n')
+      for (const [cat, items] of Object.entries(byCategory)) {
+        console.log(`  ${cat}/ (${items.length})`)
+        for (const a of items) console.log(`    ${a.title}`)
+      }
+    }
+
+    const listHooks = () => {
+      const byCategory = {}
+      for (const h of index.hooks) {
+        if (!byCategory[h.category]) byCategory[h.category] = []
+        byCategory[h.category].push(h)
+      }
+      console.log('Hooks:\n')
+      for (const [cat, items] of Object.entries(byCategory)) {
+        console.log(`  ${cat}/ (${items.length})`)
+        for (const h of items) console.log(`    ${h.id.split('/')[1]}.sh`)
+      }
+    }
+
+    const listRules = () => {
+      const rules = enOnly(index.rules)
+      const byCategory = {}
+      for (const r of rules) {
+        if (!byCategory[r.category]) byCategory[r.category] = []
+        byCategory[r.category].push(r)
+      }
+      console.log('Rules:\n')
+      for (const [cat, items] of Object.entries(byCategory)) {
+        console.log(`  ${cat}/ (${items.length})`)
+        for (const r of items) console.log(`    ${r.slug}.md`)
+      }
+    }
+
+    const listAll = () => {
+      listSkills(); console.log()
+      listAgents(); console.log()
+      listRules(); console.log()
+      listHooks(); console.log()
+      console.log(`Generated: ${index.generated}`)
+      console.log(`Version:   claudient@${index.version}`)
+    }
+
+    switch (type) {
+      case 'agents': listAgents(); break
+      case 'hooks': listHooks(); break
+      case 'rules': listRules(); break
+      case 'skills': listSkills(); break
+      default: if (!type) listAll(); else listSkills()
+    }
+    return
+  }
+
+  // Fallback: filesystem scan (repo dev context without index.json)
+  const listSkillsFs = () => {
     console.log('Skills:\n')
     for (const cat of SKILL_CATEGORIES) {
       const catDir = path.join(REPO_ROOT, 'skills', cat)
@@ -346,51 +440,144 @@ function listCommand(type) {
     }
   }
 
-  const listAgents = () => {
-    console.log('Agents:\n')
-    const agentsDir = path.join(REPO_ROOT, 'agents')
-    for (const cat of fs.readdirSync(agentsDir, { withFileTypes: true })) {
-      if (!cat.isDirectory() || SUPPORTED_LANGS.includes(cat.name)) continue
-      const files = getFiles(path.join(agentsDir, cat.name)).filter(f => !SUPPORTED_LANGS.some(l => f.includes(`/${l}/`)))
-      console.log(`  ${cat.name}/ (${files.length})`)
-      for (const f of files) console.log(`    ${f}`)
-    }
+  switch (type) {
+    case 'agents':
+    case 'hooks':
+    case 'rules':
+      console.log('(index.json not found — run: npm run build-index)')
+      break
+    default:
+      listSkillsFs()
   }
+}
 
-  const listHooks = () => {
-    console.log('Hooks:\n')
-    const hooksDir = path.join(REPO_ROOT, 'hooks')
-    for (const cat of fs.readdirSync(hooksDir, { withFileTypes: true })) {
-      if (!cat.isDirectory()) continue
-      const files = fs.readdirSync(path.join(hooksDir, cat.name)).filter(f => f.endsWith('.sh'))
-      console.log(`  ${cat.name}/ (${files.length})`)
-      for (const f of files) console.log(`    ${f}`)
-    }
+// ── Init (interactive first-run setup) ───────────────────────────────────────
+
+async function initCommand() {
+  const readline = require('readline')
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+  const ask = (q) => new Promise(resolve => rl.question(q, resolve))
+
+  const BOLD  = '\x1b[1m'
+  const ORANGE = '\x1b[33m'
+  const GREEN = '\x1b[32m'
+  const DIM   = '\x1b[2m'
+  const RESET = '\x1b[0m'
+
+  console.log(`
+${BOLD}╔══════════════════════════════════════════════╗
+║         CLAUDIENT SETUP                     ║
+║   The Claude Code Knowledge System          ║
+╚══════════════════════════════════════════════╝${RESET}
+`)
+
+  // Check Claude Code installed
+  if (!fs.existsSync(CLAUDE_DIR)) {
+    console.error(`${ORANGE}⚠ ~/.claude not found.${RESET}`)
+    console.error(`  Claude Code must be installed first: https://claude.ai/code\n`)
+    rl.close()
+    process.exit(1)
+  }
+  console.log(`${GREEN}✓ Claude Code detected at ${CLAUDE_DIR}${RESET}\n`)
+
+  const summary = { skills: [], agents: false, hooks: false, rules: false, lang: 'en' }
+
+  // 1. Language
+  console.log(`${BOLD}Step 1/5 — Language${RESET}`)
+  console.log('  Available: en, fr, de, nl, es')
+  const langInput = (await ask('  Which language? [en] ')).trim().toLowerCase() || 'en'
+  summary.lang = SUPPORTED_LANGS.includes(langInput) ? langInput : 'en'
+  console.log(`  → ${summary.lang}\n`)
+
+  // 2. Skill categories
+  console.log(`${BOLD}Step 2/5 — Skills${RESET}`)
+  SKILL_CATEGORIES.forEach((cat, i) => console.log(`  ${i + 1}. ${cat}`))
+  console.log('  a. All categories')
+  console.log('  0. Skip skills')
+  const catInput = (await ask('  Select categories (comma-separated numbers, or a/0): ')).trim()
+
+  if (catInput === '0') {
+    console.log('  → Skipping skills\n')
+  } else if (catInput === 'a' || catInput === '') {
+    summary.skills = [...SKILL_CATEGORIES]
+    console.log(`  → All categories selected\n`)
+  } else {
+    const nums = catInput.split(',').map(n => parseInt(n.trim(), 10)).filter(n => n >= 1 && n <= SKILL_CATEGORIES.length)
+    summary.skills = nums.map(n => SKILL_CATEGORIES[n - 1])
+    console.log(`  → Selected: ${summary.skills.join(', ')}\n`)
   }
 
-  const listRules = () => {
-    console.log('Rules:\n')
-    const rulesDir = path.join(REPO_ROOT, 'rules')
-    for (const cat of fs.readdirSync(rulesDir, { withFileTypes: true })) {
-      if (!cat.isDirectory() || SUPPORTED_LANGS.includes(cat.name)) continue
-      const files = fs.readdirSync(path.join(rulesDir, cat.name)).filter(f => f.endsWith('.md'))
-      console.log(`  ${cat.name}/ (${files.length})`)
-      for (const f of files) console.log(`    ${f}`)
+  // 3. Agents
+  console.log(`${BOLD}Step 3/5 — Agents${RESET}`)
+  console.log('  6 subagent definitions: Planner, Architect, Code Reviewer, Security, Build Resolvers')
+  const agentsInput = (await ask('  Install agents? [Y/n] ')).trim().toLowerCase()
+  summary.agents = agentsInput !== 'n'
+  console.log(`  → ${summary.agents ? 'Yes' : 'No'}\n`)
+
+  // 4. Hooks
+  console.log(`${BOLD}Step 4/5 — Hooks${RESET}`)
+  console.log('  7 shell scripts: safety guards, auto-formatter, audit log, cost tracker, session helpers')
+  const hooksInput = (await ask('  Install hooks? [Y/n] ')).trim().toLowerCase()
+  summary.hooks = hooksInput !== 'n'
+  console.log(`  → ${summary.hooks ? 'Yes' : 'No'}\n`)
+
+  // 5. Rules
+  console.log(`${BOLD}Step 5/5 — Rules${RESET}`)
+  console.log('  8 rule sets: coding style, git, security, testing, performance, Python, TypeScript, Go')
+  const rulesInput = (await ask('  Add rules to ./CLAUDE.md? [Y/n] ')).trim().toLowerCase()
+  summary.rules = rulesInput !== 'n'
+  console.log(`  → ${summary.rules ? 'Yes' : 'No'}\n`)
+
+  rl.close()
+
+  // Confirm
+  console.log(`${BOLD}Summary${RESET}`)
+  console.log(`  Language : ${summary.lang}`)
+  console.log(`  Skills   : ${summary.skills.length ? summary.skills.join(', ') : 'none'}`)
+  console.log(`  Agents   : ${summary.agents ? 'yes' : 'no'}`)
+  console.log(`  Hooks    : ${summary.hooks ? 'yes' : 'no'}`)
+  console.log(`  Rules    : ${summary.rules ? 'append to ./CLAUDE.md' : 'no'}`)
+  console.log()
+
+  // Execute
+  if (summary.skills.length) {
+    for (const cat of summary.skills) {
+      console.log(`Installing ${cat} skills...`)
+      addSkills(cat, summary.lang === 'en' ? null : summary.lang)
     }
+    console.log()
   }
 
-  switch (type) {
-    case 'agents': listAgents(); break
-    case 'hooks': listHooks(); break
-    case 'rules': listRules(); break
-    case 'skills':
-    default:
-      if (!type) {
-        listSkills(); console.log(); listAgents(); console.log(); listRules(); console.log(); listHooks()
-      } else {
-        listSkills()
-      }
+  if (summary.agents) {
+    console.log('Installing agents...')
+    addAgents()
+    console.log()
   }
+
+  if (summary.hooks) {
+    console.log('Installing hooks...')
+    addHooks()
+    console.log()
+  }
+
+  if (summary.rules) {
+    console.log('Adding rules to ./CLAUDE.md...')
+    addRulesWrite()
+    console.log()
+  }
+
+  console.log(`${GREEN}${BOLD}✓ Claudient setup complete!${RESET}`)
+  console.log()
+  console.log('Next steps:')
+  if (summary.hooks) {
+    console.log(`  1. Add hook entries to .claude/settings.json`)
+    console.log(`     See: https://github.com/Claudient/Claudient/tree/main/hooks`)
+  }
+  console.log(`  2. Restart Claude Code to activate all installed content`)
+  console.log(`  3. Try a skill — type /fastapi or /kubernetes in Claude Code`)
+  console.log()
+  console.log(`  Full docs: https://github.com/Claudient/Claudient`)
 }
 
 function getFiles(dir, prefix = '') {
@@ -460,6 +647,9 @@ switch (command) {
   case 'list':
     listCommand(positional[0])
     break
+  case 'init':
+    initCommand().catch(err => { console.error(err); process.exit(1) })
+    break
   case 'help':
   case '--help':
   case '-h':