claude-threads 0.12.1 → 0.13.0

package/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.13.0] - 2025-12-29
+
+### Added
+- **`--setup` flag** - Re-run interactive setup wizard to reconfigure settings
+  - Existing .env values are used as defaults (press Enter to keep)
+  - Token field allows keeping existing token without re-entering
+  - New settings added since initial setup are presented with built-in defaults
+  - Config saved back to original location
+- **Chrome and worktree settings in onboarding** - New setup prompts for:
+  - Chrome integration (yes/no)
+  - Git worktree mode (prompt/off/require)
+
+### Changed
+- **Improved README** - New tagline and improved intro section
+- **Worktree documentation** - Added comprehensive Git Worktrees section to README
+- **Updated CLI options** - Added `--chrome`, `--no-chrome`, `--worktree-mode`, `--setup` to README
+
+### Fixed
+- **Warning icon alignment** - Fixed spacing of ⚠️ icon in CLI startup output
+- **WORKTREE_MODE documentation** - Fixed incorrect values in README (was `always`/`never`, now correctly `off`/`prompt`/`require`)
+
 ## [0.12.1] - 2025-12-29
 
 ### Fixed

package/README.md

@@ -9,7 +9,9 @@
 [![npm version](https://img.shields.io/npm/v/claude-threads.svg)](https://www.npmjs.com/package/claude-threads)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Share Claude Code sessions live in a Mattermost channel. Your colleagues can watch you work with Claude in real-time, collaborate on sessions, and even trigger their own sessions from Mattermost.
+**Bring Claude Code to your team.** Run Claude Code on your machine, share it live in Mattermost. Colleagues can watch, collaborate, and run their own sessions—all from chat.
+
+> 💡 *Think of it as screen-sharing for AI pair programming, but everyone can type.*
 
 ## Features
 
@@ -101,16 +103,20 @@ In Mattermost, mention the bot:
 claude-threads [options]
 
 Options:
-  --url <url>            Mattermost server URL
-  --token <token>        Bot token
-  --channel <id>         Channel ID
-  --bot-name <name>      Bot mention name (default: claude-code)
-  --allowed-users <list> Comma-separated allowed usernames
-  --skip-permissions     Skip permission prompts (auto-approve)
-  --no-skip-permissions  Enable permission prompts (override env)
-  --debug                Enable debug logging
-  --version              Show version
-  --help                 Show help
+  --url <url>              Mattermost server URL
+  --token <token>          Bot token
+  --channel <id>           Channel ID
+  --bot-name <name>        Bot mention name (default: claude-code)
+  --allowed-users <list>   Comma-separated allowed usernames
+  --skip-permissions       Skip permission prompts (auto-approve)
+  --no-skip-permissions    Enable permission prompts (override env)
+  --chrome                 Enable Chrome integration
+  --no-chrome              Disable Chrome integration
+  --worktree-mode <mode>   Git worktree mode: off, prompt, require
+  --setup                  Re-run setup wizard (reconfigure settings)
+  --debug                  Enable debug logging
+  --version                Show version
+  --help                   Show help
 ```
 
 CLI options override environment variables.
@@ -123,11 +129,17 @@ Type `!help` in any session thread to see available commands:
 |:--------|:------------|
 | `!help` | Show available commands |
 | `!release-notes` | Show release notes for current version |
+| `!context` | Show context usage (tokens used/remaining) |
+| `!cost` | Show token usage and cost for this session |
+| `!compact` | Compress context to free up space |
 | `!cd <path>` | Change working directory (restarts Claude) |
+| `!worktree <branch>` | Create and switch to a git worktree |
 | `!invite @user` | Invite a user to this session |
 | `!kick @user` | Remove an invited user |
 | `!permissions interactive` | Enable interactive permissions |
+| `!escape` | Interrupt current task (keeps session active) |
 | `!stop` | Stop this session |
+| `!kill` | Emergency shutdown (kills ALL sessions, exits bot) |
 
 > **Note:** Commands use `!` prefix instead of `/` to avoid conflicts with Mattermost's slash commands.
 
@@ -176,6 +188,47 @@ If the bot is running with `--skip-permissions` (auto mode), you can enable inte
 
 This allows collaboration by requiring approval for Claude's actions. Note: you can only downgrade (auto → interactive), not upgrade - this ensures security.
 
+## Git Worktrees
+
+When working on a task that requires code changes, Claude can work in an isolated git worktree. This keeps your main branch clean while Claude works on a feature branch in a separate directory.
+
+### Starting a Session with a Worktree
+
+Specify a branch when starting:
+
+```
+@claude-code on branch feature/add-auth implement user authentication
+```
+
+Or use the worktree command:
+
+```
+@claude-code !worktree feature/add-auth implement user authentication
+```
+
+### Worktree Commands
+
+| Command | Description |
+|:--------|:------------|
+| `!worktree <branch>` | Create worktree and switch to it |
+| `!worktree list` | List all worktrees for this repo |
+| `!worktree switch <branch>` | Switch to an existing worktree |
+| `!worktree remove <branch>` | Remove a worktree |
+| `!worktree off` | Disable worktree prompts for this session |
+
+### How It Works
+
+1. Creates a new worktree at `../<repo>-worktrees/<branch>/`
+2. Creates or checks out the specified branch
+3. Claude works in the worktree directory
+4. Your main working directory stays untouched
+
+### Environment Variable
+
+| Variable | Description |
+|----------|-------------|
+| `WORKTREE_MODE` | `prompt` (ask on new sessions), `require` (always require branch), `off` (disable) |
+
 ## Interactive Features
 
 ### Permission Approval
@@ -258,6 +311,8 @@ ALLOWED_USERS=alice,bob,carol
 | `MATTERMOST_BOT_NAME` | Mention name (default: `claude-code`) |
 | `ALLOWED_USERS` | Comma-separated usernames |
 | `SKIP_PERMISSIONS` | `true` to auto-approve actions |
+| `CLAUDE_CHROME` | `true` to enable Chrome integration |
+| `WORKTREE_MODE` | `off`, `prompt`, or `require` (default: `prompt`) |
 | `MAX_SESSIONS` | Max concurrent sessions (default: `5`) |
 | `SESSION_TIMEOUT_MS` | Idle timeout in ms (default: `1800000` = 30 min) |
 | `NO_UPDATE_NOTIFIER` | Set to `1` to disable update checks |

package/dist/index.js

@@ -29,6 +29,8 @@ program
     .option('--no-skip-permissions', 'Enable interactive permission prompts (override env)')
     .option('--chrome', 'Enable Claude in Chrome integration')
     .option('--no-chrome', 'Disable Claude in Chrome integration')
+    .option('--worktree-mode <mode>', 'Git worktree mode: off, prompt, require (default: prompt)')
+    .option('--setup', 'Run interactive setup wizard (reconfigure existing settings)')
     .option('--debug', 'Enable debug logging')
     .parse();
 const opts = program.opts();
@@ -52,10 +54,14 @@ async function main() {
         allowedUsers: opts.allowedUsers,
         skipPermissions: opts.skipPermissions,
         chrome: opts.chrome,
+        worktreeMode: opts.worktreeMode,
     };
     // Check if we need onboarding
-    if (!configExists() && !hasRequiredCliArgs(opts)) {
-        await runOnboarding();
+    if (opts.setup) {
+        await runOnboarding(true); // reconfigure mode
+    }
+    else if (!configExists() && !hasRequiredCliArgs(opts)) {
+        await runOnboarding(false); // first-time mode
     }
     const workingDir = process.cwd();
     const config = loadConfig(cliArgs);
@@ -68,7 +74,7 @@ async function main() {
     console.log(`  💬 ${cyan('@' + config.mattermost.botName)}`);
     console.log(`  🌐 ${dim(config.mattermost.url)}`);
     if (config.skipPermissions) {
-        console.log(`  ⚠️  ${dim('Permissions disabled')}`);
+        console.log(`  ⚠️ ${dim('Permissions disabled')}`);
     }
     else {
         console.log(`  🔐 ${dim('Interactive permissions')}`);

package/dist/onboarding.d.ts

@@ -1 +1 @@
-export declare function runOnboarding(): Promise<void>;
+export declare function runOnboarding(reconfigure?: boolean): Promise<void>;

package/dist/onboarding.js

@@ -1,16 +1,47 @@
 import prompts from 'prompts';
-import { writeFileSync, mkdirSync } from 'fs';
+import { writeFileSync, mkdirSync, readFileSync, existsSync } from 'fs';
 import { homedir } from 'os';
-import { resolve } from 'path';
+import { resolve, dirname } from 'path';
+import { parse } from 'dotenv';
 const bold = (s) => `\x1b[1m${s}\x1b[0m`;
 const dim = (s) => `\x1b[2m${s}\x1b[0m`;
 const green = (s) => `\x1b[32m${s}\x1b[0m`;
-export async function runOnboarding() {
-    console.log('');
-    console.log(bold('  Welcome to claude-threads!'));
-    console.log(dim('  ─────────────────────────────────'));
+// Paths to search for .env files (in order of priority)
+const ENV_PATHS = [
+    resolve(process.cwd(), '.env'),
+    resolve(homedir(), '.config', 'claude-threads', '.env'),
+    resolve(homedir(), '.claude-threads.env'),
+];
+function loadExistingConfig() {
+    for (const envPath of ENV_PATHS) {
+        if (existsSync(envPath)) {
+            try {
+                const content = readFileSync(envPath, 'utf-8');
+                return { path: envPath, values: parse(content) };
+            }
+            catch {
+                return { path: null, values: {} };
+            }
+        }
+    }
+    return { path: null, values: {} };
+}
+export async function runOnboarding(reconfigure = false) {
+    const { path: existingPath, values: existing } = reconfigure ? loadExistingConfig() : { path: null, values: {} };
+    const hasExisting = Object.keys(existing).length > 0;
     console.log('');
-    console.log('  No configuration found. Let\'s set things up.');
+    if (reconfigure && hasExisting) {
+        console.log(bold('  Reconfiguring claude-threads'));
+        console.log(dim('  ─────────────────────────────────'));
+        console.log('');
+        console.log(dim('  Press Enter to keep existing values.'));
+    }
+    else {
+        console.log(bold('  Welcome to claude-threads!'));
+        console.log(dim('  ─────────────────────────────────'));
+        console.log('');
+        console.log('  No configuration found. Let\'s set things up.');
+    }
     console.log('');
     console.log(dim('  You\'ll need:'));
     console.log(dim('  • A Mattermost bot account with a token'));
@@ -23,25 +54,41 @@ export async function runOnboarding() {
         console.log(dim('  Setup cancelled.'));
         process.exit(0);
     };
+    // Helper to get worktree mode index
+    const worktreeModeIndex = (mode) => {
+        if (mode === 'off')
+            return 1;
+        if (mode === 'require')
+            return 2;
+        return 0; // default to 'prompt'
+    };
     const response = await prompts([
         {
             type: 'text',
             name: 'url',
             message: 'Mattermost URL',
-            initial: 'https://your-mattermost-server.com',
+            initial: existing.MATTERMOST_URL || 'https://your-mattermost-server.com',
             validate: (v) => v.startsWith('http') ? true : 'URL must start with http:// or https://',
         },
         {
             type: 'password',
             name: 'token',
             message: 'Bot token',
-            hint: 'Create at: Integrations > Bot Accounts > Add Bot Account',
-            validate: (v) => v.length > 0 ? true : 'Token is required',
+            hint: existing.MATTERMOST_TOKEN
+                ? 'Enter to keep existing, or type new token'
+                : 'Create at: Integrations > Bot Accounts > Add Bot Account',
+            validate: (v) => {
+                // Allow empty if we have an existing token (user wants to keep it)
+                if (!v && existing.MATTERMOST_TOKEN)
+                    return true;
+                return v.length > 0 ? true : 'Token is required';
+            },
         },
         {
             type: 'text',
             name: 'channelId',
             message: 'Channel ID',
+            initial: existing.MATTERMOST_CHANNEL_ID || '',
             hint: 'Click channel name > View Info > copy ID from URL',
             validate: (v) => v.length > 0 ? true : 'Channel ID is required',
         },
@@ -49,26 +96,48 @@ export async function runOnboarding() {
             type: 'text',
             name: 'botName',
             message: 'Bot mention name',
-            initial: 'claude-code',
+            initial: existing.MATTERMOST_BOT_NAME || 'claude-code',
             hint: 'Users will @mention this name',
         },
         {
             type: 'text',
             name: 'allowedUsers',
             message: 'Allowed usernames',
-            initial: '',
+            initial: existing.ALLOWED_USERS || '',
             hint: 'Comma-separated, or empty for all users',
         },
         {
             type: 'confirm',
             name: 'skipPermissions',
             message: 'Skip permission prompts?',
-            initial: true,
+            initial: existing.SKIP_PERMISSIONS !== undefined
+                ? existing.SKIP_PERMISSIONS === 'true'
+                : true,
             hint: 'If no, you\'ll approve each action via emoji reactions',
         },
+        {
+            type: 'confirm',
+            name: 'chrome',
+            message: 'Enable Chrome integration?',
+            initial: existing.CLAUDE_CHROME === 'true',
+            hint: 'Requires Claude in Chrome extension',
+        },
+        {
+            type: 'select',
+            name: 'worktreeMode',
+            message: 'Git worktree mode',
+            hint: 'Isolate changes in separate worktrees',
+            choices: [
+                { title: 'Prompt', value: 'prompt', description: 'Ask when starting new sessions' },
+                { title: 'Off', value: 'off', description: 'Never use worktrees' },
+                { title: 'Require', value: 'require', description: 'Always require a branch name' },
+            ],
+            initial: worktreeModeIndex(existing.WORKTREE_MODE),
+        },
     ], { onCancel });
-    // Check if user cancelled
-    if (!response.url || !response.token || !response.channelId) {
+    // Check if user cancelled - token can be empty if keeping existing
+    const finalToken = response.token || existing.MATTERMOST_TOKEN;
+    if (!response.url || !finalToken || !response.channelId) {
         console.log('');
         console.log(dim('  Setup incomplete. Run claude-threads again to retry.'));
         process.exit(1);
@@ -81,7 +150,7 @@ export async function runOnboarding() {
 MATTERMOST_URL=${response.url}
 
 # Bot token (from Integrations > Bot Accounts)
-MATTERMOST_TOKEN=${response.token}
+MATTERMOST_TOKEN=${finalToken}
 
 # Channel ID where the bot listens
 MATTERMOST_CHANNEL_ID=${response.channelId}
@@ -94,10 +163,18 @@ ALLOWED_USERS=${response.allowedUsers || ''}
 
 # Skip permission prompts (true = auto-approve, false = require emoji approval)
 SKIP_PERMISSIONS=${response.skipPermissions ? 'true' : 'false'}
+
+# Chrome integration (requires Claude in Chrome extension)
+CLAUDE_CHROME=${response.chrome ? 'true' : 'false'}
+
+# Git worktree mode (off, prompt, require)
+WORKTREE_MODE=${response.worktreeMode || 'prompt'}
 `;
-    // Save to ~/.config/claude-threads/.env
-    const configDir = resolve(homedir(), '.config', 'claude-threads');
-    const envPath = resolve(configDir, '.env');
+    // Save to same location if reconfiguring, otherwise default location
+    const defaultConfigDir = resolve(homedir(), '.config', 'claude-threads');
+    const defaultEnvPath = resolve(defaultConfigDir, '.env');
+    const envPath = existingPath || defaultEnvPath;
+    const configDir = dirname(envPath);
     try {
         mkdirSync(configDir, { recursive: true });
         writeFileSync(envPath, envContent, { mode: 0o600 }); // Secure permissions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-threads",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "Share Claude Code sessions live in a Mattermost channel with interactive features",
   "main": "dist/index.js",
   "type": "module",