clideck 1.30.2 → 1.30.3

package/plugins/autopilot/prompt.md

@@ -1,7 +1,7 @@
 You are an autonomous dispatcher for project: {{projectName}}.
 
 YOUR ROLE
-You control workflow routing between agents.
+You control workflow routing between agents to accomplish the session goal.
 You do not do the work yourself.
 You do not rewrite agent output.
 You do not send summaries, edits, or instructions of your own to agents.
@@ -9,23 +9,21 @@ The system forwards existing agent output verbatim. Your job is to choose the be
 
 IMPORTANT
 You are not a final judge of whether work is good or bad.
-But you must understand the project, the goals, the current state of the work, and what each agent is responsible for, so you can decide the best next routing move.
+But you must understand the project, the goals, the current state of the work, and what each agent is responsible for, so you can decide
+the best next routing move.
+You don't stop steering between agents until the seassion goal is complete or truly blocked. Do not stop to ask the user what to do next, just keep routing between agents until there is absolutely no way to proceed without user input, or until the task is complete.
 
 This means:
 - You should understand what the project is trying to achieve.
 - You should understand what each agent just produced.
 - You should understand what kind of specialist should act next.
 - You may decide that the next step is not the most obvious direct handoff if another specialist should look first.
-- Example: if a creative output needs analytical grounding, the right next move may be to route it to an analyst before routing it back to the creative.
-- Your task is not to judge quality for the team. Your task is to route work to the agent best positioned to move the project forward.
+- Example: if a creative output needs analytical grounding, the right next move may be to route it to an analyst before routing it back
+to the creative.
 
 AGENTS
 {{agents}}
 
-For each agent, treat their role description as the source of truth for:
-- what they are responsible for
-- what they should not do
-- what kind of outputs they should receive
 
 STATE
 You will receive structured workflow state describing:
@@ -38,26 +36,22 @@ You will receive structured workflow state describing:
 
 TOOLS
 - route(from, to): Forward one agent's existing output to another idle agent.
-- notify_user(reason): Stop autopilot and notify the user. Use light markdown: **bold** for key terms, `code` for file/function names, bullet lists for summaries. Keep it concise (2-5 sentences). Use ONLY when the work is naturally complete, truly blocked, or requires human input.
+- notify_user(reason): Stop autopilot and notify the user. Use light markdown: **bold** for key terms, `code` for file/function names,
+bullet lists for summaries. Keep it concise (2-5 sentences). Use ONLY when the work is naturally complete, truly blocked, or requires
+human input.
 
-RULES
+When calling `route(from, to)`, use the displayed agent labels exactly as shown in the AGENTS section and workflow state.
+
+STEERING RULES
 - Call exactly ONE tool per response.
 - Read the workflow state first, then read the agent outputs.
 - Prefer routing new output over previously routed output.
 - Use the project goal and current state to decide the best next specialist.
-- Use role responsibilities and restrictions when choosing the next receiver.
-- Do not route to an agent whose role makes the handoff inappropriate.
+- Use inferred responsibilities when choosing the next receiver.
+- Do not route to an agent whose inferred role makes the handoff inappropriate.
 - Do not invent new instructions for agents. You only choose who receives whose output.
 
-DO NOT USE notify_user UNLESS ABSOLUTELY NECESSARY
-- Do NOT ask the user if you should continue. Do NOT notify them with requests like "Please resume agent X" or "Should I keep going?" or "Is this a good stopping point?"
-- Do NOT alert the user that some agent asking for the user input before proceeding, this is not an execuse to stop and ask the user what to do. You should route the work to the next best agent until the workflow is truly blocked and cannot proceed without user input. (e.g. if the programmer ask for the user input, first make sure the reivewer or QA agent has not already reviewed the code, if not route it to them first)
-- The user may be away from the computer and expects the agents to keep working until the task is naturally complete.
-- You are autonomous. If you are unsure how to proceed, re-read the workflow state and the latest agent outputs, think differently, and route again.
-- Repeat agents with the same output if needed, unless the routing state shows that the same handoff is being repeated without progress.
-- You steer between agents until the task is complete or the user interrupts you, period. 
-
-HOW TO THINK
+STEERING DECISION-MAKING
 For each decision, reason in this order:
 1. What is the project trying to achieve right now?
 2. What changed most recently?
@@ -65,5 +59,13 @@ For each decision, reason in this order:
 4. Has this output already been consumed by that role?
 5. Is there a better intermediate handoff before sending it to the most obvious role?
 
+DO NOT USE notify_user UNLESS ABSOLUTELY NECESSARY
+- Do NOT ask the user if you should continue. Because you MUST continue until the task is complete or truly blocked, asking the user if you should continue is redundant, disruptive and a signed you failed to steer the workflow effectively.
+- Even if the agent ask for the user input, Do NOT alert the user unless you are 100% sure the workflow is truly blocked and cannot proceed without user input. Instead, continue steering between agents.
+- The user may be away from the computer and expects the agents to keep working until the task is naturally complete. stopping to ask for user input when the workflow can continue is disruptive and frustrating for the user.
+- You are autonomous. If you are unsure how to proceed, re-read the workflow state and the latest agent outputs, think differently, and
+route again.
+- One last time, to eliminate mistakes: You steer between agents until the task is complete or the user interrupts you, period.
+
 GOAL
 Keep the work moving until the task is complete or truly blocked, by routing each output to the most appropriate next agent.

package/public/index.html

@@ -147,9 +147,6 @@
     <button class="rail-btn w-9 h-9 flex items-center justify-center rounded-lg text-slate-500 hover:text-slate-300 hover:bg-slate-800/50 transition-colors" data-panel="prompts" title="Prompt Library">
       <svg class="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><path d="M14 2v6h6"/><path d="M16 13H8"/><path d="M16 17H8"/></svg>
     </button>
-    <button class="rail-btn w-9 h-9 flex items-center justify-center rounded-lg text-slate-500 hover:text-slate-300 hover:bg-slate-800/50 transition-colors" data-panel="roles" title="Roles">
-      <svg class="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M22 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/></svg>
-    </button>
     <button class="rail-btn w-9 h-9 flex items-center justify-center rounded-lg text-slate-500 hover:text-slate-300 hover:bg-slate-800/50 transition-colors" data-panel="plugins" title="Plugins">
       <svg class="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2v4m0 12v4M2 12h4m12 0h4"/><circle cx="12" cy="12" r="3"/><path d="M12 8V6m0 12v-2M8 12H6m12 0h-2"/></svg>
     </button>
@@ -200,8 +197,6 @@
     </div>
     <!-- Prompts panel (rendered by prompts.js) -->
     <div id="panel-prompts" class="hidden flex-col flex-1 min-h-0"></div>
-    <!-- Roles panel (rendered by roles.js) -->
-    <div id="panel-roles" class="hidden flex-col flex-1 min-h-0"></div>
     <!-- Plugins panel -->
     <div id="panel-plugins" class="hidden flex-col flex-1 min-h-0">
       <div class="flex items-center px-4 py-3 border-b border-slate-700/50">

package/public/js/app.js

@@ -12,7 +12,6 @@ import './nav.js';
 import { initDrag, wasDragging } from './drag.js';
 import { registerHotkey, unregisterHotkey, unregisterAllForPlugin } from './hotkeys.js';
 import { renderPrompts } from './prompts.js';
-import { renderRoles } from './roles.js';
 
 const shownAgentHealthToasts = new Set();
 let reconnectReplaySkip = null;
@@ -34,7 +33,6 @@ function connect() {
         regroupSessions();
         renderSettings();
         renderPrompts();
-        renderRoles();
         refreshCreator();
         for (const [, entry] of state.terms) applyTheme(entry.term, entry.themeId);
         break;
@@ -682,7 +680,7 @@ function openProjectCreator() {
   card.id = 'project-creator';
   card.className = 'p-3 border-b border-slate-700/50 bg-slate-800/30';
   card.innerHTML = `
-    <div class="text-[10px] font-semibold uppercase tracking-wider text-slate-500 mb-2">New Project</div>
+    <div class="text-[10px] font-semibold uppercase tracking-wider text-slate-500 mb-1.5">Project folder</div>
     <div class="flex items-center gap-1.5 mb-2">
       <input id="pc-path" type="text" value="${esc(defaultPath)}" placeholder="Project folder path"
         class="flex-1 px-3 py-1.5 text-xs bg-slate-900 border border-slate-700 rounded-md text-slate-400 placeholder-slate-600 outline-none focus:border-blue-500 transition-colors font-mono">
@@ -690,6 +688,9 @@ function openProjectCreator() {
         ${FOLDER_SVG}
       </button>
     </div>
+    <div class="text-[10px] font-semibold uppercase tracking-wider text-slate-500 mb-1.5">
+      Project name <span class="text-slate-600 font-medium normal-case tracking-normal">(auto-filled from folder name)</span>
+    </div>
     <input id="pc-name" type="text" maxlength="35" placeholder="Project name"
       class="w-full px-3 py-2 text-sm bg-slate-900 border border-slate-700 rounded-md text-slate-200 placeholder-slate-500 outline-none focus:border-blue-500 transition-colors mb-2">
     <div class="flex items-center gap-2">
@@ -1016,7 +1017,7 @@ function renderProjectActions() {
     if (!projId) continue;
     for (const action of actions) {
       const btn = document.createElement('button');
-      btn.className = 'project-plugin-action plugin-project-btn opacity-0 group-hover:opacity-100 text-slate-600 hover:text-indigo-400 flex-shrink-0 transition-opacity p-0.5';
+      btn.className = 'project-plugin-action plugin-project-btn text-slate-600 hover:text-indigo-400 flex-shrink-0 p-0.5';
       btn.title = action.title || '';
       btn.innerHTML = action.icon || '';
       btn.dataset.pluginId = action.pluginId;

package/public/js/creator.js

@@ -13,6 +13,7 @@ const ANIMALS = [
   'Dolphin', 'Lynx', 'Hawk', 'Raven', 'Otter', 'Panther', 'Crane', 'Bison',
 ];
 const MRU_KEY = 'termui-last-preset';
+const NO_PROJECT_VALUE = '__none__';
 const FOLDER_SVG = `<svg class="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/></svg>`;
 
 function randomName() {
@@ -96,7 +97,7 @@ function sortedPresets() {
   return [...agents, ...shell];
 }
 
-function createFromPreset(preset, sessionName, cwd, projectId, roleId) {
+function createFromPreset(preset, sessionName, cwd, projectId) {
   // Find existing command matching this preset
   let cmd = findCommandForPreset(preset);
   // Auto-create the command if it doesn't exist yet
@@ -121,7 +122,7 @@ function createFromPreset(preset, sessionName, cwd, projectId, roleId) {
     state.cfg.commands.push(cmd);
     send({ type: 'config.update', config: state.cfg });
   }
-  send({ type: 'create', commandId: cmd.id, name: sessionName, cwd, projectId: projectId || undefined, roleId: roleId || undefined, ...estimateSize() });
+  send({ type: 'create', commandId: cmd.id, name: sessionName, cwd, projectId: projectId || undefined, ...estimateSize() });
   localStorage.setItem(MRU_KEY, preset.presetId);
 }
 
@@ -144,26 +145,23 @@ export function openCreator() {
   card.className = 'p-3 border-b border-slate-700/50 bg-slate-800/30';
   card.innerHTML = `
     ${(state.cfg.projects?.length) ? `
+    <div class="text-[10px] font-semibold uppercase tracking-wider text-slate-500 mb-1.5">Select project</div>
     <input type="hidden" id="creator-project" value="">
     <button type="button" id="creator-project-trigger" class="w-full px-3 py-1.5 text-xs bg-slate-900 border border-slate-700 rounded-md text-slate-400 text-left flex items-center justify-between outline-none hover:border-slate-500 transition-colors cursor-pointer mb-2">
-      <span id="creator-project-label">Select project <span class="opacity-40">- optional</span></span>
+      <span id="creator-project-label">Select project</span>
       <span class="text-slate-600 ml-2">&#9662;</span>
     </button>` : ''}
-    ${(state.cfg.roles?.length) ? `
-    <input type="hidden" id="creator-role" value="">
-    <button type="button" id="creator-role-trigger" class="w-full px-3 py-1.5 text-xs bg-slate-900 border border-slate-700 rounded-md text-slate-400 text-left flex items-center justify-between outline-none hover:border-slate-500 transition-colors cursor-pointer mb-2">
-      <span id="creator-role-label">Select role <span class="opacity-40">- optional</span></span>
-      <span class="text-slate-600 ml-2">&#9662;</span>
-    </button>` : ''}
-    <input id="creator-name" type="text" maxlength="35" placeholder="Session / Agent name"
+    <div class="text-[10px] font-semibold uppercase tracking-wider text-slate-500 mb-1.5">Session name</div>
+    <input id="creator-name" type="text" maxlength="35" placeholder="Session name"
       class="w-full px-3 py-2 text-sm bg-slate-900 border border-slate-700 rounded-md text-slate-200 placeholder-slate-500 outline-none focus:border-blue-500 transition-colors mb-2">
-    <div class="flex items-center gap-1.5 mb-2">
+    <div id="creator-cwd-wrap" class="flex items-center gap-1.5 mb-2 ${(state.cfg.projects?.length) ? 'hidden' : ''}">
       <input id="creator-cwd" type="text" value="${esc(defaultPath)}" placeholder="Working directory"
         class="flex-1 px-3 py-1.5 text-xs bg-slate-900 border border-slate-700 rounded-md text-slate-400 placeholder-slate-600 outline-none focus:border-blue-500 transition-colors font-mono">
       <button id="creator-browse" class="flex-shrink-0 w-7 h-7 flex items-center justify-center rounded-md border border-slate-700 text-slate-500 hover:text-slate-300 hover:bg-slate-700 transition-colors" title="Browse">
         ${FOLDER_SVG}
       </button>
     </div>
+    <div class="text-[10px] font-semibold uppercase tracking-wider text-slate-500 mb-1.5">Choose agent provider</div>
     <div id="creator-presets" class="space-y-0.5">
       ${renderPresetButtons()}
     </div>`;
@@ -173,7 +171,10 @@ export function openCreator() {
 
   const nameInput = card.querySelector('#creator-name');
   const cwdInput = card.querySelector('#creator-cwd');
-  nameInput.focus();
+  const cwdWrap = card.querySelector('#creator-cwd-wrap');
+  const projHidden = card.querySelector('#creator-project');
+  const projTrigger = card.querySelector('#creator-project-trigger');
+  (projTrigger || nameInput).focus();
 
   nameInput.addEventListener('keydown', (e) => {
     if (e.key === 'Escape') closeCreator();
@@ -189,15 +190,33 @@ export function openCreator() {
   });
 
   // Project picker dropdown
-  const projTrigger = card.querySelector('#creator-project-trigger');
   if (projTrigger) {
+    const projects = [...(state.cfg.projects || [])].sort((a, b) => a.name.localeCompare(b.name, undefined, { sensitivity: 'base' }));
+    const projLabel = card.querySelector('#creator-project-label');
+    const setProjectSelection = (value) => {
+      projHidden.value = value;
+      const proj = projects.find(p => p.id === value);
+      if (proj) {
+        projLabel.textContent = proj.name;
+        cwdWrap.classList.add('hidden');
+        cwdInput.value = proj.path || defaultPath;
+        return;
+      }
+      if (value === NO_PROJECT_VALUE) {
+        projLabel.textContent = 'None (outside project hierarchy)';
+        cwdWrap.classList.remove('hidden');
+        cwdInput.value = cwdInput.value.trim() || defaultPath;
+        return;
+      }
+      projLabel.textContent = 'Select project';
+      cwdWrap.classList.add('hidden');
+      cwdInput.value = defaultPath;
+    };
+
     let projMenuCleanup = null;
     projTrigger.addEventListener('click', () => {
       if (projMenuCleanup) { projMenuCleanup(); return; }
       const rect = projTrigger.getBoundingClientRect();
-      const hidden = card.querySelector('#creator-project');
-      const label = card.querySelector('#creator-project-label');
-      const projects = state.cfg.projects || [];
 
       const menu = document.createElement('div');
       menu.className = 'fixed z-[500] bg-slate-800 border border-slate-600 rounded-lg shadow-xl shadow-black/40 py-1 overflow-y-auto';
@@ -207,9 +226,9 @@ export function openCreator() {
       menu.style.width = rect.width + 'px';
 
       menu.innerHTML = `
-        <div class="proj-option px-3 py-1.5 cursor-pointer hover:bg-slate-700 transition-colors text-xs text-slate-400 ${!hidden.value ? 'bg-slate-700/50' : ''}" data-value="">None</div>
+        <div class="proj-option px-3 py-1.5 cursor-pointer hover:bg-slate-700 transition-colors text-xs text-slate-400 ${projHidden.value === NO_PROJECT_VALUE ? 'bg-slate-700/50' : ''}" data-value="${NO_PROJECT_VALUE}">None (outside project hierarchy)</div>
         ${projects.map(p => `
-          <div class="proj-option flex items-center gap-2 px-3 py-1.5 cursor-pointer hover:bg-slate-700 transition-colors text-xs text-slate-300 ${hidden.value === p.id ? 'bg-slate-700/50' : ''}" data-value="${p.id}">
+          <div class="proj-option flex items-center gap-2 px-3 py-1.5 cursor-pointer hover:bg-slate-700 transition-colors text-xs text-slate-300 ${projHidden.value === p.id ? 'bg-slate-700/50' : ''}" data-value="${p.id}">
             <span class="w-2 h-2 rounded-full flex-shrink-0" style="background:${p.color || '#3b82f6'}"></span>
             ${esc(p.name)}
           </div>`).join('')}`;
@@ -219,12 +238,7 @@ export function openCreator() {
       const onClick = (e) => {
         const item = e.target.closest('.proj-option');
         if (!item) return;
-        hidden.value = item.dataset.value;
-        const proj = projects.find(p => p.id === item.dataset.value);
-        label.innerHTML = proj ? esc(proj.name) : 'Select project <span class="opacity-40">- optional</span>';
-        // Auto-set working directory from project path
-        if (proj?.path) cwdInput.value = proj.path;
-        else cwdInput.value = defaultPath;
+        setProjectSelection(item.dataset.value);
         projMenuCleanup();
       };
       const onOutside = (e) => {
@@ -242,64 +256,6 @@ export function openCreator() {
     });
   }
 
-  // Role picker dropdown
-  const roleTrigger = card.querySelector('#creator-role-trigger');
-  if (roleTrigger) {
-    let roleMenuCleanup = null;
-    roleTrigger.addEventListener('click', () => {
-      if (roleMenuCleanup) { roleMenuCleanup(); return; }
-      const rect = roleTrigger.getBoundingClientRect();
-      const hidden = card.querySelector('#creator-role');
-      const label = card.querySelector('#creator-role-label');
-      const roles = state.cfg.roles || [];
-
-      const menu = document.createElement('div');
-      menu.className = 'fixed z-[500] bg-slate-800 border border-slate-600 rounded-lg shadow-xl shadow-black/40 py-1 overflow-y-auto';
-      menu.style.maxHeight = '200px';
-      menu.style.left = rect.left + 'px';
-      menu.style.top = (rect.bottom + 4) + 'px';
-      menu.style.width = rect.width + 'px';
-
-      menu.innerHTML = `
-        <div class="role-option px-3 py-1.5 cursor-pointer hover:bg-slate-700 transition-colors text-xs text-slate-400 ${!hidden.value ? 'bg-slate-700/50' : ''}" data-value="" data-name="">None</div>
-        ${roles.map(r => `
-          <div class="role-option px-3 py-1.5 cursor-pointer hover:bg-slate-700 transition-colors text-xs text-slate-300 ${hidden.value === r.id ? 'bg-slate-700/50' : ''}" data-value="${r.id}" data-name="${esc(r.name)}">
-            ${esc(r.name)}
-          </div>`).join('')}`;
-
-      document.body.appendChild(menu);
-
-      const onClick = (e) => {
-        const item = e.target.closest('.role-option');
-        if (!item) return;
-        hidden.value = item.dataset.value;
-        const roleName = item.dataset.name;
-        label.innerHTML = roleName ? esc(roleName) : 'Select role <span class="opacity-40">- optional</span>';
-        // Auto-fill session name from role name (only if user hasn't typed a custom name)
-        if (roleName && (!nameInput.value.trim() || nameInput.dataset.autoFilled === '1')) {
-          nameInput.value = roleName;
-          nameInput.dataset.autoFilled = '1';
-        }
-        if (!item.dataset.value) nameInput.dataset.autoFilled = '';
-        roleMenuCleanup();
-      };
-      const onOutside = (e) => {
-        if (!menu.contains(e.target) && !roleTrigger.contains(e.target)) roleMenuCleanup();
-      };
-      menu.addEventListener('click', onClick);
-      requestAnimationFrame(() => document.addEventListener('click', onOutside));
-
-      roleMenuCleanup = () => {
-        menu.removeEventListener('click', onClick);
-        document.removeEventListener('click', onOutside);
-        menu.remove();
-        roleMenuCleanup = null;
-      };
-    });
-    // Clear auto-fill flag when user manually types
-    nameInput.addEventListener('input', () => { nameInput.dataset.autoFilled = ''; });
-  }
-
   // "Add" button for missing agents — opens install toaster
   card.addEventListener('click', (e) => {
     const installBtn = e.target.closest('.install-btn');
@@ -325,13 +281,15 @@ export function openCreator() {
     if (!btn) return;
     const preset = state.presets.find(p => p.presetId === btn.dataset.preset);
     if (!preset) return;
+    if (projTrigger && !projHidden.value) {
+      showToast('Choose a project or select `None (outside project hierarchy)`.', { title: 'Choose Project', type: 'warn' });
+      projTrigger.focus();
+      return;
+    }
     const name = nameInput.value.trim() || fallbackName;
     const cwd = cwdInput.value.trim() || undefined;
-    const projectSelect = card.querySelector('#creator-project');
-    const projectId = projectSelect?.value || undefined;
-    const roleSelect = card.querySelector('#creator-role');
-    const roleId = roleSelect?.value || undefined;
-    createFromPreset(preset, name, cwd, projectId, roleId);
+    const projectId = projHidden?.value && projHidden.value !== NO_PROJECT_VALUE ? projHidden.value : undefined;
+    createFromPreset(preset, name, cwd, projectId);
     closeCreator();
   });
 }

package/public/js/nav.js

@@ -1,8 +1,8 @@
 import { closeThemeMenu } from './settings.js';
 import { closeDropdown } from './prompts.js';
 
-const ALL_PANELS = ['chats', 'prompts', 'roles', 'plugins', 'settings'];
-const PANEL_TITLES = { chats: 'Sessions', prompts: 'Prompts', roles: 'Roles', plugins: 'Plugins', settings: 'Settings' };
+const ALL_PANELS = ['chats', 'prompts', 'plugins', 'settings'];
+const PANEL_TITLES = { chats: 'Sessions', prompts: 'Prompts', plugins: 'Plugins', settings: 'Settings' };
 const ACTIVE = ['text-slate-200', 'bg-slate-800'];
 const INACTIVE = ['text-slate-500', 'hover:text-slate-300', 'hover:bg-slate-800/50'];
 

package/public/js/terminals.js

@@ -3,6 +3,7 @@ import { esc, miniMarkdown, resolveIconPath } from './utils.js';
 import { resolveTheme, resolveAccent, applyTheme } from './profiles.js';
 import { attachToTerminal, registerHotkey } from './hotkeys.js';
 import { closeDropdown } from './prompts.js';
+import { showToast } from './toast.js';
 function isLightBg(themeId) {
   const bg = resolveTheme(themeId)?.background;
   if (!bg || bg[0] !== '#') return false;
@@ -119,27 +120,68 @@ function positionMenu(menu, anchorRect) {
   menu.style.visibility = 'hidden';
   document.body.appendChild(menu);
   const mh = menu.offsetHeight;
+  const mw = menu.offsetWidth;
   const gap = 4;
   const spaceBelow = window.innerHeight - anchorRect.bottom - gap;
+  const left = Math.min(
+    Math.max(gap, anchorRect.left),
+    Math.max(gap, window.innerWidth - mw - gap)
+  );
   menu.style.top = (spaceBelow >= mh
     ? anchorRect.bottom + gap
     : Math.max(gap, anchorRect.top - gap - mh)) + 'px';
-  menu.style.right = (window.innerWidth - anchorRect.right) + 'px';
+  menu.style.left = left + 'px';
   menu.style.visibility = '';
 }
 
-function openMenu(sessionId, anchorEl) {
+function pointRect(x, y) {
+  return { top: y, bottom: y, left: x, right: x };
+}
+
+async function copyTerminalSelection(sessionId) {
+  const entry = state.terms.get(sessionId);
+  const text = entry?.term?.getSelection() || '';
+  if (!text) return;
+  try {
+    await navigator.clipboard.writeText(text);
+  } catch {
+    showToast('Clipboard write failed.', { type: 'error' });
+  }
+}
+
+async function pasteIntoTerminal(sessionId) {
+  try {
+    const text = await navigator.clipboard.readText();
+    if (text) send({ type: 'input', id: sessionId, data: text });
+  } catch {
+    showToast('Clipboard read failed.', { type: 'error' });
+  }
+}
+
+function openMenu(sessionId, anchor) {
   closeMenu();
 
-  const rect = anchorEl.getBoundingClientRect();
+  const rect = anchor?.getBoundingClientRect ? anchor.getBoundingClientRect() : pointRect(anchor.x, anchor.y);
   const menu = document.createElement('div');
   menu.className = 'fixed z-[400] min-w-[160px] bg-slate-800 border border-slate-700 rounded-lg shadow-xl shadow-black/40 py-1';
 
   const entry = state.terms.get(sessionId);
   const projects = state.cfg.projects || [];
+  const hasSelection = !!entry?.term?.hasSelection();
 
   let html = '';
 
+  html += `
+    <button class="menu-action flex items-center gap-2.5 w-full px-3 py-2 text-sm ${hasSelection ? 'text-slate-300 hover:bg-slate-700' : 'text-slate-600 cursor-default'} transition-colors text-left" data-action="copy" ${hasSelection ? '' : 'disabled'}>
+      <span class="flex-shrink-0 text-slate-400"><svg class="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg></span>
+      Copy
+    </button>
+    <button class="menu-action flex items-center gap-2.5 w-full px-3 py-2 text-sm text-slate-300 hover:bg-slate-700 transition-colors text-left" data-action="paste">
+      <span class="flex-shrink-0 text-slate-400"><svg class="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><path d="M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2v-2"/><path d="M8 2h6a2 2 0 0 1 2 2v6H8a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2Z"/><path d="M8 10v4"/><path d="M12 14H4a2 2 0 0 0-2 2v2"/></svg></span>
+      Paste
+    </button>
+    <div class="border-t border-slate-700/50 my-1"></div>`;
+
   // Project submenu items
   if (projects.length) {
     html += `<div class="px-3 py-1 text-[10px] font-semibold uppercase tracking-wider text-slate-600">Move to project</div>`;
@@ -187,12 +229,16 @@ function openMenu(sessionId, anchorEl) {
   menu.innerHTML = html;
   positionMenu(menu, rect);
 
-  const onClick = (e) => {
+  const onClick = async (e) => {
     const btn = e.target.closest('.menu-action');
     if (!btn) return;
     closeMenu();
     const action = btn.dataset.action;
-    if (action === 'rename') {
+    if (action === 'copy') {
+      await copyTerminalSelection(sessionId);
+    } else if (action === 'paste') {
+      await pasteIntoTerminal(sessionId);
+    } else if (action === 'rename') {
       startRename(sessionId);
     } else if (action === 'mute') {
       toggleMute(sessionId);
@@ -417,6 +463,14 @@ export function addTerminal(id, name, themeId, commandId, projectId, muted, last
 
   term.open(el);
   attachToTerminal(term, presetId);
+  const onContextMenu = (e) => {
+    if (e.shiftKey) return;
+    e.preventDefault();
+    e.stopPropagation();
+    select(id);
+    openMenu(id, { x: e.clientX, y: e.clientY });
+  };
+  el.addEventListener('contextmenu', onContextMenu);
   let fitted = false, pending = [];
   // [FIT-GUARD] only call fit() when proposed dimensions actually change — prevents
   // unnecessary buffer reflows that cause scrollbar jumpiness on sub-pixel layout shifts
@@ -461,7 +515,7 @@ export function addTerminal(id, name, themeId, commandId, projectId, muted, last
     }
   }, 500);
   const cancelFitRaf = () => { if (fitRaf) { cancelAnimationFrame(fitRaf); fitRaf = 0; } };
-  state.terms.set(id, { term, fit, el, ro, cancelFitRaf, themeId, commandId, presetId: presetId || null, projectId: projectId || null, muted: !!muted, working: false, workStartedAt: null, stopBounce, queue: (data) => { if (!fitted) { pending.push(data); return true; } return false; }, lastActivityAt: Date.now(), unread: false, lastPreviewText: lastPreview || '', searchText: '' });
+  state.terms.set(id, { term, fit, el, ro, cancelFitRaf, onContextMenu, themeId, commandId, presetId: presetId || null, projectId: projectId || null, muted: !!muted, working: false, workStartedAt: null, stopBounce, queue: (data) => { if (!fitted) { pending.push(data); return true; } return false; }, lastActivityAt: Date.now(), unread: false, lastPreviewText: lastPreview || '', searchText: '' });
   document.getElementById('empty').style.display = 'none';
   document.getElementById('terminals').style.pointerEvents = '';
   if (muted) requestAnimationFrame(() => updateMuteIndicator(id));
@@ -475,6 +529,7 @@ export function removeTerminal(id) {
   if (entry.stopBounce) entry.stopBounce();
   entry.cancelFitRaf?.();
   entry.ro?.disconnect();
+  entry.el.removeEventListener?.('contextmenu', entry.onContextMenu);
   entry.term.dispose();
   entry.el.remove();
   state.terms.delete(id);
@@ -823,11 +878,11 @@ export function regroupSessions() {
         <span class="w-2 h-2 rounded-full flex-shrink-0" style="background:${projectColor(proj)}"></span>
         <span class="project-name flex-1 text-[11px] font-semibold uppercase tracking-wider text-slate-500 truncate">${esc(proj.name)}</span>
         <span class="project-count text-[10px] text-slate-600">0</span>
-        <button class="project-path-btn opacity-0 group-hover:opacity-100 ${proj.path ? 'text-slate-600 hover:text-slate-300' : 'text-slate-700 cursor-default'} flex-shrink-0 transition-opacity p-0.5" title="${proj.path ? 'Open project folder' : 'Project path not set'}" ${proj.path ? '' : 'disabled'}>
+        <button class="project-path-btn ${proj.path ? 'text-slate-600 hover:text-slate-300' : 'text-slate-700 cursor-default'} flex-shrink-0 p-0.5" title="${proj.path ? 'Open project folder' : 'Project path not set'}" ${proj.path ? '' : 'disabled'}>
           ${PATH_SVG}
         </button>
         <span class="project-plugin-actions"></span>
-        <button class="project-menu-btn opacity-0 group-hover:opacity-100 text-slate-600 hover:text-slate-400 flex-shrink-0 transition-opacity p-0.5" title="Project menu">
+        <button class="project-menu-btn text-slate-600 hover:text-slate-400 flex-shrink-0 p-0.5" title="Project menu">
           <svg class="w-3.5 h-3.5" fill="none" viewBox="0 0 20 20"><circle cx="10" cy="4" r="1.5" fill="currentColor"/><circle cx="10" cy="10" r="1.5" fill="currentColor"/><circle cx="10" cy="16" r="1.5" fill="currentColor"/></svg>
         </button>
       </div>