@latentforce/shift 1.0.5 → 1.0.6

package/README.md

@@ -1,9 +1,6 @@
 # @latentforce/shift
 
-A CLI and MCP server for AI-powered code intelligence. It provides:
-
-1. **CLI commands** - Index and manage your project
-2. **MCP server** - Expose tools (blast_radius, dependencies, file_summary) to Claude Desktop/Code
+AI-powered code intelligence CLI and MCP server for Claude.
 
 ## Installation
 
@@ -13,191 +10,77 @@ npm install -g @latentforce/shift
 
 ## Quick Start
 
-### Step 1: Configure backend URLs (if using hosted service)
-
-If you're connecting to a hosted Shift backend (not localhost), configure the URLs first:
-
-```bash
-shift config set api-url https://dev-shift-lite.latentforce.ai
-shift config set orch-url https://agent-orch.latentforce.ai
-shift config set ws-url wss://agent-orch.latentforce.ai
-```
-
-### Step 2: Start and configure your project
+### 1. Initialize your project
 
 ```bash
 cd /path/to/your/project
-shift start
+shift-cli start    # Configure API key and project
+shift-cli init     # Index project files
 ```
 
-This will:
-- Prompt for your Shift API key or let you continue as guest
-- Let you select or enter your project ID
-- Start a background daemon that connects to the backend
-
-### Step 3: Index your project
+### 2. Add to Claude Code
 
 ```bash
-shift init
+claude mcp add-json shift '{"type":"stdio","command":"shift-cli","args":["mcp"],"env":{"SHIFT_PROJECT_ID":"YOUR_PROJECT_ID"}}'
 ```
 
-This scans your project files and sends the structure to the backend for indexing.
-
-### Step 4: Configure MCP for Claude
-
-Now Claude can use the MCP tools. See [Claude Desktop setup](#claude-desktop-setup) or [Claude Code setup](#claude-code-setup) below.
-
-## CLI Commands
-
-| Command | Description |
-|---------|-------------|
-| `shift start` | Start the daemon and configure the project |
-| `shift init` | Scan and index project files to backend |
-| `shift stop` | Stop the running daemon |
-| `shift status` | Show current status (API key, project, daemon, connection) |
-| `shift config` | Show/set configuration (URLs, API key) |
-| `shift` or `shift mcp` | Start MCP server on stdio (used by Claude) |
-
-## Authentication
-
-When running `shift start` or `shift init`, you'll be prompted to choose:
-
-1. **API Key** - Enter your Shift API key for full access
-2. **Guest Mode** - Continue without an API key (limited features)
-
-Both options work with all CLI commands. Your choice is saved to `~/.shift/config.json`.
-
-## MCP Tools
-
-The MCP server exposes these tools to Claude:
-
-| Tool | Description |
-|------|-------------|
-| `blast_radius` | Analyze what would be affected if a file is modified |
-| `dependencies` | Get all dependencies for a file (direct and transitive) |
-| `file_summary` | Generate a summary of a file with optional parent context |
-
-## Configuration
-
-### Using the Config Command (Recommended for Global Install)
-
-The easiest way to configure Shift after installing globally with `npm i -g @latentforce/shift`:
+Or using npx:
 
 ```bash
-# Show current configuration
-shift config
-
-# Set backend URLs
-shift config set api-url https://dev-shift-lite.latentforce.ai
-shift config set orch-url https://agent-orch.latentforce.ai
-shift config set ws-url wss://agent-orch.latentforce.ai
-
-# Set API key directly (alternative to interactive prompt)
-shift config set api-key your-api-key-here
-
-# Clear configuration
-shift config clear urls    # Reset URLs to defaults
-shift config clear         # Clear all config (prompts for confirmation)
+claude mcp add-json shift '{"type":"stdio","command":"npx","args":["@latentforce/shift","mcp"],"env":{"SHIFT_PROJECT_ID":"YOUR_PROJECT_ID"}}'
 ```
 
-Configuration is saved to `~/.shift/config.json`.
-
-### Using Environment Variables
-
-You can also set environment variables (they take priority over config file):
+### 3. Add to Claude Desktop
 
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `SHIFT_PROJECT_ID` | Default project UUID (MCP only) | - |
-| `SHIFT_BACKEND_URL` | Backend API URL (MCP only) | `http://127.0.0.1:9000` |
-
-Example using environment variables:
-
-```bash
-# Set for current session
-export SHIFT_API_URL=https://dev-shift-lite.latentforce.ai
-export SHIFT_ORCH_URL=https://agent-orch.latentforce.ai
-export SHIFT_WS_URL=wss://agent-orch.latentforce.ai
-
-# Or inline when running commands
-SHIFT_API_URL=https://dev-shift-lite.latentforce.ai shift start
-```
-
-### Priority Order
-
-URLs are resolved in this order:
-1. Environment variables (highest priority)
-2. Config file (`~/.shift/config.json`)
-3. Defaults (localhost)
-
-## Claude Code Setup
-
-### Add MCP Server
-
-```bash
-claude mcp add-json shift '{"type":"stdio","command":"shift","args":[],"env":{"SHIFT_PROJECT_ID":"YOUR_PROJECT_ID_HERE","SHIFT_BACKEND_URL":"https://dev-shift-lite.latentforce.ai"}}'
-```
-
-### Verify
-
-```bash
-claude mcp list
-```
-
-## Claude Desktop Setup
-
-### Config File Location
-
-| OS | Path |
-|----|------|
-| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| Linux | `~/.config/claude-desktop/claude_desktop_config.json` |
-| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
-
-### Configuration
-
-Add to your config file:
+Add to your config file (`%APPDATA%\Claude\claude_desktop_config.json` on Windows, `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
 
 ```json
 {
   "mcpServers": {
     "shift": {
-      "command": "shift",
+      "command": "shift-cli",
+      "args": ["mcp"],
       "env": {
-        "SHIFT_BACKEND_URL": "https://dev-shift-lite.latentforce.ai",
-        "SHIFT_PROJECT_ID": "YOUR_PROJECT_ID_HERE"
+        "SHIFT_PROJECT_ID": "YOUR_PROJECT_ID"
       }
     }
   }
 }
 ```
 
-Restart Claude Desktop after saving.
+## MCP Tools
 
-## Project ID
+| Tool | Description |
+|------|-------------|
+| `blast_radius` | Analyze what would be affected if a file is modified |
+| `dependencies` | Get all dependencies for a file |
+| `file_summary` | Generate a summary of a file |
 
-You can set the project ID in two ways:
+## CLI Commands
 
-1. **Environment variable**: Set `SHIFT_PROJECT_ID` in MCP config
-2. **Per-call override**: Pass `project_id` parameter in each tool call
+| Command | Description |
+|---------|-------------|
+| `shift-cli start` | Start daemon and configure project |
+| `shift-cli init` | Index project files |
+| `shift-cli stop` | Stop the daemon |
+| `shift-cli status` | Show current status |
+| `shift-cli config` | Manage configuration |
 
-This allows one MCP server to work with multiple projects.
+## Custom Backend URLs
 
-## Development
+**CLI** (set once globally):
 
 ```bash
-# Clone and install
-npm install
-
-# Build
-npm run build
+shift-cli config set api-url https://your-api.example.com
+shift-cli config set orch-url https://your-orch.example.com
+shift-cli config set ws-url wss://your-orch.example.com
+```
 
-# Run locally
-node build/index.js
+**MCP Server** (add to env in Claude config):
 
-# Test CLI commands
-node build/index.js start
-node build/index.js init
-node build/index.js status
-node build/index.js stop
+```json
+"env": {
+  "SHIFT_PROJECT_ID": "YOUR_PROJECT_ID",
+  "SHIFT_BACKEND_URL": "https://your-api.example.com"
+}
 ```

package/build/index.js

@@ -2,14 +2,21 @@
 import { Command } from 'commander';
 const program = new Command();
 program
-    .name('shift')
+    .name('shift-cli')
     .description('Shift CLI - AI-powered code intelligence')
-    .version('1.0.2');
+    .version('1.0.6');
 // MCP server mode (default when run via MCP host)
 program
     .command('mcp', { isDefault: true, hidden: true })
     .description('Start MCP server on stdio')
     .action(async () => {
+    // Check if 'mcp' was explicitly passed as argument
+    const mcpExplicitlyRequested = process.argv.includes('mcp');
+    // If running interactively (TTY) and mcp wasn't explicitly requested, show help
+    if (process.stdin.isTTY && !mcpExplicitlyRequested) {
+        program.outputHelp();
+        return;
+    }
     const { startMcpServer } = await import('./mcp-server.js');
     await startMcpServer();
 });

package/build/mcp-server.js

@@ -1,7 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from 'zod';
-const BASE_URL = process.env.SHIFT_BACKEND_URL || "http://127.0.0.1:9000";
+const BASE_URL = process.env.SHIFT_BACKEND_URL || "https://dev-shift-lite.latentforce.ai";
 function getProjectIdFromEnv() {
     const projectId = process.env.SHIFT_PROJECT_ID;
     if (!projectId || projectId.trim() === "") {

package/build/utils/config.js

@@ -10,9 +10,9 @@ const LOCAL_CONFIG_FILE = 'config.json'; // Changed from project.json to match e
 const DAEMON_PID_FILE = 'daemon.pid';
 const DAEMON_STATUS_FILE = 'daemon.status.json';
 // Default URLs
-const DEFAULT_API_URL = 'http://localhost:9000';
-const DEFAULT_ORCH_URL = 'http://localhost:9999';
-const DEFAULT_WS_URL = 'ws://localhost:9999';
+const DEFAULT_API_URL = 'https://dev-shift-lite.latentforce.ai';
+const DEFAULT_ORCH_URL = 'https://agent-orch.latentforce.ai';
+const DEFAULT_WS_URL = 'wss://agent-orch.latentforce.ai';
 // Helper to get URL from: 1) env var, 2) global config, 3) default
 function getConfiguredUrl(envVar, configKey, defaultUrl) {
     // Priority: Environment variable > Global config > Default

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@latentforce/shift",
-    "version": "1.0.5",
+    "version": "1.0.6",
     "description": "Shift CLI - AI-powered code intelligence with MCP support",
     "type": "module",
     "main": "./build/index.js",
@@ -8,7 +8,7 @@
         ".": "./build/index.js"
     },
     "bin": {
-        "shift": "./build/index.js"
+        "shift-cli": "./build/index.js"
     },
     "files": [
         "build"