v2024.12.5

Previous release

v2024.12.5 - "Flexible Models & Terminal Docs" Release

Released: December 13, 2025

This release introduces flexible model selection for agent deployment, a terminal-aesthetic documentation site with full-text search and CLI commands, the Smithing Framework for creating AIWG components, and Windsurf provider support.

Highlights

What Changed	Why You Care
Terminal docs site	Documentation with CLI-style interface, search, and themes
Smithing Framework	Create agents, skills, commands, and MCP servers dynamically
Windsurf provider	Deploy to Windsurf IDE
Flexible model selection	Override models per tier when deploying agents
Filter-based deployment	Deploy only specific agents by pattern or role
Persistent model config	Save model preferences for future deployments

Model Selection

Override models at deployment time using the new flags:

# Override reasoning tier (opus-level agents)
aiwg use sdlc --reasoning-model claude-opus-4-2

# Override coding tier (sonnet-level agents)
aiwg use sdlc --coding-model claude-sonnet-5

# Override all tiers at once
aiwg use sdlc \
  --reasoning-model opus-4-2 \
  --coding-model sonnet-5 \
  --efficiency-model haiku-4

Filter-Based Deployment

Deploy only specific agents using filters:

# Only deploy architect agents
aiwg use sdlc --filter "*architect*" --reasoning-model opus-4-2

# Only deploy reasoning-tier agents
aiwg use sdlc --filter-role reasoning --reasoning-model custom-model

# Only deploy coding-tier agents
aiwg use sdlc --filter-role coding --coding-model my-coding-model

Persistent Configuration

Save your model preferences for future deployments:

# Save to project models.json (team consistency)
aiwg use sdlc --reasoning-model opus-4-2 --save

# Save to user config (personal preference)
aiwg use sdlc --reasoning-model opus-4-2 --save-user

The saved configuration applies automatically to future `aiwg use` commands.

Agentic Command

The `/aiwg-refresh` command also supports model selection:

/aiwg-refresh --all --reasoning-model claude-opus-4-2
/aiwg-refresh --sdlc --filter "*architect*" --reasoning-model opus-4-2
/aiwg-refresh --all --coding-model sonnet-5 --save

Terminal Documentation Site

The documentation site now features a terminal-inspired interface:

CLI-style console - Search and navigate via command input at the bottom
Full-text search - Search all documentation content with term highlighting
Log entry format - Content displayed as categorized terminal log entries
Three themes - Dark, Light (OS/2 Warp inspired cream palette), and Matrix
Clickable search results - All results displayed as navigable links
Keyboard shortcuts:
`?` - Toggle help
`/` - Focus search
`t` - Cycle themes
`gg` - Scroll to top
`G` - Scroll to bottom

Console commands: `help`, `search <query>`, `theme dark|light|matrix`, `clear`, `home`

Smithing Framework (Preview)

New meta-framework for dynamically creating AIWG components:

# Example: Create an MCP server
/mcpsmith create weather-api --tools "get_forecast,get_alerts"

Smith	Purpose
ToolSmith	Create MCP tools from specifications
MCPSmith	Build complete MCP servers with Docker support
AgentSmith	Generate specialized agents from descriptions
SkillSmith	Create Claude Code skills
CommandSmith	Build slash commands

Windsurf Provider

New experimental provider for Windsurf IDE:

aiwg use sdlc --provider windsurf

Bug Fixes

Dry-run flag - Directory creation now respects `--dry-run` across all providers
Skill deployment test - Fixed test to use Claude provider (Factory doesn't support skills)
Search auto-navigation - Fixed search jumping to first result instead of showing all results

Upgrade

# Update to latest
aiwg -update

# Verify installation
aiwg -version

# Test model selection (dry run)
aiwg use sdlc --reasoning-model claude-opus-4-2 --dry-run