v1.5.x Florence Series - Major Update

[waleedkadous]

Codev v1.5.x Florence Series

The v1.5.x Florence series brings major new capabilities to Codev, named after Brunelleschi's revolutionary dome atop the Florence Cathedral - an engineering marvel that enabled new possibilities through innovative design.

Headline Features

🌐 Secure Remote Access (Spec 0062)

Access Agent Farm from any device - iPad, laptop, or cloud VM - with a single command:

af start --remote user@192.168.1.100

• SSH tunnel handles authentication and encryption automatically
• Reverse proxy routes all terminal traffic through a single port
• Works with cloud VMs, local robots, Raspberry Pi, and any SSH-accessible machine
• Perfect for managing builds on remote servers or working from tablets

🎨 3D Model Viewer (Spec 0061)

View STL and 3MF files directly in the dashboard:

• STL support with smooth shading and proper normals
• 3MF multi-color rendering for multi-material prints
• Quaternion trackball rotation (no gimbal lock)
• Auto-reload when files change on disk
• Great for CAD/3D printing projects

🖥️ af architect Command (TICK 0002-001)

New command for architect-only workflows:

af architect                    # Start architect terminal
af architect --layout two-pane  # Side-by-side with utility shell

Additional Improvements

• File browser enhancements: Shows .env files and .builders directory
• Auto-reload viewers: File and 3D viewers refresh when content changes
• Port conflict detection: Clear error messages when ports are in use
• Orphan cleanup: af stop now detects and kills orphaned processes
• Version mismatch warnings: Alerts when local/remote versions differ

Bug Fixes (v1.5.3 - v1.5.8)

Multiple fixes for remote mode reliability:

• Fixed session rename timing with tmux
• Fixed dashboard port display when already running
• Fixed builder tab routing in remote mode
• Added annotation proxy for remote file viewing
• Improved SSH error messages

Install / Update

# Fresh install
npm install -g @cluesmith/codev

# Update existing
npm update -g @cluesmith/codev

Full Changelog

• v1.5.8 Release Notes
• v1.5.2 Release Notes

---

Florence represents a major step forward for Codev - enabling remote collaboration and expanding support for CAD/3D printing workflows. We'd love to hear how you're using these features!