v0.9.1: Remove global config feature

Global ~/.refdocs/ config was invisible to LLM agents working in local
projects, making it dead weight. All -g/--global flags, global config
functions, and global tests removed.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: christopherarter

README.md

@@ -41,12 +41,10 @@ The manifest (`.refdocs/manifest.json`) gives your agent a ~500 token map of all
 ```bash
 # Setup
 refdocs init                              # create .refdocs/config.json with defaults
-refdocs init -g                           # create global config at ~/.refdocs/
 
 # Add sources
 refdocs add ./docs                        # local directory
 refdocs add https://github.com/org/repo   # GitHub repo (downloads markdown files)
-refdocs add <source> -g                   # add to global ~/.refdocs/ store
 
 # Catalog
 refdocs manifest                          # generate the manifest
@@ -98,15 +96,6 @@ refdocs remove docs/laravel               # remove a path from config
 
 GitHub sources are tracked in `.refdocs/config.json` and can be re-pulled with `refdocs update`.
 
-## Global docs
-
-Use `-g` / `--global` to store docs in `~/.refdocs/` — useful for references you want across all projects.
-
-```bash
-refdocs init -g
-refdocs add https://github.com/org/docs -g
-```
-
 ## Configuration
 
 `.refdocs/config.json` at project root:

docs/cli-reference.md

@@ -1,6 +1,6 @@
 # CLI Reference
 
-## Global options
+## Options
 
 ```
 refdocs --help     Show help
@@ -15,18 +15,11 @@ Create a `.refdocs/config.json` config file with default settings.
 
 ```bash
 refdocs init
-refdocs init -g
 ```
 
-**Options:**
-
-| Flag | Description |
-|------|-------------|
-| `-g, --global` | Create global config at `~/.refdocs/` |
-
 **Behavior:**
 
-- Creates `.refdocs/config.json` in the current directory (or `~/.refdocs/config.json` with `-g`)
+- Creates `.refdocs/config.json` in the current directory
 - Includes all default values: `paths`, `manifest`
 - If `.refdocs/config.json` already exists, exits with an error
 
@@ -40,15 +33,8 @@ Generate the documentation manifest from all markdown files in configured paths.
 
 ```bash
 refdocs manifest
-refdocs manifest -g
 ```
 
-**Options:**
-
-| Flag | Description |
-|------|-------------|
-| `-g, --global` | Generate manifest for global config |
-
 **Output:**
 
 ```
@@ -71,15 +57,8 @@ List all documented files and their heading counts.
 
 ```bash
 refdocs list
-refdocs list -g
 ```
 
-**Options:**
-
-| Flag | Description |
-|------|-------------|
-| `-g, --global` | List global documented files |
-
 **Output:**
 
 ```
@@ -110,9 +89,6 @@ refdocs add ./my-docs --no-manifest
 refdocs add https://github.com/laravel/docs --branch 11.x
 refdocs add https://github.com/statamic/docs/tree/6.x/content
 refdocs add https://github.com/owner/repo --path docs/custom --no-manifest
-
-# Global
-refdocs add https://github.com/org/docs -g
 ```
 
 **Arguments:**
@@ -128,7 +104,6 @@ refdocs add https://github.com/org/docs -g
 | `--path <dir>` | `docs/{owner}/{repo}` | Override local storage directory (GitHub URLs only) |
 | `--branch <branch>` | from URL or `HEAD` | Override branch detection (GitHub URLs only) |
 | `--no-manifest` | `false` | Skip auto manifest generation after adding |
-| `-g, --global` | `false` | Store docs in global `~/.refdocs/` directory |
 
 **Local paths:**
 
@@ -174,7 +149,6 @@ Remove a path from the configuration.
 ```bash
 refdocs remove docs/laravel
 refdocs remove ./my-docs --no-manifest
-refdocs remove docs/laravel -g
 ```
 
 **Arguments:**
@@ -188,7 +162,6 @@ refdocs remove docs/laravel -g
 | Flag | Default | Description |
 |------|---------|-------------|
 | `--no-manifest` | `false` | Skip auto manifest generation after removal |
-| `-g, --global` | `false` | Remove from global config |
 
 **Behavior:**
 
@@ -210,15 +183,13 @@ Re-pull all tracked sources from GitHub and regenerate the manifest.
 ```bash
 refdocs update
 refdocs update --no-manifest
-refdocs update -g
 ```
 
 **Options:**
 
 | Flag | Default | Description |
 |------|---------|-------------|
 | `--no-manifest` | `false` | Skip auto manifest generation after update |
-| `-g, --global` | `false` | Update global sources |
 
 **Output:**
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamik-dev/refdocs",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "type": "module",
   "description": "Local CLI tool that fetches, organizes, and catalogs markdown documentation for LLM-assisted development",
   "main": "dist/index.js",

package.json

@@ -1,6 +1,5 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
 import { join, dirname, resolve } from "node:path";
-import { homedir } from "node:os";
 import type { RefdocsConfig } from "./types.js";
 
 export const CONFIG_DIR_NAME = ".refdocs";
@@ -108,32 +107,3 @@ export function saveConfig(config: Partial<RefdocsConfig>, configDir: string): v
   const merged = { ...existing, ...config };
   writeFileSync(configPath, JSON.stringify(merged, null, 2) + "\n", "utf-8");
 }
-
-export function getGlobalConfigDir(globalDir?: string): string {
-  return globalDir ?? join(homedir(), ".refdocs");
-}
-
-export function initGlobalConfig(globalDir?: string): void {
-  const dir = getGlobalConfigDir(globalDir);
-  mkdirSync(dir, { recursive: true });
-  const configPath = join(dir, CONFIG_FILENAME);
-  if (existsSync(configPath)) return;
-  writeFileSync(configPath, JSON.stringify(DEFAULT_CONFIG, null, 2) + "\n", "utf-8");
-}
-
-export function loadGlobalConfig(globalDir?: string): ConfigResult | null {
-  const dir = getGlobalConfigDir(globalDir);
-  const configPath = join(dir, CONFIG_FILENAME);
-  if (!existsSync(configPath)) return null;
-  try {
-    const raw = JSON.parse(readFileSync(configPath, "utf-8"));
-    const errors = validateConfig(raw);
-    if (errors.length > 0) return null;
-    return {
-      config: mergeWithDefaults(raw),
-      configDir: dir,
-    };
-  } catch {
-    return null;
-  }
-}