claude-notification-plugin 1.1.14 → 1.1.15

package/.claude-plugin/plugin.json

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

package/README.md

@@ -195,7 +195,7 @@ Alternatively, add a `listener` section to config manually:
 }
 ```
 
-The `"default"` alias receives messages without a `@project` prefix.
+The `"default"` alias receives messages without a `/project` prefix.
 `api` and `web` are project aliases for easy reference from Telegram.
 
 ### 2. Start the listener
@@ -208,16 +208,16 @@ claude-notify listener start
 
 ```
 fix the login bug                     → runs in "default" project
-@api add pagination to GET /users     → runs in "api" project
-@api/feature/auth implement OAuth2    → runs in a worktree (auto-created)
+/api add pagination to GET /users     → runs in "api" project
+/api/feature/auth implement OAuth2    → runs in a worktree (auto-created)
 ```
 
 The bot replies with status and results:
 
 ```
-⏳ [@api] Running: add pagination to GET /users
+⏳ [/api] Running: add pagination to GET /users
 ...
-✅ [@api] Done: add pagination to GET /users
+✅ [/api] Done: add pagination to GET /users
 <claude's output>
 ```
 
@@ -238,15 +238,15 @@ All commands start with `/` and execute instantly (not queued).
 | Command                       | Description                          |
 |-------------------------------|--------------------------------------|
 | `/status`                     | Status of all projects and worktrees |
-| `/status @project`            | Status of a specific project         |
+| `/status /project`            | Status of a specific project         |
 | `/queue`                      | Show all queues                      |
-| `/cancel @project[/branch]`   | Cancel the active task               |
-| `/drop @project N`            | Remove task N from queue             |
-| `/clear @project[/branch]`    | Clear queue                          |
+| `/cancel /project[/branch]`   | Cancel the active task               |
+| `/drop /project N`            | Remove task N from queue             |
+| `/clear /project[/branch]`    | Clear queue                          |
 | `/projects`                   | List projects and paths              |
-| `/worktrees @project`         | List worktrees                       |
-| `/worktree @project branch`   | Create a worktree                    |
-| `/rmworktree @project branch` | Remove a worktree                    |
+| `/worktrees /project`         | List worktrees                       |
+| `/worktree /project/branch`   | Create a worktree                    |
+| `/rmworktree /project/branch` | Remove a worktree                    |
 | `/history`                    | Recent task history                  |
 | `/stop`                       | Stop the listener                    |
 | `/help`                       | Show help                            |
@@ -267,15 +267,15 @@ All commands start with `/` and execute instantly (not queued).
 ### Projects and worktrees
 
 **The queue is tied to the working directory, not the project name:**
-- `@api task` and `@api/feature/auth task` → **different queues** (parallel)
-- `@api task1` and `@api task2` → **same queue** (sequential)
+- `/api task` and `/api/feature/auth task` → **different queues** (parallel)
+- `/api task1` and `/api task2` → **same queue** (sequential)
 
-Worktrees are auto-created when you use `@project/branch` syntax (controlled by `autoCreateWorktree`).
+Worktrees are auto-created when you use `/project/branch` syntax (controlled by `autoCreateWorktree`).
 
 ```
-/worktree @api feature/payments     ← create
-/worktrees @api                     ← list
-/rmworktree @api feature/payments   ← remove
+/worktree /api/feature/payments     ← create
+/worktrees /api                     ← list
+/rmworktree /api/feature/payments   ← remove
 ```
 
 

package/commit-sha

@@ -1 +1 @@
-029b33fb55070d48e762d3693e8b22eb121c0ec0
+b092cf465b465f338c3e5ab0e073a8c91aac4d51

package/listener/LISTENER-DETAILED.md

@@ -60,7 +60,7 @@ GET /getUpdates?timeout=30  ────►     "Let's wait up to 30 seconds,
      connection is open)
 
                                       After 15 sec a user
-                                      wrote "@proj1 fix bug"
+                                      wrote "/proj1 fix bug"
 
 ◄──── {"result": [{"message":...}]}   "There's a message, here it is!"
 
@@ -180,7 +180,7 @@ Running two listeners is impossible — the PID file prevents it. And this is im
 │  ┌───────┴────────┐    ┌───────┴───────┐   │
 │  │ MessageParser  │    │  TaskRunner   │   │
 │  │                │    │               │   │
-│  │ @proj/branch   │    │ spawn claude  │   │
+│  │ /proj/branch   │    │ spawn claude  │   │
 │  │ /commands      │    │ timeouts      │   │
 │  └────────────────┘    │ kill          │   │
 │                        └───────────────┘   │
@@ -197,10 +197,10 @@ Running two listeners is impossible — the PID file prevents it. And this is im
 | Module | File | Description |
 |---|---|---|
 | **TelegramPoller** | `telegram-poller.js` | Long polling to the Telegram API. Receives messages, sends replies. Splits long messages into chunks |
-| **MessageParser** | `message-parser.js` | Parses message text: is it a command (`/status`) or a task (`@proj1 fix bug`)? Extracts project, branch, task text |
+| **MessageParser** | `message-parser.js` | Parses message text: is it a command (`/status`) or a task (`/proj1 fix bug`)? Extracts project, branch, task text |
 | **WorkQueue** | `work-queue.js` | Manages task queues. Each working directory has a separate FIFO queue. Guarantees: one `claude` process per directory. Persists state to disk |
 | **TaskRunner** | `task-runner.js` | Runs `claude -p "task"` as a child process. Monitors timeouts. Can kill the process on cancellation. Emits events: complete, error, timeout |
-| **WorktreeManager** | `worktree-manager.js` | Creates and removes git worktrees. Auto-discovery via `git worktree list`. Maps `@project/branch` to a path on disk |
+| **WorktreeManager** | `worktree-manager.js` | Creates and removes git worktrees. Auto-discovery via `git worktree list`. Maps `/project/branch` to a path on disk |
 | **Logger** | `logger.js` | Writes operational log to `~/.claude/.cc-n-listener.log`. Rotation when exceeding 5 MB (old file → `.log.old`) |
 | **TaskLogger** | `task-logger.js` | Writes task Q&A logs (questions to Claude and answers). Separate file per project/branch. Rotation at 5 MB |
 
@@ -227,12 +227,12 @@ MessageParser.parse(text)
        │
        └─ Otherwise ──► Task
             │
-            ├─ "@proj1/feature/auth fix bug"
+            ├─ "/proj1/feature/auth fix bug"
             │    → project = "proj1"
             │    → branch = "feature/auth"
             │    → text = "fix bug"
             │
-            ├─ "@proj1 fix bug"
+            ├─ "/proj1 fix bug"
             │    → project = "proj1"
             │    → branch = null (main)
             │    → text = "fix bug"
@@ -357,9 +357,9 @@ Each project is an alias (short name) + path to a directory on disk:
 }
 ```
 
-Now in Telegram you can write `@api refactor the code`, and Claude will run in the `/home/user/projects/api-server` directory.
+Now in Telegram you can write `/api refactor the code`, and Claude will run in the `/home/user/projects/api-server` directory.
 
-The **`default`** alias is special. Messages without `@project` go to it:
+The **`default`** alias is special. Messages without `/project` prefix go to it:
 
 ```json
 {
@@ -378,9 +378,9 @@ The **`default`** alias is special. Messages without `@project` go to it:
 In the Telegram chat with the bot:
 
 ```
-@project task                      ← task in the main worktree of the project
-@project/branch task               ← task in the worktree of a specific branch
-task without @                     ← task in the "default" project
+/project task                      ← task in the main worktree of the project
+/project/branch task               ← task in the worktree of a specific branch
+task without /project prefix       ← task in the "default" project
 ```
 
 ### Examples
@@ -391,25 +391,25 @@ add a README to the project
 → runs in the `default` project (if configured)
 
 ```
-@api fix the authentication bug
+/api fix the authentication bug
 ```
 → runs in `/home/user/projects/api-server`
 
 ```
-@api/feature/payments add Stripe integration
+/api/feature/payments add Stripe integration
 ```
 → runs in the `feature/payments` worktree of the `api` project.
 If the worktree doesn't exist, it will be created automatically.
 
 ```
-@web update dependencies
+/web update dependencies
 ```
 → runs in `/home/user/projects/web-app`
 
 ### What happens when a task is sent
 
 1. The Listener receives the message from Telegram
-2. Parses `@project/branch` from the beginning of the message
+2. Parses `/project/branch` from the beginning of the message
 3. Determines the working directory (workDir)
 4. Checks: is this workDir busy with another task?
    - **No** → runs `claude -p "task"` immediately, replies with `⏳ Running...`
@@ -445,8 +445,8 @@ api-server/                        ← main worktree, branch main
 **The queue is tied to the working directory, not to the project name.**
 
 This means:
-- `@api task` and `@api/feature/auth task` are **different queues**, because they're different directories. They run **in parallel**.
-- `@api task1` and `@api task2` are **the same queue** (both go to the main worktree). `task2` will wait for `task1` to complete.
+- `/api task` and `/api/feature/auth task` are **different queues**, because they're different directories. They run **in parallel**.
+- `/api task1` and `/api task2` are **the same queue** (both go to the main worktree). `task2` will wait for `task1` to complete.
 
 ```
 Project "api"
@@ -466,7 +466,7 @@ Within each — strictly one task at a time.
 
 ### Auto-creation of worktrees
 
-When you write `@api/feature/new task`, and a worktree for the `feature/new` branch doesn't exist:
+When you write `/api/feature/new task`, and a worktree for the `feature/new` branch doesn't exist:
 
 1. The Listener checks: does the `feature/new` branch exist in git?
    - Yes → `git worktree add ~/.claude/worktrees/api/feature-new feature/new`
@@ -484,9 +484,9 @@ On startup, the listener scans each project with `git worktree list` and picks u
 ### Manual worktree management from Telegram
 
 ```
-/worktree @api feature/payments     ← create a worktree
-/worktrees @api                     ← list all worktrees for a project
-/rmworktree @api feature/payments   ← remove a worktree
+/worktree /api/feature/payments     ← create a worktree
+/worktrees /api                     ← list all worktrees for a project
+/rmworktree /api/feature/payments   ← remove a worktree
 ```
 
 ---
@@ -504,41 +504,41 @@ While `active !== null`, all new tasks for this workDir go into the `queue`.
 ### Example: 4 tasks, 2 projects
 
 ```
-10:00  You: @api fix the router bug
-       Bot: ⏳ [@api] Running: fix the router bug
+10:00  You: /api fix the router bug
+       Bot: ⏳ [/api] Running: fix the router bug
        (api/main: active = "fix the router bug", queue = [])
 
-10:01  You: @web update dependencies
-       Bot: ⏳ [@web] Running: update dependencies
+10:01  You: /web update dependencies
+       Bot: ⏳ [/web] Running: update dependencies
        (web/main: active = "update dependencies", queue = [])
        (api and web are running in parallel!)
 
-10:02  You: @api add tests
-       Bot: 📋 [@api] Queued (position 1).
+10:02  You: /api add tests
+       Bot: 📋 [/api] Queued (position 1).
             Currently running: fix the router bug
        (api/main: active = "fix the router bug", queue = ["add tests"])
 
-10:03  You: @api refactor the code
-       Bot: 📋 [@api] Queued (position 2).
+10:03  You: /api refactor the code
+       Bot: 📋 [/api] Queued (position 2).
             Currently running: fix the router bug
        (api/main: active = "fix the router bug", queue = ["add tests", "refactor"])
 
-10:05  Bot: ✅ [@web] Done: update dependencies
+10:05  Bot: ✅ [/web] Done: update dependencies
             <result>
        (web/main: active = null, queue = [])
 
-10:08  Bot: ✅ [@api] Done: fix the router bug
+10:08  Bot: ✅ [/api] Done: fix the router bug
             <result>
-       Bot: ⏳ [@api] Running: add tests
+       Bot: ⏳ [/api] Running: add tests
        (api/main: active = "add tests", queue = ["refactor"])
        (next task started automatically!)
 
-10:15  Bot: ✅ [@api] Done: add tests
+10:15  Bot: ✅ [/api] Done: add tests
             <result>
-       Bot: ⏳ [@api] Running: refactor the code
+       Bot: ⏳ [/api] Running: refactor the code
        (api/main: active = "refactor", queue = [])
 
-10:25  Bot: ✅ [@api] Done: refactor the code
+10:25  Bot: ✅ [/api] Done: refactor the code
             <result>
        (api/main: active = null, queue = [])
        (all tasks completed)
@@ -555,7 +555,7 @@ While `active !== null`, all new tasks for this workDir go into the `queue`.
 If a task runs longer than 30 minutes (configurable: `taskTimeoutMinutes`), it is forcefully stopped:
 
 ```
-Bot: ⏰ [@api] Task forcefully stopped — timeout exceeded (30 min): refactor the code
+Bot: ⏰ [/api] Task forcefully stopped — timeout exceeded (30 min): refactor the code
 ```
 
 After a timeout, the next task from the queue starts automatically.
@@ -581,7 +581,7 @@ Bot: 📊 Status:
 ```
 
 ```
-You: /status @api
+You: /status /api
 Bot: 📊 Project "api":
 
      main:
@@ -598,7 +598,7 @@ Bot: 📊 Project "api":
 You: /queue
 Bot: 📋 Queues:
 
-     @api:
+     /api:
        ▶ fix the router bug
        1. add tests
        2. refactor the code
@@ -607,16 +607,16 @@ Bot: 📋 Queues:
 ### /cancel — stop a running task
 
 ```
-You: /cancel @api
-Bot: 🛑 [@api] Task cancelled. Starting next.
-     ⏳ [@api] Running: add tests
+You: /cancel /api
+Bot: 🛑 [/api] Task cancelled. Starting next.
+     ⏳ [/api] Running: add tests
 ```
 
 Cancelling a task in a worktree:
 
 ```
-You: /cancel @api/feature/auth
-Bot: 🛑 [@api/feature/auth] Task cancelled
+You: /cancel /api/feature/auth
+Bot: 🛑 [/api/feature/auth] Task cancelled
 ```
 
 ### /drop — remove from queue
@@ -624,7 +624,7 @@ Bot: 🛑 [@api/feature/auth] Task cancelled
 Removes a task that **hasn't started executing yet** (waiting in the queue):
 
 ```
-You: /drop @api 2
+You: /drop /api 2
 Bot: 🗑 Removed from queue: refactor the code
 ```
 
@@ -635,8 +635,8 @@ The task number is the position in the queue (starting from 1). You can check nu
 Removes all tasks from the queue (the active task continues running):
 
 ```
-You: /clear @api
-Bot: 🧹 [@api] Queue cleared (3 tasks)
+You: /clear /api
+Bot: 🧹 [/api] Queue cleared (3 tasks)
 ```
 
 ### /projects — list projects
@@ -646,15 +646,15 @@ You: /projects
 Bot: 📂 Projects:
 
      @default → /home/user/main-project
-     @api → /home/user/projects/api-server
+     /api → /home/user/projects/api-server
        /feature/auth → ~/.claude/worktrees/api/feature-auth
-     @web → /home/user/projects/web-app
+     /web → /home/user/projects/web-app
 ```
 
 ### /worktrees — project worktrees
 
 ```
-You: /worktrees @api
+You: /worktrees /api
 Bot: 🌳 Worktrees for project "api":
      • main → /home/user/projects/api-server
      • feature/auth → ~/.claude/worktrees/api/feature-auth
@@ -664,7 +664,7 @@ Bot: 🌳 Worktrees for project "api":
 ### /worktree — create a worktree
 
 ```
-You: /worktree @api feature/payments
+You: /worktree /api/feature/payments
 Bot: 🌿 Created worktree for project "api":
      Branch: feature/payments
      Path: ~/.claude/worktrees/api/feature-payments
@@ -673,7 +673,7 @@ Bot: 🌿 Created worktree for project "api":
 ### /rmworktree — remove a worktree
 
 ```
-You: /rmworktree @api feature/payments
+You: /rmworktree /api/feature/payments
 Bot: 🗑 Worktree feature/payments removed from project "api"
 ```
 
@@ -681,7 +681,7 @@ If a task is running in the worktree, removal will be rejected:
 
 ```
 Bot: ❌ Cannot remove worktree: a task is running in it.
-     First /cancel @api/feature/payments
+     First /cancel /api/feature/payments
 ```
 
 ### /history — history
@@ -690,10 +690,10 @@ Bot: ❌ Cannot remove worktree: a task is running in it.
 You: /history
 Bot: 📜 Recent tasks:
 
-     ✅ [@api] fix the router bug
-     ✅ [@web] update dependencies
-     🛑 [@api/feature/auth] implement OAuth2
-     ✅ [@api] add tests
+     ✅ [/api] fix the router bug
+     ✅ [/web] update dependencies
+     🛑 [/api/feature/auth] implement OAuth2
+     ✅ [/api] add tests
 ```
 
 ### /stop — stop the listener
@@ -720,7 +720,7 @@ Shows a brief reference for all commands.
    Telegram message → getUpdates() → parsing
 
 2. ROUTING
-   "@api/feature/auth task"
+   "/api/feature/auth task"
      → project = "api"
      → branch = "feature/auth"
      → workDir = ~/.claude/worktrees/api/feature-auth
@@ -896,7 +896,7 @@ Check:
 ### Task is stuck
 
 ```
-/cancel @project
+/cancel /project
 ```
 
 Or restart the listener:
@@ -950,8 +950,8 @@ You (terminal): claude-notify listener start
 
 === 10:01 — First task ===
 
-You: @api add endpoint GET /users with pagination
-Bot: ⏳ [@api] Running: add endpoint GET /users with pagination
+You: /api add endpoint GET /users with pagination
+Bot: ⏳ [/api] Running: add endpoint GET /users with pagination
 
     Behind the scenes: process started
     claude -p "add endpoint GET /users with pagination" --output-format text
@@ -959,23 +959,23 @@ Bot: ⏳ [@api] Running: add endpoint GET /users with pagination
 
 === 10:02 — Task to another project (in parallel!) ===
 
-You: @web add a /users page that calls GET /users
-Bot: ⏳ [@web] Running: add a /users page that calls GET /users
+You: /web add a /users page that calls GET /users
+Bot: ⏳ [/web] Running: add a /users page that calls GET /users
 
     Now two claude processes are running in parallel:
     one in /home/user/projects/api, another in /home/user/projects/web
 
 === 10:03 — Another task for api (queued) ===
 
-You: @api add tests for /users
-Bot: 📋 [@api] Queued (position 1).
+You: /api add tests for /users
+Bot: 📋 [/api] Queued (position 1).
      Currently running: add endpoint GET /users with pagination
 
 === 10:04 — Task in a worktree (in parallel with api/main!) ===
 
-You: @api/feature/auth add JWT authorization middleware
+You: /api/feature/auth add JWT authorization middleware
 Bot: 🌿 Created worktree feature/auth for project "api"
-     ⏳ [@api/feature/auth] Running: add JWT authorization middleware
+     ⏳ [/api/feature/auth] Running: add JWT authorization middleware
 
     Three claude processes running in parallel:
     1. api/main     → GET /users
@@ -996,7 +996,7 @@ Bot: 📊 Status:
 
 === 10:07 — web finished ===
 
-Bot: ✅ [@web] Done: add a /users page that calls GET /users
+Bot: ✅ [/web] Done: add a /users page that calls GET /users
 
      Created file src/pages/Users.vue with a user table.
      Added route in src/router.js.
@@ -1004,24 +1004,24 @@ Bot: ✅ [@web] Done: add a /users page that calls GET /users
 
 === 10:09 — api/main finished, automatically starts the next task ===
 
-Bot: ✅ [@api] Done: add endpoint GET /users with pagination
+Bot: ✅ [/api] Done: add endpoint GET /users with pagination
 
      Created controller src/controllers/users.js.
      Added route GET /users in src/routes.js.
      Supports query parameters: page, limit, sort.
 
-Bot: ⏳ [@api] Running: add tests for /users
+Bot: ⏳ [/api] Running: add tests for /users
 
     Next task from the queue started automatically!
 
 === 10:12 — Cancel a worktree task ===
 
-You: /cancel @api/feature/auth
-Bot: 🛑 [@api/feature/auth] Task cancelled
+You: /cancel /api/feature/auth
+Bot: 🛑 [/api/feature/auth] Task cancelled
 
 === 10:15 — api/main (tests) finished ===
 
-Bot: ✅ [@api] Done: add tests for /users
+Bot: ✅ [/api] Done: add tests for /users
 
      Created tests/users.test.js.
      Covered cases: pagination, sorting, empty result, errors.
@@ -1031,14 +1031,14 @@ Bot: ✅ [@api] Done: add tests for /users
 You: /history
 Bot: 📜 Recent tasks:
 
-     ✅ [@api] add tests for /users
-     🛑 [@api/feature/auth] add JWT authorization middleware
-     ✅ [@api] add endpoint GET /users with pagination
-     ✅ [@web] add a /users page...
+     ✅ [/api] add tests for /users
+     🛑 [/api/feature/auth] add JWT authorization middleware
+     ✅ [/api] add endpoint GET /users with pagination
+     ✅ [/web] add a /users page...
 
 === 10:17 — Remove unneeded worktree ===
 
-You: /rmworktree @api feature/auth
+You: /rmworktree /api/feature/auth
 Bot: 🗑 Worktree feature/auth removed from project "api"
 
 === Evening — Shut down ===

package/listener/listener.js

@@ -216,9 +216,9 @@ function formatLabel (entry) {
     return 'unknown';
   }
   if (entry.branch && entry.branch !== 'main' && entry.branch !== 'master') {
-    return `@${entry.project}/${entry.branch}`;
+    return `/${entry.project}/${entry.branch}`;
   }
-  return `@${entry.project}`;
+  return `/${entry.project}`;
 }
 
 async function startTask (workDir, task) {
@@ -358,8 +358,8 @@ function handleQueue () {
   for (const [project, statuses] of Object.entries(all)) {
     for (const s of statuses) {
       const label = s.branch && s.branch !== 'main' && s.branch !== 'master'
-        ? `@${project}/${s.branch}`
-        : `@${project}`;
+        ? `/${project}/${s.branch}`
+        : `/${project}`;
       if (s.active || s.queueLength > 0) {
         text += `\n<b>${escapeHtml(label)}</b>:`;
         if (s.active) {
@@ -392,12 +392,12 @@ async function handleCancel (args) {
   }
 
   if (!runner.isRunning(workDir)) {
-    return `❌ No active task in @${escapeHtml(projectAlias)}${branch ? '/' + escapeHtml(branch) : ''}`;
+    return `❌ No active task in /${escapeHtml(projectAlias)}${branch ? '/' + escapeHtml(branch) : ''}`;
   }
 
   runner.cancel(workDir);
   const next = queue.cancelActive(workDir);
-  const label = branch ? `@${projectAlias}/${branch}` : `@${projectAlias}`;
+  const label = branch ? `/${projectAlias}/${branch}` : `/${projectAlias}`;
 
   if (next) {
     startTask(workDir, next);
@@ -409,7 +409,7 @@ async function handleCancel (args) {
 function handleDrop (args) {
   const target = parseTarget(args);
   if (!target) {
-    return '❌ Usage: /drop @project N';
+    return '❌ Usage: /drop /project N';
   }
   const index = parseInt(target.rest, 10);
   if (!index || index < 1) {
@@ -443,7 +443,7 @@ function handleClear (args) {
   }
 
   const count = queue.clearQueue(workDir);
-  const label = branch ? `@${projectAlias}/${branch}` : `@${projectAlias}`;
+  const label = branch ? `/${projectAlias}/${branch}` : `/${projectAlias}`;
   return `🧹 [${escapeHtml(label)}] Queue cleared (${count} tasks)`;
 }
 
@@ -452,7 +452,7 @@ function handleProjects () {
   let text = '📂 <b>Projects:</b>\n';
   for (const [alias, proj] of Object.entries(projects)) {
     const projPath = typeof proj === 'string' ? proj : proj.path;
-    text += `\n<b>@${escapeHtml(alias)}</b> → <code>${escapeHtml(projPath)}</code>`;
+    text += `\n<b>/${escapeHtml(alias)}</b> → <code>${escapeHtml(projPath)}</code>`;
     const worktrees = typeof proj === 'object' ? proj.worktrees : null;
     if (worktrees && Object.keys(worktrees).length > 0) {
       for (const [branch, wtPath] of Object.entries(worktrees)) {
@@ -466,7 +466,7 @@ function handleProjects () {
 function handleWorktrees (args) {
   const target = parseTarget(args);
   if (!target) {
-    return '❌ Usage: /worktrees @project';
+    return '❌ Usage: /worktrees /project';
   }
 
   const result = worktreeManager.listWorktrees(target.project);
@@ -484,11 +484,11 @@ function handleWorktrees (args) {
 
 function handleCreateWorktree (args) {
   const target = parseTarget(args);
-  if (!target || !target.rest) {
-    return '❌ Usage: /worktree @project branch-name';
+  if (!target || !target.branch) {
+    return '❌ Usage: /worktree /project/branch';
   }
 
-  const branch = target.rest;
+  const branch = target.branch;
   try {
     const wtDir = worktreeManager.createWorktree(target.project, branch);
     return `🌿 Created worktree for "<b>${escapeHtml(target.project)}</b>":\n`
@@ -501,11 +501,11 @@ function handleCreateWorktree (args) {
 
 function handleRemoveWorktree (args) {
   const target = parseTarget(args);
-  if (!target || !target.rest) {
-    return '❌ Usage: /rmworktree @project branch-name';
+  if (!target || !target.branch) {
+    return '❌ Usage: /rmworktree /project/branch';
   }
 
-  const branch = target.rest;
+  const branch = target.branch;
 
   // Check if there's an active task in this worktree
   let workDir;
@@ -517,7 +517,7 @@ function handleRemoveWorktree (args) {
   }
 
   if (workDir && runner.isRunning(workDir)) {
-    return `❌ Cannot remove worktree: task is running. First /cancel @${escapeHtml(target.project)}/${escapeHtml(branch)}`;
+    return `❌ Cannot remove worktree: task is running. First /cancel /${escapeHtml(target.project)}/${escapeHtml(branch)}`;
   }
 
   try {
@@ -536,8 +536,8 @@ function handleHistory () {
   let text = '📜 <b>Recent tasks:</b>\n';
   for (const h of history.reverse()) {
     const label = h.branch && h.branch !== 'main' && h.branch !== 'master'
-      ? `@${h.project}/${h.branch}`
-      : `@${h.project}`;
+      ? `/${h.project}/${h.branch}`
+      : `/${h.project}`;
     const status = h.result === 'CANCELLED' ? '🛑' : h.result?.startsWith('ERROR') ? '❌' : '✅';
     text += `\n${status} [${escapeHtml(label)}] ${escapeHtml(h.text)}`;
   }
@@ -556,22 +556,22 @@ function handleHelp () {
   return `<b>📖 Commands:</b>
 
 /status — status of all projects
-/status @project — project status
+/status /project — project status
 /queue — all queues
-/cancel [@project[/branch]] — cancel task
-/drop @project N — remove task from queue
-/clear @project[/branch] — clear queue
+/cancel [/project[/branch]] — cancel task
+/drop /project N — remove task from queue
+/clear /project[/branch] — clear queue
 /projects — list projects
-/worktrees @project — project worktrees
-/worktree @project branch — create worktree
-/rmworktree @project branch — remove worktree
+/worktrees /project — project worktrees
+/worktree /project/branch — create worktree
+/rmworktree /project/branch — remove worktree
 /history — task history
 /stop — stop listener
 /help — this help
 
 <b>Tasks:</b>
-<code>@project task</code> — main worktree
-<code>@project/branch task</code> — worktree
+<code>/project task</code> — main worktree
+<code>/project/branch task</code> — worktree
 <code>task</code> — default project`;
 }
 
@@ -606,7 +606,7 @@ async function handleTask (parsed, telegramMessageId) {
 
   if (autoCreated) {
     await poller.sendMessage(`🌿 Created worktree <b>${escapeHtml(parsed.branch)}</b> for "<b>${escapeHtml(parsed.project)}</b>"`);
-    logger.info(`Auto-created worktree for task: @${parsed.project}/${parsed.branch} → ${workDir}`);
+    logger.info(`Auto-created worktree for task: /${parsed.project}/${parsed.branch} → ${workDir}`);
   }
 
   const result = queue.enqueue(
@@ -672,7 +672,7 @@ async function mainLoop () {
             await poller.sendMessage(response, msg.messageId);
           }
         } else if (parsed.type === 'task') {
-          logger.info(`Task for @${parsed.project}${parsed.branch ? '/' + parsed.branch : ''}: ${parsed.text}`);
+          logger.info(`Task for /${parsed.project}${parsed.branch ? '/' + parsed.branch : ''}: ${parsed.text}`);
           await handleTask(parsed, msg.messageId);
         }
       }

package/listener/message-parser.js

@@ -11,9 +11,12 @@ const COMMANDS = [
  *
  * Formats:
  *   /command args           → { type: 'command', cmd, args }
- *   @project/branch text    → { type: 'task', project, branch, text }
- *   @project text           → { type: 'task', project, branch: null, text }
+ *   /project/branch text    → { type: 'task', project, branch, text }
+ *   /project text           → { type: 'task', project, branch: null, text }
  *   text                    → { type: 'task', project: 'default', branch: null, text }
+ *
+ * If /word is a known command, it's treated as a command.
+ * Otherwise /word is treated as a project alias.
  */
 export function parseMessage (text) {
   if (!text || typeof text !== 'string') {
@@ -25,10 +28,11 @@ export function parseMessage (text) {
     return null;
   }
 
-  // Check for commands
   if (trimmed.startsWith('/')) {
     const parts = trimmed.split(/\s+/);
     const cmd = parts[0].toLowerCase().replace(/@\w+$/, ''); // strip @botname
+
+    // Known command
     if (COMMANDS.includes(cmd)) {
       return {
         type: 'command',
@@ -36,30 +40,29 @@ export function parseMessage (text) {
         args: parts.slice(1).join(' '),
       };
     }
-  }
 
-  // Check for @project/branch or @project prefix
-  const projectMatch = trimmed.match(/^@(\S+)\s+([\s\S]+)$/);
-  if (projectMatch) {
-    const target = projectMatch[1];
-    const taskText = projectMatch[2].trim();
+    // Not a known command → treat as /project[/branch] task
+    const projectMatch = trimmed.match(/^\/(\S+)\s+([\s\S]+)$/);
+    if (projectMatch) {
+      const target = projectMatch[1];
+      const taskText = projectMatch[2].trim();
 
-    // Split target into project and optional branch
-    const slashIndex = target.indexOf('/');
-    if (slashIndex > 0) {
+      const slashIndex = target.indexOf('/');
+      if (slashIndex > 0) {
+        return {
+          type: 'task',
+          project: target.substring(0, slashIndex),
+          branch: target.substring(slashIndex + 1),
+          text: taskText,
+        };
+      }
       return {
         type: 'task',
-        project: target.substring(0, slashIndex),
-        branch: target.substring(slashIndex + 1),
+        project: target,
+        branch: null,
         text: taskText,
       };
     }
-    return {
-      type: 'task',
-      project: target,
-      branch: null,
-      text: taskText,
-    };
   }
 
   // Plain text → default project
@@ -72,14 +75,14 @@ export function parseMessage (text) {
 }
 
 /**
- * Parse @project or @project/branch from command args.
- * Returns { project, branch } or null.
+ * Parse /project or /project/branch from command args.
+ * Returns { project, branch, rest } or null.
  */
 export function parseTarget (args) {
   if (!args) {
     return null;
   }
-  const match = args.trim().match(/^@(\S+)/);
+  const match = args.trim().match(/^\/(\S+)/);
   if (!match) {
     return null;
   }

package/listener/task-logger.js

@@ -49,7 +49,7 @@ export function createTaskLogger (logDir) {
       const ts = new Date().toISOString();
       const entry = `\n${'='.repeat(80)}\n`
         + `[${ts}] QUESTION\n`
-        + `Project: @${project}${branch && branch !== 'main' && branch !== 'master' ? '/' + branch : ''}\n`
+        + `Project: /${project}${branch && branch !== 'main' && branch !== 'master' ? '/' + branch : ''}\n`
         + `WorkDir: ${workDir}\n`
         + `Task: ${taskText}\n`;
       fs.appendFileSync(logPath, entry);

package/listener/worktree-manager.js

@@ -269,7 +269,7 @@ export class WorktreeManager {
 
     throw new Error(
       `Worktree "${branch}" not found for project "${projectAlias}". `
-      + `Create it: /worktree @${projectAlias} ${branch}`
+      + `Create it: /worktree /${projectAlias}/${branch}`
     );
   }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-notification-plugin",
   "productName": "claude-notification-plugin",
-  "version": "1.1.14",
+  "version": "1.1.15",
   "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
   "type": "module",
   "engines": {