serpentstack 0.2.6 → 0.2.9

package/bin/serpentstack.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { error, bold, dim, green, cyan, getVersion, printHeader } from '../lib/utils/ui.js';
+import { error, bold, dim, green, cyan, yellow, getVersion, printHeader, divider } from '../lib/utils/ui.js';
 
 // Short flag aliases
 const FLAG_ALIASES = { f: 'force', h: 'help', v: 'version', a: 'all' };
@@ -57,33 +57,36 @@ function editDistance(a, b) {
 
 function showHelp() {
   printHeader();
-  console.log(`  ${bold('Usage:')} serpentstack <command> [options]
-
-  ${bold(green('New projects'))}
-    ${cyan('stack new')} <name>              Scaffold a full project from the template
-    ${cyan('stack update')}                  Update template-level files to latest
-
-  ${bold(green('Any project'))}
-    ${cyan('skills')}                        Download base skills + persistent agent configs
-    ${cyan('skills update')}                 Update base skills to latest versions
-    ${cyan('persistent')}                    Manage and launch persistent agents
-    ${cyan('persistent')} --stop             Stop all running agents
-    ${cyan('persistent')} --reconfigure      Re-run setup (change models, enable/disable)
-
-  ${bold('Options:')}
-    -f, --force                   Overwrite existing files
-    -a, --all                     Include new files in updates (skills update)
-    -v, --version                 Show version
-    -h, --help                    Show this help
-
-  ${dim('Examples:')}
-    ${dim('$')} serpentstack stack new my-saas-app
-    ${dim('$')} serpentstack skills
-    ${dim('$')} serpentstack persistent
-    ${dim('$')} serpentstack persistent --stop
-
-  ${dim('Docs: https://github.com/Benja-Pauls/SerpentStack')}
-`);
+  console.log(`  ${dim('Deployable fullstack templates + AI agent skills for any project')}`);
+  console.log();
+
+  divider('New projects');
+  console.log(`    ${cyan('stack new')} ${dim('<name>')}             Scaffold a full project from the template`);
+  console.log(`    ${cyan('stack update')}                  Update template-level files to latest`);
+  console.log();
+
+  divider('Any project');
+  console.log(`    ${cyan('skills')}                        Download all skills + persistent agent configs`);
+  console.log(`    ${cyan('skills update')}                 Update base skills to latest versions`);
+  console.log(`    ${cyan('persistent')}                    Manage and launch persistent background agents`);
+  console.log(`    ${cyan('persistent')} ${dim('--stop')}            Stop all running agents`);
+  console.log(`    ${cyan('persistent')} ${dim('--reconfigure')}     Change models, enable/disable agents`);
+  console.log();
+
+  divider('Options');
+  console.log(`    ${bold('-f')}, ${bold('--force')}                   Overwrite existing files`);
+  console.log(`    ${bold('-a')}, ${bold('--all')}                     Include new files in updates`);
+  console.log(`    ${bold('-v')}, ${bold('--version')}                 Show version`);
+  console.log(`    ${bold('-h')}, ${bold('--help')}                    Show this help`);
+  console.log();
+
+  console.log(`  ${dim('Examples:')}`);
+  console.log(`    ${dim('$')} serpentstack stack new my-saas-app`);
+  console.log(`    ${dim('$')} serpentstack skills`);
+  console.log(`    ${dim('$')} serpentstack persistent`);
+  console.log();
+  console.log(`  ${dim('Docs:')} ${cyan('https://github.com/Benja-Pauls/SerpentStack')}`);
+  console.log();
 }
 
 async function main() {

package/lib/commands/persistent.js

@@ -3,7 +3,7 @@ import { join, resolve } from 'node:path';
 import { execFile, spawn } from 'node:child_process';
 import { createInterface } from 'node:readline/promises';
 import { stdin, stdout } from 'node:process';
-import { info, success, warn, error, bold, dim, green, cyan, yellow, red, printBox, printHeader } from '../utils/ui.js';
+import { info, success, warn, error, bold, dim, green, cyan, yellow, red, divider, printBox, printHeader } from '../utils/ui.js';
 import {
   parseAgentMd,
   discoverAgents,
@@ -53,7 +53,7 @@ async function pickModel(rl, agentName, currentModel, available) {
 
   // Local models first (free, fast, recommended)
   if (available.local.length > 0) {
-    console.log(`    ${dim('\u2500\u2500 Local models (free, no API key needed) \u2500\u2500')}`);
+    console.log(`    ${dim('── Local')} ${green('free')} ${dim('──────────────────────')}`);
     for (const m of available.local) {
       const isCurrent = m.id === currentModel;
       const idx = choices.length;
@@ -62,16 +62,17 @@ async function pickModel(rl, agentName, currentModel, available) {
       const num = dim(`${idx + 1}.`);
       const label = isCurrent ? bold(m.name) : m.name;
       const params = m.params ? dim(` ${m.params}`) : '';
+      const quant = m.quant ? dim(` ${m.quant}`) : '';
       const size = m.size ? dim(` (${m.size})`) : '';
       const tag = isCurrent ? green(' \u2190 current') : '';
-      console.log(`  ${marker} ${num} ${label}${params}${size}${tag}`);
+      console.log(`  ${marker} ${num} ${label}${params}${quant}${size}${tag}`);
     }
   }
 
   // Cloud models (require API key, cost money)
   if (available.cloud.length > 0) {
-    const apiNote = available.hasApiKey ? dim('API key configured') : yellow('requires API key');
-    console.log(`    ${dim('\u2500\u2500 Cloud models')} (${apiNote}) ${dim('\u2500\u2500')}`);
+    const apiNote = available.hasApiKey ? green('key ✓') : yellow('needs API key');
+    console.log(`    ${dim('── Cloud')} ${apiNote} ${dim('─────────────────────')}`);
     for (const m of available.cloud) {
       const isCurrent = m.id === currentModel;
       const idx = choices.length;
@@ -225,11 +226,11 @@ function printAgentLine(name, agentMd, config, statusInfo) {
   const modelStr = modelShortName(model);
 
   if (statusInfo.status === 'running') {
-    console.log(`  ${green('\u25CF')} ${bold(name)}  ${dim(modelStr)}  ${dim(schedule)}  ${green(`PID ${statusInfo.pid}`)}`);
+    console.log(`    ${green('●')} ${bold(name)}  ${dim(modelStr)}  ${dim(schedule)}  ${green(`PID ${statusInfo.pid}`)}`);
   } else if (statusInfo.status === 'disabled') {
-    console.log(`  ${dim('\u25CB')} ${dim(name)}  ${dim(modelStr)}  ${dim(schedule)}  ${dim('disabled')}`);
+    console.log(`    ${dim('○')} ${dim(name)}  ${dim(modelStr)}  ${dim(schedule)}  ${dim('disabled')}`);
   } else {
-    console.log(`  ${yellow('\u25CB')} ${bold(name)}  ${dim(modelStr)}  ${dim(schedule)}  ${dim('stopped')}`);
+    console.log(`    ${yellow('○')} ${bold(name)}  ${dim(modelStr)}  ${dim(schedule)}  ${dim('ready')}`);
   }
 }
 
@@ -305,8 +306,8 @@ export async function persistent({ stop = false, reconfigure = false } = {}) {
 
   // ── If configured, show status dashboard ──
   if (!needsSetup) {
-    console.log(`  ${bold(config.project.name)} ${dim(`\u2014 ${config.project.framework}`)}`);
-    console.log(`  ${dim(`Dev: ${config.project.devCmd} \u2022 Test: ${config.project.testCmd}`)}`);
+    console.log(`  ${bold(config.project.name)} ${dim(`— ${config.project.framework}`)}`);
+    console.log(`  ${dim(`Dev: ${config.project.devCmd} · Test: ${config.project.testCmd}`)}`);
     console.log();
 
     for (const { name, agentMd } of parsed) {
@@ -363,12 +364,12 @@ export async function persistent({ stop = false, reconfigure = false } = {}) {
     };
 
     if (templateDefaults && !existing.name) {
-      info('Detected SerpentStack template \u2014 defaults pre-filled');
+      info('Detected SerpentStack template — defaults pre-filled');
       console.log();
     }
 
-    console.log(`  ${bold('Project')}`);
-    console.log(`  ${dim('Press Enter to keep current values.')}`);
+    divider('Project');
+    console.log(`  ${dim('Press Enter to keep defaults.')}`);
     console.log();
 
     config.project = {
@@ -417,14 +418,14 @@ export async function persistent({ stop = false, reconfigure = false } = {}) {
     }
     console.log();
 
-    console.log(`  ${bold('Agents')}`);
-    console.log(`  ${dim('Enable/disable each agent and choose its model.')}`);
+    divider('Agents');
+    console.log(`  ${dim('Enable/disable each agent and pick a model.')}`);
     console.log();
 
     for (const { name, agentMd } of parsed) {
       const existingAgent = config.agents?.[name];
       const currentEnabled = existingAgent?.enabled !== false;
-      const currentModel = existingAgent?.model || agentMd.meta.model || 'anthropic/claude-haiku-4-20250414';
+      const currentModel = existingAgent?.model || 'ollama/llama3.2';
       const schedule = (agentMd.meta.schedule || []).map(s => s.every).join(', ');
 
       console.log(`  ${bold(name)}  ${dim(agentMd.meta.description || '')}`);
@@ -481,7 +482,7 @@ async function launchAgents(projectDir, agentsToStart, config, soulPath) {
   const toStart = [];
 
   try {
-    console.log(`  ${dim('Select agents to launch:')}`);
+    divider('Launch');
     console.log();
 
     for (const agent of agentsToStart) {
@@ -548,12 +549,12 @@ async function launchAgents(projectDir, agentsToStart, config, soulPath) {
 
   console.log();
   if (started > 0) {
-    success(`${started} agent(s) launched`);
+    success(`${started} agent(s) launched — fangs out 🐍`);
     console.log();
     printBox('Manage agents', [
-      `${dim('$')} ${bold('serpentstack persistent')}                ${dim('# status + start agents')}`,
-      `${dim('$')} ${bold('serpentstack persistent --stop')}         ${dim('# stop all agents')}`,
-      `${dim('$')} ${bold('serpentstack persistent --reconfigure')}  ${dim('# change models, enable/disable')}`,
+      `${dim('$')} ${bold('serpentstack persistent')}                ${dim('# status + start')}`,
+      `${dim('$')} ${bold('serpentstack persistent --stop')}         ${dim('# stop all')}`,
+      `${dim('$')} ${bold('serpentstack persistent --reconfigure')}  ${dim('# change models')}`,
     ]);
   }
 }

package/lib/commands/skills-init.js

@@ -4,13 +4,19 @@ import { downloadFile } from '../utils/github.js';
 import { safeWrite } from '../utils/fs-helpers.js';
 import { readConfig, writeConfig, detectTemplateDefaults, defaultAgentConfig } from '../utils/config.js';
 import { parseAgentMd, discoverAgents } from '../utils/agent-utils.js';
-import { info, success, warn, error, spinner, bold, dim, green, printBox, printPrompt, printHeader, fileStatus } from '../utils/ui.js';
+import { info, success, warn, error, spinner, bold, dim, green, cyan, divider, printBox, printPrompt, printHeader, fileStatus } from '../utils/ui.js';
 
 const SKILLS_FILES = [
+  '.skills/auth/SKILL.md',
+  '.skills/db-migrate/SKILL.md',
+  '.skills/deploy/SKILL.md',
+  '.skills/dev-server/SKILL.md',
   '.skills/find-skills/SKILL.md',
   '.skills/generate-skills/SKILL.md',
   '.skills/git-workflow/SKILL.md',
   '.skills/model-routing/SKILL.md',
+  '.skills/scaffold/SKILL.md',
+  '.skills/test/SKILL.md',
 ];
 
 const OPENCLAW_FILES = [
@@ -29,13 +35,9 @@ const MANIFEST = [...SKILLS_FILES, ...OPENCLAW_FILES, ...DOCS_FILES];
 export async function skillsInit({ force = false } = {}) {
   printHeader();
 
-  // Step 1: Download files
-  console.log(`  ${bold('Downloading')} ${dim('skills + persistent agent configs')}`);
-  console.log();
-
   const results = { created: 0, skipped: 0, overwritten: 0, unchanged: 0, failed: 0 };
   const logs = [];
-  const spin = spinner('Fetching from GitHub...');
+  const spin = spinner('Slithering through GitHub...');
 
   try {
     for (const repoPath of MANIFEST) {
@@ -55,24 +57,26 @@ export async function skillsInit({ force = false } = {}) {
   }
 
   // Group output by section
-  console.log(`  ${dim('IDE Agent Skills')}`);
+  divider('Skills');
   for (let i = 0; i < SKILLS_FILES.length; i++) logs[i] && console.log(logs[i]);
   console.log();
-  console.log(`  ${dim('Persistent Agent (OpenClaw)')}`);
+
+  divider('Persistent Agents');
   for (let i = SKILLS_FILES.length; i < SKILLS_FILES.length + OPENCLAW_FILES.length; i++) logs[i] && console.log(logs[i]);
   console.log();
-  console.log(`  ${dim('Documentation')}`);
+
+  divider('Docs');
   for (let i = SKILLS_FILES.length + OPENCLAW_FILES.length; i < logs.length; i++) logs[i] && console.log(logs[i]);
   console.log();
 
   // Summary line
   const parts = [];
   if (results.created > 0) parts.push(green(`${results.created} created`));
-  if (results.overwritten > 0) parts.push(`${results.overwritten} updated`);
+  if (results.overwritten > 0) parts.push(cyan(`${results.overwritten} updated`));
   if (results.unchanged > 0) parts.push(`${results.unchanged} up to date`);
   if (results.skipped > 0) parts.push(`${results.skipped} skipped`);
   if (results.failed > 0) parts.push(`${results.failed} failed`);
-  console.log(`  ${parts.join(dim(' \u2022 '))}`);
+  console.log(`  ${parts.join(dim(' · '))}`);
 
   if (results.failed === MANIFEST.length) {
     console.log();
@@ -108,17 +112,15 @@ export async function skillsInit({ force = false } = {}) {
     writeConfig(projectDir, config);
     console.log(`  ${fileStatus('.openclaw/config.json', 'created')}`);
     results.created++;
-    console.log();
   }
 
   // Next steps
   console.log();
-  console.log(`  ${bold('Next')} ${dim('\u2014 Generate project-specific skills')}`);
+  divider('What\'s next');
   console.log();
-  console.log(`  ${dim('Open your IDE agent (Claude Code, Cursor, Copilot, etc.)')}`);
-  console.log(`  ${dim('and paste the prompt below. The agent will read your codebase,')}`);
-  console.log(`  ${dim('interview you about your conventions, and produce a full')}`);
-  console.log(`  ${dim('.skills/ directory tailored to your project.')}`);
+  console.log(`  ${dim('Open your IDE agent (Claude Code, Cursor, Copilot, Gemini CLI, etc.)')}`);
+  console.log(`  ${dim('and paste this prompt. It reads your codebase and generates')}`);
+  console.log(`  ${dim('project-specific skills tailored to your stack.')}`);
 
   printPrompt([
     `Read .skills/generate-skills/SKILL.md and follow its instructions`,
@@ -133,11 +135,12 @@ export async function skillsInit({ force = false } = {}) {
     `Reference SKILL-AUTHORING.md for the format.`,
   ]);
 
-  printBox('After generating skills, try setting up persistent agents too', [
-    `${dim('$')} ${bold('serpentstack persistent')}  ${dim('# choose agents + launch')}`,
+  printBox('Want persistent background agents too?', [
+    `${dim('$')} ${bold('serpentstack persistent')}`,
     '',
-    `${dim('Background agents that watch your dev server, run tests,')}`,
-    `${dim('and keep your skills up to date. Each opens in its own')}`,
-    `${dim('terminal window. Pick which to run and choose your models.')}`,
+    `${dim('Agents that watch your dev server, run tests, and keep')}`,
+    `${dim('skills fresh — each in its own terminal. Pick which to')}`,
+    `${dim('run and choose local or cloud models.')}`,
   ]);
+  console.log();
 }

package/lib/commands/skills-update.js

@@ -2,13 +2,19 @@ import { join } from 'node:path';
 import { existsSync, readFileSync } from 'node:fs';
 import { downloadFile } from '../utils/github.js';
 import { safeWrite } from '../utils/fs-helpers.js';
-import { info, success, warn, error, spinner, bold, dim, green, printHeader, fileStatus } from '../utils/ui.js';
+import { info, success, warn, error, spinner, bold, dim, green, cyan, printHeader, fileStatus } from '../utils/ui.js';
 
 const MANIFEST = [
+  '.skills/auth/SKILL.md',
+  '.skills/db-migrate/SKILL.md',
+  '.skills/deploy/SKILL.md',
+  '.skills/dev-server/SKILL.md',
   '.skills/find-skills/SKILL.md',
   '.skills/generate-skills/SKILL.md',
   '.skills/git-workflow/SKILL.md',
   '.skills/model-routing/SKILL.md',
+  '.skills/scaffold/SKILL.md',
+  '.skills/test/SKILL.md',
   '.openclaw/SOUL.md',
   '.openclaw/agents/log-watcher/AGENT.md',
   '.openclaw/agents/test-runner/AGENT.md',
@@ -27,11 +33,8 @@ const CUSTOMIZABLE = new Set([
 export async function skillsUpdate({ force = false, all = false } = {}) {
   printHeader();
 
-  info(`Checking for updates in ${bold(process.cwd())}`);
-  console.log();
-
   const results = { updated: 0, skipped: 0, unchanged: 0, failed: 0 };
-  const spin = spinner('Comparing with latest versions...');
+  const spin = spinner('Checking for updates...');
   const logs = [];
 
   try {
@@ -83,12 +86,11 @@ export async function skillsUpdate({ force = false, all = false } = {}) {
   if (results.unchanged > 0) parts.push(`${results.unchanged} up to date`);
   if (results.skipped > 0) parts.push(`${results.skipped} skipped`);
   if (results.failed > 0) parts.push(`${results.failed} failed`);
-  console.log(`  ${parts.join(dim(' \u2022 '))}`);
+  console.log(`  ${parts.join(dim(' · '))}`);
 
   if (results.updated > 0) {
     console.log();
-    info(`${dim('Your project-specific skills (generated by your IDE agent) are not affected.')}`);
-    info(`${dim('Only the base SerpentStack files were updated.')}`);
+    info(`${dim('Only base SerpentStack files were updated — your custom skills are untouched.')}`);
   }
   console.log();
 }

package/lib/commands/stack-new.js

@@ -3,7 +3,7 @@ import { rm } from 'node:fs/promises';
 import { join, resolve } from 'node:path';
 import { execFile } from 'node:child_process';
 import { cloneRepo, checkGit } from '../utils/github.js';
-import { info, success, warn, error, spinner, bold, dim, green, cyan, printBox, printPrompt, printHeader } from '../utils/ui.js';
+import { info, success, warn, error, spinner, bold, dim, green, yellow, cyan, divider, printBox, printPrompt, printHeader } from '../utils/ui.js';
 
 const CLEANUP_PATHS = [
   'cli',
@@ -60,7 +60,7 @@ export async function stackNew(name) {
   printHeader();
 
   // Step 1: Check prerequisites
-  console.log(`  ${bold('Step 1/4')} ${dim('\u2014 Checking prerequisites')}`);
+  divider('Prerequisites');
   console.log();
 
   const checks = [
@@ -90,13 +90,13 @@ export async function stackNew(name) {
   let missing = [];
   for (const r of results) {
     if (!r.found) {
-      console.log(`  ${dim('\u2022')} ${dim(r.label)} ${dim(`\u2014 install: ${r.url}`)}`);
+      console.log(`    ${dim('○')} ${dim(r.label)} ${dim(`— install: ${r.url}`)}`);
       missing.push(r.label);
     } else if (r.versionOk === false) {
-      console.log(`  ${yellow('\u25B3')} ${r.label} ${dim(`\u2014 found ${r.version}, need newer version`)}`);
+      console.log(`    ${yellow('△')} ${r.label} ${dim(`— found ${r.version}, need newer version`)}`);
       missing.push(r.label);
     } else {
-      console.log(`  ${green('\u2713')} ${r.label}`);
+      console.log(`    ${green('✓')} ${r.label}`);
     }
   }
   console.log();
@@ -113,10 +113,10 @@ export async function stackNew(name) {
   }
 
   // Step 2: Clone template
-  console.log(`  ${bold('Step 2/4')} ${dim('\u2014 Cloning template')}`);
+  divider('Clone');
   console.log();
 
-  const spin = spinner(`Downloading SerpentStack template...`);
+  const spin = spinner('Slithering through GitHub...');
   try {
     await cloneRepo(dest);
     spin.stop();
@@ -129,7 +129,7 @@ export async function stackNew(name) {
 
   // Step 3: Clean up repo-specific files
   console.log();
-  console.log(`  ${bold('Step 3/4')} ${dim('\u2014 Preparing project')}`);
+  divider('Prepare');
   console.log();
 
   for (const p of CLEANUP_PATHS) {
@@ -150,16 +150,16 @@ export async function stackNew(name) {
 
   // Step 4: Summary
   console.log();
-  console.log(`  ${bold('Step 4/4')} ${dim('\u2014 Done!')}`);
+  divider('Ready 🐍');
   console.log();
 
   console.log(`  ${dim('Your project includes:')}`);
-  console.log(`  ${green('\u2713')} FastAPI backend ${dim('(async SQLAlchemy, JWT auth, ownership enforcement)')}`);
-  console.log(`  ${green('\u2713')} React frontend ${dim('(TypeScript, Vite, shadcn/ui)')}`);
-  console.log(`  ${green('\u2713')} PostgreSQL + Redis ${dim('(Docker Compose)')}`);
-  console.log(`  ${green('\u2713')} Terraform infrastructure ${dim('(AWS App Runner, RDS, ECR)')}`);
-  console.log(`  ${green('\u2713')} 10 project-specific Agent Skills ${dim('(.skills/)')}`);
-  console.log(`  ${green('\u2713')} Persistent agent configs ${dim('(.openclaw/)')}`);
+  console.log(`    ${green('✓')} FastAPI backend ${dim('(async SQLAlchemy, JWT auth, ownership)')}`);
+  console.log(`    ${green('✓')} React frontend ${dim('(TypeScript, Vite, shadcn/ui)')}`);
+  console.log(`    ${green('✓')} PostgreSQL + Redis ${dim('(Docker Compose)')}`);
+  console.log(`    ${green('✓')} Terraform infrastructure ${dim('(AWS App Runner, RDS, ECR)')}`);
+  console.log(`    ${green('✓')} 10 agent skills ${dim('(.skills/)')}`);
+  console.log(`    ${green('✓')} Persistent agent configs ${dim('(.openclaw/)')}`);
   console.log();
 
   printBox('Get started', [

package/lib/utils/agent-utils.js

@@ -164,7 +164,7 @@ function generateHeartbeat(schedule) {
 }
 
 function generateAgentsConfig(meta) {
-  const model = meta.model || 'anthropic/claude-haiku-4-20250414';
+  const model = meta.model || 'ollama/llama3.2';
   const tools = meta.tools || ['file-system', 'shell', 'git'];
 
   return [

package/lib/utils/config.js

@@ -3,12 +3,16 @@ import { join } from 'node:path';
 
 const CONFIG_PATH = '.openclaw/config.json';
 
+// Default model for persistent agents — local first, always.
+// Cloud models cost tokens per heartbeat and require API keys.
+const DEFAULT_MODEL = 'ollama/llama3.2';
+
 /**
  * Default config structure:
  * {
  *   project: { name, language, framework, devCmd, testCmd, conventions },
  *   agents: {
- *     "log-watcher": { enabled: true, model: "anthropic/claude-haiku-4-20250414" },
+ *     "log-watcher": { enabled: true, model: "ollama/llama3.2" },
  *     ...
  *   }
  * }
@@ -49,9 +53,9 @@ export function detectTemplateDefaults(projectDir) {
 
   try {
     const content = readFileSync(makefile, 'utf8');
-    // SerpentStack Makefile: must have 'make verify' AND either 'uv run' or 'uvicorn'
-    if (!content.includes('make verify')) return null;
-    if (!content.includes('uv run') && !content.includes('uvicorn')) return null;
+    // SerpentStack Makefile: must have a 'verify:' target AND 'uv run' (Python tooling)
+    if (!/^verify:/m.test(content)) return null;
+    if (!content.includes('uv run')) return null;
 
     // It's a SerpentStack template project — return smart defaults
     const defaults = {
@@ -83,7 +87,7 @@ export function detectTemplateDefaults(projectDir) {
 export function defaultAgentConfig(meta) {
   return {
     enabled: true,
-    model: meta.model || 'anthropic/claude-haiku-4-20250414',
+    model: DEFAULT_MODEL,
   };
 }
 
@@ -94,7 +98,7 @@ export function getEffectiveModel(agentName, agentMeta, config) {
   if (config?.agents?.[agentName]?.model) {
     return config.agents[agentName].model;
   }
-  return agentMeta.model || 'anthropic/claude-haiku-4-20250414';
+  return DEFAULT_MODEL;
 }
 
 /**

package/lib/utils/models.js

@@ -21,62 +21,87 @@ export async function detectModels() {
 }
 
 /**
- * Detect locally installed Ollama models with parameter counts.
- * Parses `ollama list` output.
+ * Detect locally installed Ollama models via the REST API.
+ * GET http://localhost:11434/api/tags returns structured JSON with real
+ * parameter counts, sizes, and quantization levels — no CLI parsing needed.
  */
 async function detectOllamaModels() {
   try {
-    const output = await execAsync('ollama', ['list']);
-    const lines = output.trim().split('\n');
-    if (lines.length < 2) return []; // header only
+    const response = await fetchWithTimeout('http://localhost:11434/api/tags', 3000);
+    if (!response.ok) return [];
 
-    // Parse header to find column positions
-    const header = lines[0];
-    const nameEnd = header.indexOf('ID');
-    const sizeStart = header.indexOf('SIZE');
+    const data = await response.json();
+    if (!data.models || !Array.isArray(data.models)) return [];
 
-    return lines.slice(1).map(line => {
-      if (!line.trim()) return null;
-
-      const name = line.slice(0, nameEnd).trim();
+    return data.models.map(m => {
+      const name = (m.name || '').replace(':latest', '');
       if (!name) return null;
 
-      // Extract size (e.g., "4.7 GB", "1.3 GB")
-      const sizeStr = sizeStart >= 0 ? line.slice(sizeStart).trim().split(/\s{2,}/)[0] : '';
-
-      // Estimate parameter count from model name (e.g., "llama3.2:3b", "qwen2.5-coder:7b")
-      const paramMatch = name.match(/[:\-](\d+\.?\d*)[bB]/);
-      const params = paramMatch ? paramMatch[1] + 'B' : guessParams(name, sizeStr);
-
-      const shortName = name.replace(':latest', '');
+      // Use the real parameter count from the API when available
+      const details = m.details || {};
+      const params = formatParamCount(details.parameter_size) || guessParamsFromSize(m.size);
+      const quant = details.quantization_level || '';
+      const sizeStr = formatBytes(m.size);
 
       return {
-        id: `ollama/${shortName}`,
-        name: shortName,
+        id: `ollama/${name}`,
+        name,
         params,
+        quant,
         size: sizeStr,
         tier: 'local',
       };
     }).filter(Boolean);
   } catch {
+    // Ollama not running or not installed
     return [];
   }
 }
 
 /**
- * Guess parameter count from file size if not in the name.
+ * Format parameter count from Ollama API (e.g., "7B", "3.2B", "70B").
+ * The API returns strings like "7B", "3.21B", etc. in details.parameter_size.
+ */
+function formatParamCount(paramSize) {
+  if (!paramSize) return '';
+  // Already formatted like "7B" or "3.2B"
+  const s = String(paramSize).trim();
+  if (/^\d+\.?\d*[BbMm]$/i.test(s)) return s.toUpperCase();
+  return s;
+}
+
+/**
+ * Fallback: estimate parameter count from file size.
  * Rough heuristic: ~0.5GB per billion parameters for Q4 quantization.
  */
-function guessParams(name, sizeStr) {
-  const gbMatch = sizeStr.match(/([\d.]+)\s*GB/i);
-  if (gbMatch) {
-    const gb = parseFloat(gbMatch[1]);
-    const billions = Math.round(gb * 2); // Q4 ≈ 0.5GB/B
-    if (billions > 0) return `~${billions}B`;
-  }
+function guessParamsFromSize(bytes) {
+  if (!bytes || bytes <= 0) return '';
+  const gb = bytes / (1024 ** 3);
+  const billions = Math.round(gb * 2); // Q4 ≈ 0.5GB/B
+  if (billions > 0) return `~${billions}B`;
   return '';
 }
 
+/**
+ * Format bytes into human-readable size (e.g., "4.7 GB").
+ */
+function formatBytes(bytes) {
+  if (!bytes || bytes <= 0) return '';
+  const gb = bytes / (1024 ** 3);
+  if (gb >= 1) return `${gb.toFixed(1)} GB`;
+  const mb = bytes / (1024 ** 2);
+  return `${Math.round(mb)} MB`;
+}
+
+/**
+ * Fetch with timeout using AbortController (Node 18+).
+ */
+function fetchWithTimeout(url, timeoutMs) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  return fetch(url, { signal: controller.signal }).finally(() => clearTimeout(timeout));
+}
+
 /**
  * Check OpenClaw for configured models and API key status.
  */

package/lib/utils/ui.js

@@ -17,10 +17,17 @@ const MAGENTA = c(35);
 const CYAN = c(36);
 const BG_DIM = c(100);
 
-export const info = (msg) => console.log(`  ${CYAN}\u2022${RESET} ${msg}`);
-export const success = (msg) => console.log(`  ${GREEN}\u2713${RESET} ${msg}`);
-export const warn = (msg) => console.log(`  ${YELLOW}\u25B3${RESET} ${msg}`);
-export const error = (msg) => console.error(`  ${RED}\u2717${RESET} ${msg}`);
+// ─── Brand ───────────────────────────────────────────────────
+
+const SNAKE = '🐍';
+const BRAND_COLOR = GREEN;
+
+// ─── Text formatters ─────────────────────────────────────────
+
+export const info = (msg) => console.log(`  ${CYAN}•${RESET} ${msg}`);
+export const success = (msg) => console.log(`  ${GREEN}✓${RESET} ${msg}`);
+export const warn = (msg) => console.log(`  ${YELLOW}△${RESET} ${msg}`);
+export const error = (msg) => console.error(`  ${RED}✗${RESET} ${msg}`);
 export const dim = (msg) => `${DIM}${msg}${RESET}`;
 export const bold = (msg) => `${BOLD}${msg}${RESET}`;
 export const green = (msg) => `${GREEN}${msg}${RESET}`;
@@ -30,18 +37,22 @@ export const cyan = (msg) => `${CYAN}${msg}${RESET}`;
 export const magenta = (msg) => `${MAGENTA}${msg}${RESET}`;
 export const blue = (msg) => `${BLUE}${msg}${RESET}`;
 
-const SPINNER_FRAMES = ['\u280B', '\u2819', '\u2839', '\u2838', '\u283C', '\u2834', '\u2826', '\u2827', '\u2807', '\u280F'];
+// ─── Spinner ─────────────────────────────────────────────────
+
+const SPINNER_FRAMES = ['◐', '◓', '◑', '◒'];
 
 export function spinner(msg) {
   if (NO_COLOR || !stderr.isTTY) {
     stderr.write(`  ${msg}\n`);
-    return { stop(final) { if (final) stderr.write(`  ${final}\n`); } };
+    return { stop(final) { if (final) stderr.write(`  ${final}\n`); }, update() {} };
   }
   let i = 0;
+  let currentMsg = msg;
   const id = setInterval(() => {
-    stderr.write(`\r${CYAN}${SPINNER_FRAMES[i++ % SPINNER_FRAMES.length]}${RESET} ${msg}`);
-  }, 80);
+    stderr.write(`\r  ${GREEN}${SPINNER_FRAMES[i++ % SPINNER_FRAMES.length]}${RESET} ${currentMsg}`);
+  }, 100);
   return {
+    update(newMsg) { currentMsg = newMsg; },
     stop(final) {
       clearInterval(id);
       stderr.write(`\r\x1b[K`);
@@ -50,16 +61,20 @@ export function spinner(msg) {
   };
 }
 
+// ─── Confirm ─────────────────────────────────────────────────
+
 export async function confirm(msg) {
   const rl = createInterface({ input: stdin, output: stdout });
   try {
-    const answer = await rl.question(`${YELLOW}?${RESET} ${msg} ${dim('(y/N)')} `);
+    const answer = await rl.question(`${YELLOW}?${RESET} ${msg} ${DIM}(y/N)${RESET} `);
     return answer.trim().toLowerCase() === 'y';
   } finally {
     rl.close();
   }
 }
 
+// ─── Version ─────────────────────────────────────────────────
+
 export function getVersion() {
   try {
     const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
@@ -69,36 +84,44 @@ export function getVersion() {
   }
 }
 
+// ─── Headers & Dividers ──────────────────────────────────────
+
 export function printHeader() {
-  console.log(`\n  ${BOLD}${GREEN}\u2728 SerpentStack${RESET} ${DIM}v${getVersion()}${RESET}\n`);
+  console.log();
+  console.log(`  ${SNAKE} ${BOLD}${GREEN}SerpentStack${RESET} ${DIM}v${getVersion()}${RESET}`);
+  console.log();
 }
 
+export function divider(label) {
+  if (label) {
+    console.log(`  ${DIM}── ${RESET}${BOLD}${label}${RESET} ${DIM}${'─'.repeat(Math.max(0, 50 - stripAnsi(label).length))}${RESET}`);
+  } else {
+    console.log(`  ${DIM}${'─'.repeat(54)}${RESET}`);
+  }
+}
+
+// ─── Boxes ───────────────────────────────────────────────────
+
 /**
  * Print a boxed section with a title and content lines.
- * Used for "Next steps" and prompt blocks.
  */
-export function printBox(title, lines, { color = GREEN, icon = '\u25B6' } = {}) {
-  const maxLen = Math.max(
-    title.length + 4,
-    ...lines.map(l => stripAnsi(l).length + 4)
-  );
+export function printBox(title, lines, { color = GREEN, icon = '▶' } = {}) {
+  const allText = [title, ...lines];
+  const maxLen = Math.max(...allText.map(l => stripAnsi(l).length + 4));
   const width = Math.min(Math.max(maxLen, 50), 80);
-  const top = `${color}\u250C${'─'.repeat(width)}\u2510${RESET}`;
-  const bot = `${color}\u2514${'─'.repeat(width)}\u2518${RESET}`;
 
-  console.log(top);
-  console.log(`${color}\u2502${RESET} ${BOLD}${icon} ${title}${RESET}${' '.repeat(Math.max(0, width - stripAnsi(title).length - 3))}${color}\u2502${RESET}`);
-  console.log(`${color}\u2502${' '.repeat(width)}${color}\u2502${RESET}`);
+  console.log(`  ${DIM}┌${'─'.repeat(width)}┐${RESET}`);
+  console.log(`  ${DIM}│${RESET} ${BOLD}${icon} ${title}${RESET}${' '.repeat(Math.max(0, width - stripAnsi(title).length - 3))}${DIM}│${RESET}`);
+  console.log(`  ${DIM}│${' '.repeat(width)}│${RESET}`);
   for (const line of lines) {
     const pad = Math.max(0, width - stripAnsi(line).length - 2);
-    console.log(`${color}\u2502${RESET}  ${line}${' '.repeat(pad)}${color}\u2502${RESET}`);
+    console.log(`  ${DIM}│${RESET}  ${line}${' '.repeat(pad)}${DIM}│${RESET}`);
   }
-  console.log(bot);
+  console.log(`  ${DIM}└${'─'.repeat(width)}┘${RESET}`);
 }
 
 /**
- * Print a copyable prompt block that the user can paste into their IDE agent.
- * Accepts a single string or an array of lines for multi-line prompts.
+ * Print a copyable prompt block.
  */
 export function printPrompt(promptLines, { hint = 'Copy this prompt and paste it into your IDE agent' } = {}) {
   const lines = Array.isArray(promptLines) ? promptLines : [promptLines];
@@ -107,45 +130,43 @@ export function printPrompt(promptLines, { hint = 'Copy this prompt and paste it
   const innerWidth = width - 2;
 
   console.log();
-  console.log(`  ${DIM}\u250C${'─'.repeat(innerWidth)}\u2510${RESET}`);
+  console.log(`  ${DIM}┌${'─'.repeat(innerWidth)}┐${RESET}`);
   for (const line of lines) {
     const pad = Math.max(0, innerWidth - stripAnsi(line).length - 2);
-    console.log(`  ${DIM}\u2502${RESET} ${CYAN}${line}${RESET}${' '.repeat(pad)}${DIM}\u2502${RESET}`);
+    console.log(`  ${DIM}│${RESET} ${CYAN}${line}${RESET}${' '.repeat(pad)}${DIM}│${RESET}`);
   }
-  console.log(`  ${DIM}\u2514${'─'.repeat(innerWidth)}\u2518${RESET}`);
-  console.log(`  ${DIM}\u2191 ${hint}${RESET}`);
+  console.log(`  ${DIM}└${'─'.repeat(innerWidth)}┘${RESET}`);
+  console.log(`  ${DIM}↑ ${hint}${RESET}`);
   console.log();
 }
 
-/**
- * File status icon with color.
- */
+// ─── File Status ─────────────────────────────────────────────
+
 export function fileIcon(status) {
   switch (status) {
-    case 'created': return `${GREEN}\u2713${RESET}`;
-    case 'overwritten': return `${CYAN}\u21BB${RESET}`;
-    case 'skipped': return `${YELLOW}\u2022${RESET}`;
-    case 'failed': return `${RED}\u2717${RESET}`;
-    case 'unchanged': return `${DIM}\u2022${RESET}`;
-    default: return `${DIM}\u2022${RESET}`;
+    case 'created': return `${GREEN}✓${RESET}`;
+    case 'overwritten': return `${CYAN}↻${RESET}`;
+    case 'skipped': return `${YELLOW}•${RESET}`;
+    case 'failed': return `${RED}✗${RESET}`;
+    case 'unchanged': return `${DIM}•${RESET}`;
+    default: return `${DIM}•${RESET}`;
   }
 }
 
-/**
- * Format a file path with its status for display.
- */
 export function fileStatus(path, status, detail) {
   const icon = fileIcon(status);
   switch (status) {
-    case 'created': return `  ${icon} ${green(path)}`;
-    case 'overwritten': return `  ${icon} ${cyan(path)} ${dim('(updated)')}`;
-    case 'skipped': return `  ${icon} ${dim(`${path} (${detail || 'exists, skipped'})`)}`;
-    case 'failed': return `  ${icon} ${red(path)} ${dim(`\u2014 ${detail}`)}`;
-    case 'unchanged': return `  ${icon} ${dim(`${path} (up to date)`)}`;
-    default: return `  ${icon} ${path}`;
+    case 'created': return `    ${icon} ${path}`;
+    case 'overwritten': return `    ${icon} ${cyan(path)} ${dim('(updated)')}`;
+    case 'skipped': return `    ${icon} ${dim(`${path} (${detail || 'exists, skipped'})`)}`;
+    case 'failed': return `    ${icon} ${red(path)} ${dim(`— ${detail}`)}`;
+    case 'unchanged': return `    ${icon} ${dim(`${path} (up to date)`)}`;
+    default: return `    ${icon} ${path}`;
   }
 }
 
-function stripAnsi(str) {
+// ─── Utilities ───────────────────────────────────────────────
+
+export function stripAnsi(str) {
   return str.replace(/\x1b\[[\d;]*m/g, '');
 }

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "serpentstack",
-  "version": "0.2.6",
+  "version": "0.2.9",
   "description": "CLI for SerpentStack — AI-driven development standards with project-specific skills and persistent agents",
   "type": "module",
   "bin": {
-    "serpentstack": "./bin/serpentstack.js"
+    "serpentstack": "bin/serpentstack.js"
   },
   "engines": {
     "node": ">=22"
@@ -27,7 +27,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Benja-Pauls/SerpentStack"
+    "url": "git+https://github.com/Benja-Pauls/SerpentStack.git"
   },
   "homepage": "https://github.com/Benja-Pauls/SerpentStack#readme",
   "author": "Ben Paulson"