@nanocollective/nanocoder 1.14.2 → 1.14.3

package/README.md

@@ -8,7 +8,7 @@ A local-first CLI coding agent that brings the power of agentic coding tools lik
 
 - [FAQs](#faqs)
 - [Installation](#installation)
-  - [For Users (Recommended)](#for-users-recommended)
+  - [For Users](#for-users)
   - [For Development](#for-development)
 - [Configuration](#configuration)
   - [AI Provider Setup](#ai-provider-setup)
@@ -45,7 +45,9 @@ Firstly, we would love for you to be involved. You can get started contributing
 
 ## Installation
 
-### For Users (Recommended)
+### For Users
+
+#### NPM (Recommended)
 
 Install globally and use anywhere:
 
@@ -59,6 +61,39 @@ Then run in any directory:
 nanocoder
 ```
 
+#### Nix Flakes
+
+Run Nanocoder directly using:
+
+```bash
+# If you have flakes enabled in your Nix config:
+nix run github:Nano-Collective/nanocoder
+
+# If you don't have flakes enabled:
+nix run --extra-experimental-features 'nix-command flakes' github:Nano-Collective/nanocoder
+```
+
+Or install from `packages` output:
+
+```nix
+# flake.nix
+{
+  inputs = {
+    nanocoder = {
+      url = "github:Nano-Collective/nanocoder";
+      inputs.nixpkgs.follows = "nixpkgs";
+    };
+  };
+}
+
+# configuration.nix
+{ pkgs, inputs, system, ... }: {
+  environment.systemPackages = [
+    inputs.nanocoder.packages."${system}".default
+  ];
+}
+```
+
 ### For Development
 
 If you want to contribute or modify Nanocoder:
@@ -100,7 +135,35 @@ npm run dev
 
 ### AI Provider Setup
 
-Nanocoder supports any OpenAI-compatible API through a unified provider configuration. Create `agents.config.json` in your **working directory** (where you run `nanocoder`):
+Nanocoder supports any OpenAI-compatible API through a unified provider configuration.
+
+**Configuration Methods:**
+
+1. **Interactive Setup (Recommended for new users)**: Run `/setup-config` inside Nanocoder for a guided wizard with provider templates
+2. **Manual Configuration**: Create an `agents.config.json` file (see below for locations)
+
+**Configuration File Locations:**
+
+Nanocoder looks for configuration in the following order (first found wins):
+
+1. **Project-level** (highest priority): `agents.config.json` in your current working directory
+
+   - Use this for project-specific providers, models, or API keys
+   - Perfect for team sharing or repository-specific configurations
+
+2. **User-level (preferred)**: Platform-specific application data directory
+
+   - **macOS**: `~/Library/Preferences/nanocoder/agents.config.json`
+   - **Linux/Unix**: `~/.config/nanocoder/agents.config.json`
+   - **Windows**: `%APPDATA%\nanocoder\agents.config.json`
+   - Your global default configuration
+   - Used when no project-level config exists
+
+3. **User-level (legacy)**: `~/.agents.config.json`
+   - Supported for backward compatibility
+   - Recommended to migrate to platform-specific location above
+
+**Example Configuration** (`agents.config.json`):
 
 ```json
 {
@@ -277,11 +340,22 @@ Popular MCP servers:
 - **Memory**: Persistent context storage
 - [View more MCP servers](https://github.com/modelcontextprotocol/servers)
 
-> **Note**: The default save place for configuration is `~/config/nanocoder/`. You can also place an `agents.config.json` where you run Nanocoder. This will **override** the default for project-by-project configuration with different models or API keys per repository.
+> **Note**: MCP server configuration follows the same location hierarchy as AI provider setup above. Use `/setup-config` for an interactive configuration wizard, or manually edit `agents.config.json` at the project level (current directory) or user level (platform-specific paths listed above).
 
 ### User Preferences
 
-Nanocoder automatically saves your preferences to remember your choices across sessions. Preferences are stored in `~/config/nanocoder/nanocoder-preferences.json`. You can also place a `nanocoder-preferences.json` where you run Nanocoder. This will **override** the default for project-by-project configuration.
+Nanocoder automatically saves your preferences to remember your choices across sessions.
+
+**Preferences File Locations:**
+
+Preferences follow the same location hierarchy as configuration files:
+
+1. **Project-level**: `nanocoder-preferences.json` in your current working directory (overrides user-level)
+2. **User-level**: Platform-specific application data directory:
+   - **macOS**: `~/Library/Preferences/nanocoder/nanocoder-preferences.json`
+   - **Linux/Unix**: `~/.config/nanocoder/nanocoder-preferences.json`
+   - **Windows**: `%APPDATA%\nanocoder\nanocoder-preferences.json`
+3. **Legacy**: `~/.nanocoder-preferences.json` (backward compatibility)
 
 **What gets saved automatically:**
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@nanocollective/nanocoder",
 	"main": "dist/cli.js",
-	"version": "1.14.2",
+	"version": "1.14.3",
 	"description": "A local-first CLI coding agent that brings the power of agentic coding tools like Claude Code and Gemini CLI to local models or controlled APIs like OpenRouter",
 	"keywords": [
 		"cli",
@@ -54,7 +54,7 @@
 		"@langchain/openai": "^0.6.15",
 		"@mishieck/ink-titled-box": "^0.3.0",
 		"@modelcontextprotocol/sdk": "^1.17.3",
-		"@nanocollective/get-md": "^1.0.0",
+		"@nanocollective/get-md": "^1.0.1",
 		"cheerio": "^1.1.2",
 		"cli-highlight": "^2.1.11",
 		"dotenv": "^17.2.3",