@axiomatic-labs/cli 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,47 @@
+# Axiomatic
+
+**Ship production apps with Claude Code — not prototypes.**
+
+Axiomatic is a development toolkit that turns Claude Code into a senior engineering team. It installs skills, agents, hooks, and quality gates that enforce real-world standards on every task.
+
+## What you get
+
+- **11 specialized skills** — Build pipeline, design system, brand strategy, competitive analysis, CRO, content strategy, and more. Each skill encodes expert-level methodology that Claude follows step by step.
+- **11 AI agents** — Dedicated agents for design, architecture, code review, and implementation. They work in parallel, each with domain expertise.
+- **21 automation hooks** — Quality gates, linting, build tracking, browser testing, and dev server management. They fire automatically — no manual checks needed.
+- **One command to build anything** — Type `/build` and describe what you want. Axiomatic plans the architecture, selects the right skills, creates tasks, and executes them with built-in quality checks at every step.
+
+## Quick start
+
+```bash
+npx @axiomatic-labs/cli init
+claude
+# then type: /build <what you want to create>
+```
+
+## Commands
+
+```bash
+axiomatic init       # Install Axiomatic in your project
+axiomatic update     # Update to the latest version
+axiomatic version    # Check installed and latest versions
+```
+
+## How it works
+
+1. `axiomatic init` downloads the latest template files into your project
+2. You run `claude` to start Claude Code — Axiomatic's skills and agents activate automatically
+3. Type `/build` with a description — Axiomatic analyzes your request, selects skills, creates an execution plan, and builds it with quality gates enforced at every step
+
+Updates are non-destructive. `axiomatic update` replaces only template files — your generated skills, custom agents, and project-specific configurations stay untouched.
+
+## Requirements
+
+- [Claude Code](https://claude.ai/claude-code) (Anthropic CLI)
+- [GitHub CLI](https://cli.github.com/) (`gh`) or a `GITHUB_TOKEN` with repo access
+- Node.js 18+
+
+## Links
+
+- [Website](https://axiomatic.dev)
+- [GitHub](https://github.com/axiomatic-labs/axiomatic-cli)

package/bin/cli.js

@@ -18,20 +18,20 @@ switch (command) {
     break;
   case '--help':
   case '-h':
-  case undefined:
-    console.log(`
-  axiomatic - Install and update Axiomatic project templates
-
-  Usage:
-    axiomatic init      Download and install the latest template files
-    axiomatic update    Update template files to the latest version
-    axiomatic version   Show local and latest version info
-
-  Options:
-    --version, -v       Show CLI version
-    --help, -h          Show this help message
-`);
+  case undefined: {
+    const ui = require('../lib/ui.js');
+    ui.banner();
+    console.log(`  ${ui.BOLD}Usage:${ui.RESET}`);
+    console.log(`    axiomatic ${ui.CYAN}init${ui.RESET}      Install the latest template files`);
+    console.log(`    axiomatic ${ui.CYAN}update${ui.RESET}    Update templates to latest version`);
+    console.log(`    axiomatic ${ui.CYAN}version${ui.RESET}   Show version info`);
+    console.log('');
+    console.log(`  ${ui.BOLD}Options:${ui.RESET}`);
+    console.log(`    --version, -v   Show CLI version`);
+    console.log(`    --help, -h      Show this help`);
+    console.log('');
     break;
+  }
   default:
     console.error(`Unknown command: ${command}`);
     console.error('Run "axiomatic --help" for usage.');

package/lib/init.js

@@ -4,31 +4,38 @@ const { execSync } = require('child_process');
 const { requireAuth } = require('./auth.js');
 const { getLatestRelease, downloadReleaseAsset } = require('./download.js');
 const { writeLocalVersion } = require('./version.js');
+const { TEMPLATE_SKILLS, TEMPLATE_AGENTS } = require('./manifest.js');
+const ui = require('./ui.js');
 
 async function run() {
   // Check if already initialized
   const versionFile = path.join(process.cwd(), '.claude', '.axiomatic-version');
   if (fs.existsSync(versionFile)) {
     const current = fs.readFileSync(versionFile, 'utf-8').trim();
-    console.error(`Already initialized at ${current}. Use "axiomatic update" instead.`);
+    ui.banner(current);
+    ui.warn(`Already initialized at ${current}.`);
+    ui.info('Run: axiomatic update');
+    console.log('');
     process.exit(1);
   }
 
-  console.log('Authenticating with GitHub...');
+  ui.banner();
+
+  ui.step('Authenticating with GitHub...');
   const token = requireAuth();
 
-  console.log('Fetching latest release...');
+  ui.step('Fetching latest release...');
   const release = await getLatestRelease(token);
   const version = release.tag_name;
 
   // Find the ZIP asset
   const asset = release.assets.find((a) => a.name.endsWith('.zip'));
   if (!asset) {
-    console.error('No ZIP asset found in the latest release.');
+    ui.error('No ZIP asset found in the latest release.');
     process.exit(1);
   }
 
-  console.log(`Downloading ${asset.name} (${version})...`);
+  ui.step(`Downloading ${version}...`);
   const zipBuffer = await downloadReleaseAsset(asset, token);
 
   // Write ZIP to temp file and extract
@@ -36,7 +43,7 @@ async function run() {
   fs.writeFileSync(tmpZip, zipBuffer);
 
   try {
-    console.log('Extracting template files...');
+    ui.step('Extracting template files...');
     execSync(`unzip -o "${tmpZip}" -d "${process.cwd()}"`, { stdio: 'pipe' });
   } finally {
     fs.unlinkSync(tmpZip);
@@ -48,8 +55,22 @@ async function run() {
   // Write version file
   writeLocalVersion(version);
 
-  console.log(`\nAxiomatic ${version} installed.`);
-  console.log('Run: claude, then /build');
+  // Count installed hooks
+  const hooksDir = path.join(process.cwd(), '.claude', 'hooks');
+  let hookCount = 0;
+  try {
+    hookCount = fs.readdirSync(hooksDir).filter((f) => f.endsWith('.js')).length;
+  } catch {}
+
+  console.log('');
+  ui.success(`${TEMPLATE_SKILLS.length} skills installed`);
+  ui.success(`${TEMPLATE_AGENTS.length} agents installed`);
+  ui.success(`${hookCount} hooks installed`);
+
+  ui.done(`Axiomatic ${version} installed.`);
+  ui.info('Next: claude');
+  ui.info('Then: /build <what you want to create>');
+  console.log('');
 }
 
 module.exports = run;

package/lib/ui.js

@@ -0,0 +1,53 @@
+// Branding and UI helpers for the Axiomatic CLI.
+
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const CYAN = '\x1b[36m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const WHITE = '\x1b[97m';
+const MAGENTA = '\x1b[35m';
+
+function banner(version) {
+  console.log('');
+  console.log(`${DIM}  ╔═══════════════════════════════════════╗${RESET}`);
+  console.log(`${DIM}  ║                                       ║${RESET}`);
+  console.log(`${DIM}  ║${RESET}     ${MAGENTA}${BOLD}◆${RESET}  ${WHITE}${BOLD}A X I O M A T I C${RESET}          ${DIM}║${RESET}`);
+  console.log(`${DIM}  ║${RESET}        ${DIM}AI-Powered Development${RESET}       ${DIM}║${RESET}`);
+  console.log(`${DIM}  ║                                       ║${RESET}`);
+  console.log(`${DIM}  ╚═══════════════════════════════════════╝${RESET}`);
+  if (version) {
+    console.log(`${DIM}                  ${version}${RESET}`);
+  }
+  console.log('');
+}
+
+function step(msg) {
+  console.log(`  ${DIM}...${RESET} ${msg}`);
+}
+
+function success(msg) {
+  console.log(`  ${GREEN}✓${RESET} ${msg}`);
+}
+
+function warn(msg) {
+  console.log(`  ${YELLOW}!${RESET} ${msg}`);
+}
+
+function error(msg) {
+  console.error(`  ${RED}✗${RESET} ${msg}`);
+}
+
+function info(msg) {
+  console.log(`  ${CYAN}i${RESET} ${msg}`);
+}
+
+function done(msg) {
+  console.log('');
+  console.log(`  ${GREEN}${BOLD}${msg}${RESET}`);
+  console.log('');
+}
+
+module.exports = { banner, step, success, warn, error, info, done, BOLD, DIM, RESET, GREEN, YELLOW, CYAN, RED, WHITE, MAGENTA };

package/lib/update.js

@@ -5,36 +5,42 @@ const { requireAuth } = require('./auth.js');
 const { getLatestRelease, downloadReleaseAsset } = require('./download.js');
 const { readLocalVersion, writeLocalVersion } = require('./version.js');
 const { isTemplatePath } = require('./manifest.js');
+const ui = require('./ui.js');
 
 async function run() {
   const current = readLocalVersion();
   if (!current) {
-    console.error('Not initialized. Run "axiomatic init" first.');
+    ui.banner();
+    ui.error('Not initialized. Run: axiomatic init');
+    console.log('');
     process.exit(1);
   }
 
-  console.log('Authenticating with GitHub...');
+  ui.banner(current);
+
+  ui.step('Authenticating with GitHub...');
   const token = requireAuth();
 
-  console.log('Fetching latest release...');
+  ui.step('Checking for updates...');
   const release = await getLatestRelease(token);
   const latest = release.tag_name;
 
   if (current === latest) {
-    console.log(`Already up to date (${current}).`);
+    ui.success(`Already up to date (${current}).`);
+    console.log('');
     return;
   }
 
-  console.log(`Updating ${current} -> ${latest}`);
+  ui.info(`${current} ${ui.DIM}->${ui.RESET} ${ui.BOLD}${latest}${ui.RESET}`);
 
   // Find the ZIP asset
   const asset = release.assets.find((a) => a.name.endsWith('.zip'));
   if (!asset) {
-    console.error('No ZIP asset found in the latest release.');
+    ui.error('No ZIP asset found in the latest release.');
     process.exit(1);
   }
 
-  console.log(`Downloading ${asset.name}...`);
+  ui.step(`Downloading ${latest}...`);
   const zipBuffer = await downloadReleaseAsset(asset, token);
 
   // Write ZIP to temp file
@@ -47,6 +53,8 @@ async function run() {
     fs.mkdirSync(tmpDir, { recursive: true });
     execSync(`unzip -o "${tmpZip}" -d "${tmpDir}"`, { stdio: 'pipe' });
 
+    ui.step('Updating template files...');
+
     // Copy only template files
     const updated = [];
     copyTemplateFiles(tmpDir, process.cwd(), '', updated);
@@ -54,14 +62,20 @@ async function run() {
     // Write version file
     writeLocalVersion(latest);
 
-    console.log(`\nUpdated ${current} -> ${latest}`);
-    if (updated.length > 0) {
-      console.log(`\nUpdated files:`);
-      for (const f of updated) {
-        console.log(`  ${f}`);
-      }
-    }
-    console.log('\nRestart CLI to apply agent changes.');
+    console.log('');
+    const skills = updated.filter((f) => f.includes('/skills/')).length;
+    const agents = updated.filter((f) => f.includes('/agents/')).length;
+    const hooks = updated.filter((f) => f.includes('/hooks/')).length;
+    const other = updated.length - skills - agents - hooks;
+
+    if (skills) ui.success(`${skills} skills updated`);
+    if (agents) ui.success(`${agents} agents updated`);
+    if (hooks) ui.success(`${hooks} hooks updated`);
+    if (other) ui.success(`${other} other files updated`);
+
+    ui.done(`Updated to ${latest}.`);
+    ui.warn('Restart CLI to apply agent changes.');
+    console.log('');
   } finally {
     fs.unlinkSync(tmpZip);
     fs.rmSync(tmpDir, { recursive: true, force: true });

package/lib/version.js

@@ -2,6 +2,7 @@ const fs = require('fs');
 const path = require('path');
 const { getGitHubToken } = require('./auth.js');
 const { getLatestRelease } = require('./download.js');
+const ui = require('./ui.js');
 
 const VERSION_FILE = path.join(process.cwd(), '.claude', '.axiomatic-version');
 
@@ -20,36 +21,41 @@ function writeLocalVersion(version) {
 }
 
 async function run() {
-  const cliVersion = require('../package.json').version;
   const local = readLocalVersion();
 
-  console.log(`CLI:   v${cliVersion}`);
+  ui.banner(local);
+
+  const cliVersion = require('../package.json').version;
+  ui.info(`CLI version: v${cliVersion}`);
 
   if (local) {
-    console.log(`Local: ${local}`);
+    ui.info(`Installed:   ${local}`);
   } else {
-    console.log('Local: not installed (run "axiomatic init" first)');
+    ui.warn('Not installed. Run: axiomatic init');
   }
 
   const token = getGitHubToken();
   if (!token) {
-    console.log('Latest: (authenticate with GitHub to check)');
+    ui.warn('Authenticate with GitHub to check for updates.');
+    console.log('');
     return;
   }
 
   try {
     const release = await getLatestRelease(token);
     const latest = release.tag_name;
-    console.log(`Latest: ${latest}`);
+    ui.info(`Latest:      ${latest}`);
 
+    console.log('');
     if (local && local === latest) {
-      console.log('\nUp to date.');
+      ui.success('Up to date.');
     } else if (local) {
-      console.log('\nUpdate available. Run: axiomatic update');
+      ui.warn(`Update available. Run: axiomatic update`);
     }
   } catch (err) {
-    console.error(`\nCould not fetch latest release: ${err.message}`);
+    ui.error(`Could not fetch latest release: ${err.message}`);
   }
+  console.log('');
 }
 
 module.exports = run;

package/package.json

@@ -1,13 +1,31 @@
 {
   "name": "@axiomatic-labs/cli",
-  "version": "1.0.0",
-  "description": "CLI for installing and updating Axiomatic project templates",
+  "version": "1.0.2",
+  "description": "AI-powered development toolkit for Claude Code. Skills, agents, hooks, and quality gates that ship production apps — not prototypes.",
   "bin": {
     "axiomatic": "./bin/cli.js"
   },
   "files": [
     "bin/",
-    "lib/"
+    "lib/",
+    "README.md"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "ai-agents",
+    "ai-coding",
+    "developer-tools",
+    "cli",
+    "scaffolding",
+    "code-quality",
+    "automation",
+    "skills",
+    "agents",
+    "anthropic",
+    "llm",
+    "devtools"
   ],
   "engines": {
     "node": ">=18"
@@ -16,6 +34,7 @@
     "type": "git",
     "url": "https://github.com/axiomatic-labs/axiomatic-cli.git"
   },
+  "homepage": "https://axiomatic.dev",
   "license": "UNLICENSED",
   "private": false
 }