coder-config 0.40.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 regression.io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,553 @@
+# Coder Config
+
+Configuration manager for AI coding tools — **Claude Code**, **Gemini CLI**, **Codex CLI**, and **Antigravity**. Manage MCPs, rules, permissions, memory, and workstreams through a visual UI or CLI.
+
+> **Migration note:** This package was renamed from `@regression-io/claude-config` to `coder-config`. The `claude-config` command still works as an alias.
+
+## Why?
+
+One tool to configure all your AI coding assistants:
+
+| | |
+|---|---|
+| **MCP Servers** | Configure without editing JSON/TOML files |
+| **Permissions** | Visual editor for allow/deny rules |
+| **Multi-Tool** | Claude Code, Gemini CLI, Codex CLI, Antigravity |
+| **Rules & Commands** | Manage project-specific guidelines |
+| **Memory** | Persistent context across sessions |
+| **Workstreams** | Group projects with shared context |
+
+## Installation
+
+```bash
+npm install -g coder-config
+```
+
+Requires Node.js 18+.
+
+> **Migrating from @regression-io/claude-config?**
+> ```bash
+> npm uninstall -g @regression-io/claude-config
+> npm install -g coder-config
+> ```
+> Your settings in `~/.claude-config/` are preserved automatically.
+
+## Quick Start
+
+```bash
+# 1. Install
+npm install -g coder-config
+
+# 2. Set up auto-start (recommended)
+coder-config ui install
+
+# 3. Open the UI
+open http://localhost:3333
+```
+
+The server starts automatically on login. Install as a PWA from your browser for app-like access.
+
+### Updating
+
+```bash
+coder-config update
+# Then restart: coder-config ui stop && coder-config ui
+```
+
+### CLI Alternative
+
+```bash
+# Initialize a project
+coder-config init
+
+# Add MCPs to your project
+coder-config add postgres github
+
+# Generate .mcp.json for Claude Code
+coder-config apply
+```
+
+## CLI Commands
+
+Both `coder-config` and `claude-config` work identically.
+
+### Project Commands
+
+```bash
+coder-config init                        # Initialize project
+coder-config apply                       # Generate .mcp.json from config
+coder-config show                        # Show current project config
+coder-config list                        # List available MCPs (✓ = active)
+coder-config add <mcp> [mcp...]          # Add MCP(s) to project
+coder-config remove <mcp> [mcp...]       # Remove MCP(s) from project
+```
+
+### Memory Commands
+
+```bash
+coder-config memory                         # Show memory status
+coder-config memory init                    # Initialize project memory
+coder-config memory add <type> "<content>"  # Add entry
+coder-config memory search <query>          # Search all memory
+
+# Types: preference, correction, fact (global)
+#        context, pattern, decision, issue, history (project)
+```
+
+### Environment Commands
+
+```bash
+coder-config env                    # List environment variables
+coder-config env set <KEY> <value>  # Set variable in .claude/.env
+coder-config env unset <KEY>        # Remove variable
+```
+
+### Project Commands
+
+```bash
+coder-config project                      # List registered projects
+coder-config project add [path]           # Add project (defaults to cwd)
+coder-config project add [path] --name X  # Add with custom display name
+coder-config project remove <name|path>   # Remove from registry
+```
+
+### Workstream Commands
+
+```bash
+coder-config workstream                   # List all workstreams
+coder-config workstream create "Name"     # Create new workstream
+coder-config workstream delete <name>     # Delete workstream
+coder-config workstream use <name>        # Activate workstream (this terminal)
+coder-config workstream active            # Show current active workstream
+coder-config workstream deactivate        # Deactivate workstream (this terminal)
+coder-config workstream add <ws> <path>   # Add project to workstream
+coder-config workstream remove <ws> <path>  # Remove project from workstream
+coder-config workstream inject [--silent] # Output restriction + context (for hooks)
+coder-config workstream detect [path]     # Detect workstream for directory
+coder-config workstream check-path <path> # Check if path is within workstream (exit 0/1)
+coder-config workstream install-hook      # Install hook for Claude Code
+coder-config workstream install-hook --gemini  # Install hook for Gemini CLI
+coder-config workstream install-hook --codex   # Install hook for Codex CLI
+coder-config workstream install-hook --all     # Install hooks for all supported tools
+```
+
+**Per-terminal isolation**: With [shell integration](#shell-integration), each terminal can have its own active workstream:
+```bash
+# Terminal 1
+coder-config workstream use project-a
+
+# Terminal 2
+coder-config workstream use project-b
+```
+
+When active, the AI receives a restriction telling it to only work within the workstream's directories.
+
+**Multi-tool support**: Workstreams work with Claude Code, Gemini CLI, and Codex CLI. Install hooks for your preferred tool(s):
+```bash
+# For Claude Code only
+coder-config workstream install-hook
+
+# For Gemini CLI only
+coder-config workstream install-hook --gemini
+
+# For Codex CLI only
+coder-config workstream install-hook --codex
+
+# For all supported tools
+coder-config workstream install-hook --all
+```
+
+### Registry Commands
+
+```bash
+coder-config registry                       # List MCPs in global registry
+coder-config registry add <name> '<json>'   # Add MCP to global registry
+coder-config registry remove <name>         # Remove MCP from registry
+```
+
+### Updates
+
+```bash
+coder-config update             # Check npm and install updates if available
+coder-config update --check     # Check for updates without installing
+coder-config update /path/src   # Update from local development source
+```
+
+The UI also checks for updates automatically and shows a notification when a new version is available.
+
+### Web UI
+
+```bash
+coder-config ui                    # Start UI on port 3333
+coder-config ui --port 8080        # Custom port
+coder-config ui /path/to/project   # Specific project directory
+coder-config ui --foreground       # Run in foreground (blocking)
+coder-config ui status             # Check if daemon is running
+coder-config ui stop               # Stop the daemon
+
+# Auto-start on login (macOS)
+coder-config ui install            # Install LaunchAgent for auto-start
+coder-config ui uninstall          # Remove auto-start
+```
+
+**Daemon Mode**: By default, `coder-config ui` runs as a background daemon.
+The UI runs from your home directory and persists across terminal sessions.
+Switch between registered projects using the dropdown in the header.
+
+**PWA / Auto-Start**: Install the UI as a PWA in your browser, then run `coder-config ui install`
+to have the server start automatically on login. Your PWA will always connect instantly.
+
+## Shell Integration
+
+For full functionality, add to `~/.zshrc`:
+
+```bash
+source /path/to/coder-config/shell/claude-config.zsh
+```
+
+This enables:
+- **Per-terminal workstreams** - `workstream use` activates for current terminal only
+- Auto-generates `.mcp.json` when entering a project with `.claude/mcps.json`
+- Tab completion for all commands
+
+## Configuration Hierarchy
+
+Settings merge from global to project to sub-project:
+
+```
+~/.claude/mcps.json                    # Global - applies everywhere
+~/projects/.claude/mcps.json           # Workspace - applies to projects here
+~/projects/my-app/.claude/             # Project - specific to this project
+~/projects/my-app/server/.claude/      # Sub-project - inherits from parent
+```
+
+Sub-projects are automatically detected (folders with `.git`), or you can manually link any folder using "Add Sub-project" in the Web UI.
+
+## Project Structure
+
+After `coder-config init`:
+
+```
+your-project/
+├── .claude/
+│   ├── mcps.json       # MCP configuration
+│   ├── settings.json   # Claude Code settings
+│   ├── rules/          # Project rules (*.md)
+│   └── commands/       # Custom commands (*.md)
+└── .mcp.json           # Generated - Claude Code reads this
+```
+
+## MCP Configuration
+
+`.claude/mcps.json`:
+
+```json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+Environment variables use `${VAR}` syntax and load from `.claude/.env`.
+
+## Memory System
+
+Persistent memory for Claude Code sessions.
+
+**Global** (`~/.claude/memory/`)
+
+| File | Purpose |
+|------|---------|
+| `preferences.md` | User preferences and style |
+| `corrections.md` | Mistakes to avoid |
+| `facts.md` | Environment facts |
+
+**Project** (`<project>/.claude/memory/`)
+
+| File | Purpose |
+|------|---------|
+| `context.md` | Project overview |
+| `patterns.md` | Code patterns |
+| `decisions.md` | Architecture decisions |
+| `issues.md` | Known issues |
+| `history.md` | Session history |
+
+Manage via Web UI or edit files directly.
+
+## Workstreams
+
+Workstreams are **context sets** for multi-project workflows. They group related projects and inject context rules into every Claude session.
+
+### Why Workstreams?
+
+When working on complex features that span multiple repos (e.g., REST API + UI + shared library), you need Claude to understand the broader context. Workstreams solve this by:
+
+1. Grouping related projects together
+2. Defining rules specific to that workflow
+3. Automatically injecting those rules into every Claude session
+
+### Example
+
+```bash
+# Create a workstream for user authentication feature
+coder-config workstream create "User Auth"
+
+# Add related projects
+coder-config workstream add "User Auth" ~/projects/api
+coder-config workstream add "User Auth" ~/projects/ui
+coder-config workstream add "User Auth" ~/projects/shared
+
+# Activate it
+coder-config workstream use "User Auth"
+```
+
+Then in the Web UI, edit the workstream to add rules like:
+> Focus on user authentication flow. Use JWT tokens. React Query for state management. PostgreSQL for persistence.
+
+### Hook Integration
+
+For rules to be injected automatically, install the pre-prompt hook:
+
+**Option 1: One-click install (recommended)**
+- Open Web UI → Workstreams → Click "Install Hook Automatically"
+
+**Option 2: Manual**
+```bash
+# Add to ~/.claude/hooks/pre-prompt.sh
+coder-config workstream inject --silent
+```
+
+Once installed, your active workstream's rules are prepended to every Claude session.
+
+### Activity Tracking & Suggestions
+
+Coder-config can track which files you work on and suggest workstreams based on patterns:
+
+**How it works:**
+1. A post-response hook logs file paths accessed during Claude sessions
+2. Co-activity patterns are detected (projects frequently worked on together)
+3. Workstream suggestions appear in the UI based on these patterns
+
+**Setup (optional):**
+```bash
+# Install the activity tracking hook
+# Add to ~/.claude/hooks/post-response.sh:
+source /path/to/coder-config/hooks/activity-track.sh
+```
+
+**In the Web UI:**
+- Activity Insights panel shows sessions, files tracked, and active projects
+- Suggested Workstreams appear when patterns are detected
+- Click "Create" to open pre-filled dialog (tweak projects as needed)
+- Click "X" to dismiss suggestions you don't want
+
+## Web UI Features
+
+| Feature | Description |
+|---------|-------------|
+| **Project Explorer** | Browse and edit `.claude/` folders across your project hierarchy |
+| **Claude Code Settings** | Visual editor for permissions, model, hooks, and behavior |
+| **Gemini CLI Settings** | Configure model, display options, and sandbox mode |
+| **Codex CLI Settings** | Configure model, security, MCP servers, and features |
+| **Antigravity Settings** | Configure security policies, browser allowlist, and agent mode |
+| **MCP Registry** | Search GitHub/npm, add and configure MCP servers |
+| **Plugins** | Browse marketplaces, install plugins with scope control |
+| **Memory** | Manage preferences, corrections, patterns, and decisions |
+| **Workstreams** | Group related projects with shared context rules |
+
+Additional features: project/workstream switchers in header, sub-project detection, dark mode, auto-updates.
+
+## Plugins
+
+Claude Code plugins extend functionality with LSP servers, MCP servers, commands, and always-on guidance. **Plugins replace templates** - instead of static files that can become stale, plugins are always active and update automatically.
+
+### Why Plugins Over Templates?
+
+| Aspect | Plugins |
+|--------|---------|
+| Delivery | Enable plugin once |
+| Updates | Auto-refresh from marketplace |
+| Freshness | Always current |
+| Scope | Global, project, or local |
+| Discovery | Browse marketplaces |
+
+### Installing Plugins
+
+**From CLI:**
+```bash
+# Add the coder-config plugins marketplace
+claude plugin marketplace add regression-io/claude-config-plugins
+
+# Install framework-specific plugins
+claude plugin install fastapi-support@claude-config-plugins
+claude plugin install react-typescript@claude-config-plugins
+claude plugin install python-support@claude-config-plugins
+```
+
+**From Web UI:**
+1. Open Project Explorer
+2. Click the **+** menu on any project folder
+3. Select **Install Plugins**
+4. Toggle plugins on/off with scope selection (Project/Global/Local)
+
+### Plugin Directory
+
+The **Plugins** page shows all available plugins:
+- Filter by marketplace, category, source type (Anthropic/Community), installed status
+- Search by name or description
+- View plugin details (LSP/MCP/Commands included)
+
+### Marketplaces
+
+Plugins come from marketplaces (Git repositories):
+- **claude-plugins-official** - Anthropic's official plugins
+- **regression-io/claude-config-plugins** - Framework and language plugins
+- Add community marketplaces via "Manage Marketplaces" in the filter dropdown
+
+Supported marketplace formats:
+- `owner/repo` — GitHub shorthand
+- `https://github.com/owner/repo` — Full URL
+- `/local/path` — Local directory
+
+## Claude Code Settings
+
+The Web UI provides a visual editor for `~/.claude/settings.json`:
+
+### Permissions
+Configure what Claude Code can do automatically:
+- **Allow** - Tools that run without asking
+- **Ask** - Tools that require confirmation
+- **Deny** - Tools that are blocked
+
+Pattern examples:
+```
+Bash(npm run build)      # Specific command
+Bash(npm:*)              # Prefix match (npm anything)
+Read(**)                 # All file reads
+Edit(src/**)             # Edit files in src/
+mcp__github__*           # All GitHub MCP tools
+```
+
+### Model Selection
+Choose your preferred Claude model (Sonnet 4, Opus 4.5, etc.)
+
+### Behavior
+- Auto-accept edits
+- Verbose mode
+- Enable/disable MCP servers
+
+## Gemini CLI Settings
+
+The Web UI provides a visual editor for `~/.gemini/settings.json`:
+
+### Model Selection
+Choose Gemini model (2.5 Pro, 2.5 Flash, etc.) and enable preview features.
+
+### Display Options
+Configure theme, token count display, diff view, and streaming.
+
+### General Settings
+- Vim keybindings
+- Auto-save
+- Check for updates
+
+### Sandbox Mode
+Control command execution safety (enabled/disabled).
+
+## Codex CLI Settings
+
+The Web UI provides a visual editor for `~/.codex/config.toml`:
+
+### Model Settings
+- **Model** - Select GPT-5.2 Codex, GPT-5, o3-mini, etc.
+- **Reasoning Effort** - Control thoroughness (minimal to xhigh)
+
+### Security
+- **Approval Policy** - When to ask for command approval (on-request, untrusted, on-failure, never)
+- **Sandbox Mode** - Filesystem access level (read-only, workspace-write, full-access)
+
+### MCP Servers
+Configure MCP servers for Codex CLI with the same format as other tools.
+
+### Features
+Toggle feature flags like shell snapshots and web search.
+
+### Display & History
+Configure TUI animations, notifications, and session history persistence.
+
+For full configuration options, see [Codex CLI docs](https://developers.openai.com/codex/config-reference/).
+
+## Antigravity Settings
+
+The Web UI provides a visual editor for `~/.gemini/antigravity/settings.json`:
+
+### Security Policies
+| Policy | Options |
+|--------|---------|
+| **Terminal Execution** | Off, Auto, Turbo |
+| **Code Review** | Enabled, Disabled |
+| **JS Execution** | Sandboxed, Direct |
+
+### MCP Servers
+Configure MCP servers for Antigravity. Note: Antigravity does NOT support `${VAR}` interpolation - variables are resolved to actual values.
+
+### Browser Allowlist
+Control which URLs Antigravity can access during sessions.
+
+### Agent Mode
+Configure autonomous multi-step operations, iteration limits, and confirmation requirements.
+
+## Preferences
+
+User settings stored in `~/.claude-config/config.json`:
+
+```json
+{
+  "toolsDir": "~/mcp-tools",
+  "registryPath": "~/.claude/registry.json",
+  "ui": {
+    "port": 3333,
+    "openBrowser": true
+  }
+}
+```
+
+| Key | Description |
+|-----|-------------|
+| `toolsDir` | Directory for local MCP tools |
+| `registryPath` | Path to custom MCP registry |
+| `ui.port` | Default port for web UI |
+| `ui.openBrowser` | Auto-open browser on `coder-config ui` |
+
+## Requirements
+
+- Node.js 18+
+- Build tools (for newer Node.js versions without prebuilt binaries):
+  - **macOS**: Xcode Command Line Tools (`xcode-select --install`)
+  - **Linux**: `build-essential` package
+  - **Windows**: Visual Studio Build Tools
+
+## Development
+
+```bash
+git clone https://github.com/regression-io/claude-config.git
+cd claude-config
+npm install
+npm run build
+npm start
+```
+
+## License
+
+MIT