claude-notification-plugin 1.1.20 → 1.1.26

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-notification-plugin",
-  "version": "1.1.20",
+  "version": "1.1.26",
   "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
   "author": {
     "name": "Viacheslav Makarov",

package/README.md

@@ -88,6 +88,8 @@ Config file: `~/.claude/claude-notify.config.json`
         "path": "abs-path-to-project"
       }
     },
+    "claudeArgs": ["--permission-mode", "auto"],
+    "continueSession": true,
     "worktreeBaseDir": "abs-path-to-worktrees-root",
     "autoCreateWorktree": true,
     "taskTimeoutMinutes": 30,
@@ -242,7 +244,8 @@ All commands start with `/` and execute instantly (not queued).
 | `/queue`                      | Show all queues                      |
 | `/cancel /project[/branch]`   | Cancel the active task               |
 | `/drop /project N`            | Remove task N from queue             |
-| `/clear /project[/branch]`    | Clear queue                          |
+| `/clear /project[/branch]`    | Clear queue + reset session          |
+| `/newsession [/project[/branch]]` | Reset session only (keep queue)  |
 | `/projects`                   | List projects and paths              |
 | `/worktrees /project`         | List worktrees                       |
 | `/worktree /project/branch`   | Create a worktree                    |
@@ -253,16 +256,18 @@ All commands start with `/` and execute instantly (not queued).
 
 ### Listener configuration
 
-| Parameter            | Default               | Description                                         |
-|----------------------|-----------------------|-----------------------------------------------------|
-| `projects`           | (required)            | Map of projects: `alias → { path }`                 |
-| `worktreeBaseDir`    | `~/.claude/worktrees` | Where auto-created worktrees are stored              |
-| `autoCreateWorktree` | `true`                | Auto-create worktrees for unknown branches           |
-| `taskTimeoutMinutes` | `30`                  | Max task execution time (force-stopped when exceeded)|
-| `maxQueuePerWorkDir` | `10`                  | Max tasks in queue per working directory              |
-| `maxTotalTasks`      | `50`                  | Max tasks across all queues                          |
-| `logDir`             | `~/.claude`           | Listener log directory                               |
-| `taskLogDir`         | same as `logDir`      | Task Q&A log directory                               |
+| Parameter            | Default               | Description                                                                            |
+|----------------------|-----------------------|----------------------------------------------------------------------------------------|
+| `projects`           | (required)            | Map of projects: `alias → { path }`                                                    |
+| `claudeArgs`         | `[]`                  | Extra CLI args for `claude -p` (e.g. `["--permission-mode", "auto"]`)                  |
+| `continueSession`    | `true`                | Continue previous session context (`--continue` flag). Claude remembers previous tasks |
+| `worktreeBaseDir`    | `~/.claude/worktrees` | Where auto-created worktrees are stored                                                |
+| `autoCreateWorktree` | `true`                | Auto-create worktrees for unknown branches                                             |
+| `taskTimeoutMinutes` | `30`                  | Max task execution time (force-stopped when exceeded)                                  |
+| `maxQueuePerWorkDir` | `10`                  | Max tasks in queue per working directory                                               |
+| `maxTotalTasks`      | `50`                  | Max tasks across all queues                                                            |
+| `logDir`             | `~/.claude`           | Listener log directory                                                                 |
+| `taskLogDir`         | same as `logDir`      | Task Q&A log directory                                                                 |
 
 ### Projects and worktrees
 
@@ -270,6 +275,16 @@ All commands start with `/` and execute instantly (not queued).
 - `/api task` and `/api/feature/auth task` → **different queues** (parallel)
 - `/api task1` and `/api task2` → **same queue** (sequential)
 
+`claudeArgs` can also be set per-project to override the global value:
+```json
+"projects": {
+  "myapp": {
+    "path": "/path/to/myapp",
+    "claudeArgs": ["--permission-mode", "bypassPermissions", "--model", "opus"]
+  }
+}
+```
+
 Worktrees are auto-created when you use `/project/branch` syntax (controlled by `autoCreateWorktree`).
 
 ```

package/bin/install.js

@@ -622,6 +622,7 @@ Send any message to your bot in Telegram, then press Enter.\x1b[0m`);
     notifyOnWaiting: false,
     debug: false,
     listener: {
+      claudeArgs: ['--permission-mode', 'auto', '--model', 'opus'],
       projects: {},
       worktreeBaseDir: path.join(HOME, '.claude', 'worktrees'),
       autoCreateWorktree: true,

package/bin/listener-cli.js

@@ -414,6 +414,37 @@ Press Enter to keep current value shown in [brackets].
   const maxTotalStr = await ask(rl, `Max total tasks [${defaults.maxTotalTasks}]: `);
   L.maxTotalTasks = parsePositiveInt(maxTotalStr, defaults.maxTotalTasks);
 
+  // --- Claude args ---
+  const permModes = ['auto', 'bypassPermissions', 'default', 'acceptEdits', 'plan'];
+  const currentClaudeArgs = L.claudeArgs || ['--permission-mode', 'auto', '--model', 'opus'];
+  const currentPermIdx = currentClaudeArgs.indexOf('--permission-mode');
+  const currentPerm = currentPermIdx >= 0 ? currentClaudeArgs[currentPermIdx + 1] : 'auto';
+  const currentPermNum = permModes.indexOf(currentPerm) + 1 || 1;
+
+  console.log(`
+Permission mode for claude -p (tools access):
+  1. auto — smart auto-approval (recommended)
+  2. bypassPermissions — allow everything (trusted environments)
+  3. default — standard interactive prompts
+  4. acceptEdits — auto-approve edits only
+  5. plan — read-only, no edits`);
+
+  const permInput = await ask(rl, `Choose [${currentPermNum}]: `);
+  const permChoice = parseInt(permInput, 10);
+  const selectedPerm = (permChoice >= 1 && permChoice <= 5) ? permModes[permChoice - 1] : currentPerm;
+
+  // Build claudeArgs preserving non-permission-mode args
+  const newClaudeArgs = ['--permission-mode', selectedPerm];
+  // Preserve --model if present
+  const modelIdx = currentClaudeArgs.indexOf('--model');
+  if (modelIdx >= 0 && currentClaudeArgs[modelIdx + 1]) {
+    newClaudeArgs.push('--model', currentClaudeArgs[modelIdx + 1]);
+  } else {
+    newClaudeArgs.push('--model', 'opus');
+  }
+  L.claudeArgs = newClaudeArgs;
+  console.log(`  → --permission-mode ${selectedPerm}`);
+
   // --- Default project ---
   console.log('');
   const projectInput = await ask(rl, `Default project path [${defaults.projectPath || '(none)'}]: `);

package/commit-sha

@@ -1 +1 @@
-1c842063a9de04968f5523348e390194668a289b
+6f378bc3b2e112b21a02fcb18cd55bc584ecea38

package/listener/LISTENER-DETAILED.md

@@ -220,7 +220,7 @@ TelegramPoller.getUpdates()
 MessageParser.parse(text)
        │
        ├─ Starts with "/"? ──► Command
-       │    ├─ /status, /queue, /cancel, /drop, /clear
+       │    ├─ /status, /queue, /cancel, /drop, /clear, /newsession
        │    ├─ /projects, /worktrees, /worktree, /rmworktree
        │    ├─ /history, /help, /stop
        │    └─ Execute → reply in Telegram
@@ -307,12 +307,15 @@ Full example of `~/.claude/claude-notify.config.json` with the listener section:
     "deleteAfterHours": 24
   },
   "listener": {
+    "claudeArgs": ["--permission-mode", "auto"],
+    "continueSession": true,
     "projects": {
       "default": {
         "path": "/home/user/main-project"
       },
       "api": {
         "path": "/home/user/projects/api-server",
+        "claudeArgs": ["--permission-mode", "bypassPermissions", "--model", "opus"],
         "worktrees": {
           "feature/auth": "/home/user/projects/api-wt-auth"
         }
@@ -336,7 +339,9 @@ Full example of `~/.claude/claude-notify.config.json` with the listener section:
 
 | Parameter | Default | Description |
 |---|---|---|
-| `projects` | — (required) | Map of projects: `alias → { path, worktrees? }` |
+| `projects` | — (required) | Map of projects: `alias → { path, worktrees?, claudeArgs? }` |
+| `claudeArgs` | `[]` | Extra CLI args passed to `claude -p` (e.g. `["--permission-mode", "auto"]`). Can also be set per-project to override |
+| `continueSession` | `true` | Continue previous session context per workDir. Claude remembers previous tasks. Use `/newsession` or `/clear` to reset |
 | `worktreeBaseDir` | `~/.claude/worktrees` | Where auto-created worktrees are stored |
 | `autoCreateWorktree` | `true` | Automatically create a worktree if the branch is not found |
 | `taskTimeoutMinutes` | `30` | Maximum task execution time in minutes. Force-stopped when exceeded |
@@ -630,15 +635,27 @@ Bot: 🗑 Removed from queue: refactor the code
 
 The task number is the position in the queue (starting from 1). You can check numbers with `/queue`.
 
-### /clear — clear the queue
+### /clear — clear the queue and reset session
 
-Removes all tasks from the queue (the active task continues running):
+Removes all tasks from the queue (the active task continues running) and resets the session context.
+The next task will start a fresh Claude session:
 
 ```
 You: /clear /api
-Bot: 🧹 [/api] Queue cleared (3 tasks)
+Bot: 🧹 [/api] Queue cleared (3 tasks), session reset
 ```
 
+### /newsession — reset session context
+
+Resets the session without touching the queue. The next task starts a fresh session:
+
+```
+You: /newsession /api
+Bot: 🆕 [/api] Session reset (was #5 tasks, ctx 42%). Next task starts fresh.
+```
+
+Use this when the context window is getting full or when you want Claude to "forget" previous work and start clean.
+
 ### /projects — list projects
 
 ```
@@ -757,16 +774,32 @@ Shows a brief reference for all commands.
 The command that gets executed:
 
 ```bash
-claude -p "your message text from Telegram" --output-format text
+claude -p "your message text from Telegram" --output-format text [claudeArgs...]
 ```
 
 With the working directory (`cwd`) = project/worktree workDir.
 
+Extra CLI arguments can be configured via `claudeArgs` in config (global or per-project).
+Recommended: `["--permission-mode", "auto"]` — allows Claude to use tools (Edit, Bash, Read, etc.) without interactive prompts, matching the quality of a full interactive session.
+
 Claude sees the project files, CLAUDE.md, .claude/settings.json, and everything else as if you had launched it manually in that directory.
 
+### Session continuity
+
+When `continueSession` is enabled (default), the listener adds `--continue` to subsequent tasks in the same workDir. This means Claude remembers previous tasks and their context — just like working in an interactive terminal session.
+
+Messages show session status:
+- `🆕` = new session (first task or after `/newsession`/`/clear`)
+- `🔄 #3` = continuing session, task number 3
+- `ctx 42%` = context window usage (42% filled)
+
+The completion message includes metadata: duration, turns, context usage, cost.
+
+Use `/newsession` to reset the session when context gets full, or `/clear` to reset both queue and session.
+
 ### What is returned to Telegram
 
-All stdout from claude. This is Claude's text response to your task.
+The `result` field from Claude's JSON output — the text response to your task.
 
 Handling long responses:
 - Up to 4096 characters — a single message
@@ -907,6 +940,38 @@ claude-notify listener restart
 
 The watchdog will automatically clear stale tasks on the next startup.
 
+### Claude gives low-quality responses (doesn't edit files, just describes what to do)
+
+By default `claude -p` runs without tool permissions — Claude can't use Edit, Bash, Read, etc.
+Add `claudeArgs` to your listener config:
+
+```json
+"listener": {
+  "claudeArgs": ["--permission-mode", "auto"]
+}
+```
+
+Available permission modes:
+- `auto` — allows tools with smart auto-approval (recommended)
+- `bypassPermissions` — allows everything without any checks (use in trusted environments)
+
+Other useful flags:
+- `--model opus` — force a specific model
+- `--allowedTools "Bash Edit Read Write"` — allow specific tools only
+
+Restart the listener after changing config: `claude-notify listener restart`
+
+### Context window getting full
+
+After many tasks in the same session, the context window fills up and responses may degrade.
+The completion message shows `ctx N%` — when it's above ~80%, consider resetting:
+
+```
+/newsession /project
+```
+
+This starts a fresh session without clearing the task queue. You can also use `/clear` to reset both.
+
 ### Claude can't find project files
 
 Check the path in the config:
@@ -932,6 +997,8 @@ Suppose you have two projects: an API server and a web application.
     "chatId": "987654321"
   },
   "listener": {
+    "claudeArgs": ["--permission-mode", "auto"],
+    "continueSession": true,
     "projects": {
       "api": { "path": "/home/user/projects/api" },
       "web": { "path": "/home/user/projects/web" }