# 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:

```bash
# 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:

```bash
# 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:

```bash
# 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:

| 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 |

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

## Windsurf Provider

New experimental provider for Windsurf IDE:

```bash
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

```bash
# 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
```

## Resources

- [CLI Usage Guide](../CLI_USAGE.md)
- [Model Configuration Guide](../configuration/model-configuration.md)
- [GitHub Release](https://github.com/jmagly/aiwg/releases/tag/v2024.12.5)