Nanocoder v1.16.x to v1.17.0

We're excited to share an overview of the recent Nanocoder releases, from the v1.16.x series through to v1.17.0. These releases represent huge community contributions, bug fixes, and significant new capabilities that make Nanocoder more powerful and user-friendly than ever.

v1.16.0: The /usage Command and Better Tool Handling

The v1.16.0 release introduced a much-requested feature: the /usage command. Thanks to @spinualexandru, users can now visually monitor their model's context usage directly in the CLI. This closes issue #12 and gives developers better insight into how much of their context window is being consumed during sessions.

This release also expanded the model recommendations database with new models and fixed an important issue where models would occasionally request permission to call non-existent tools. The system now properly errors and loops back to allow the model to self-correct.

v1.16.1: Quick Patch for Installation

A swift patch release addressed installation failures caused by a postinstall hook that referenced a missing scripts directory. The fix moved models.dev data fetching from installation time to first use, making installations smoother across all platforms.

v1.16.2: Stability and Output Management

This release focused on stability improvements:

Empty response handling: Models returning empty responses after tool execution are now automatically reprompted
False positive prevention: HTML tags in responses no longer trigger incorrect tool call detection errors
Output limits: search_files results capped at 10 (down from 50) and execute_bash output truncated to 2,000 characters to prevent context overflow

v1.16.3: A Complete Tool System Overhaul

Version 1.16.3 brought substantial changes to how Nanocoder handles file operations and searching:

Out with the old:

Removed read_many_files (rarely used over read_file)
Removed search_files (models found it confusing)

In with the new:

find_files: Pattern-based file and directory discovery
search_file_contents: Content-aware searching with metadata
Revised read_file: Now reveals progressive information, returning metadata first with optional line ranges for specific content

These changes were designed specifically to help smaller models like Qwen 3 Coder 30B perform better by reducing context rot through more purposeful tool calls.

Additional fixes included:

Update checker rendering (previously appeared perpetually stuck)
Proper XDG config path handling (~/.config/nanocoder/)
Numerous edge-case fixes in the markdown parser
Removal of message display limits (the optimised queue can now handle full session history)

v1.16.4: Platform Improvements and New Theme

A community-driven release with several quality-of-life improvements:

Config/data separation: Clear distinction between configuration and application data directories (thanks @bowmanjd)
Smart update detection: The update checker now auto-detects your installation method (npm, Homebrew, Nix) and provides appropriate update instructions (thanks @fabriziosalmi)
Dracula theme: A new dark theme option for Dracula enthusiasts
VSCode Terminal fixes: Creating new lines and paste detection now work correctly in VSCode's integrated terminal
Better autocomplete: Command autocomplete now selects the top suggestion rather than waiting for a single remaining option

v1.16.5: Cleanup and Nix Fixes

The final patch in the 1.16.x series focused on refinement:

/init command no longer generates agents.config.json (aligning with new configuration patterns)
Code refactoring to reduce duplication (thanks @JimStenstrom)
Critical fix for broken Nix installation (thanks @Thomashighbaugh)

v1.17.0: VS Code Extension and MCP Overhaul

The v1.17.0 release marks a significant milestone for Nanocoder with two major features:

VS Code Extension v1

Nanocoder now ships with an official VS Code extension featuring:

Live code diffs: See changes as they're proposed
Diagnostics integration: LSP support for language-aware feedback
Seamless workflow: Work with Nanocoder directly in your editor

This is version 1 of the extension with plenty of room for expansion and improvement based on community feedback.

MCP Configuration Redesign

Thanks to the extensive work by @Avtrkrb, the MCP (Model Context Protocol) system received a complete overhaul:

Tab-based UI: Redesigned MCP configuration screens using a clean tab layout
Remote MCP support: Added support for remote MCP servers alongside stdio servers
GitHub Remote MCP: New template with Auth header configuration
Expanded templates: Additional MCP server templates for common use cases
Better sequencing: Configuration wizard now follows a logical stdio -> remote flow

Additional Improvements

Global configuration now properly loads when local/project configuration is missing
Preflight checks and test improvements
Documentation updates for new MCP fields

Thank You to Our Contributors

These releases wouldn't be possible without our amazing community. Special thanks to:

@spinualexandru - /usage command implementation
@bowmanjd - Config/data directory separation and XDG path fixes
@fabriziosalmi - Smart update detection
@Avtrkrb - MCP configuration overhaul
@JimStenstrom - Code refactoring
@Thomashighbaugh - Nix installation fixes

Get Started

Update to the latest version using your preferred method:

# npm
npm update -g @nanocollective/nanocoder

# Homebrew
brew update && brew upgrade nanocoder

# Nix
nix profile upgrade nanocoder

If you encounter any problems or have feedback, please drop an issue on GitHub or message us through Discord.

Thank you for using Nanocoder!