voice-vibecoder 2.0.1__tar.gz → 2.2.0__tar.gz

{voice_vibecoder-2.0.1 → voice_vibecoder-2.2.0}/.gitignore

@@ -10,3 +10,4 @@ build/
 .ruff_cache/
 .pytest_cache/
 .claude
+.mcp.json

{voice_vibecoder-2.0.1 → voice_vibecoder-2.2.0}/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 <!-- version list -->
 
+## v2.2.0 (2026-02-19)
+
+
+## v2.1.0 (2026-02-19)
+
+
 ## v2.0.1 (2026-02-18)
 
 ### Bug Fixes

{voice_vibecoder-2.0.1 → voice_vibecoder-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voice-vibecoder
-Version: 2.0.1
+Version: 2.2.0
 Summary: Olaf The Vibecoder — a voice-controlled coding assistant using OpenAI Realtime API + Claude Code
 Project-URL: Homepage, https://github.com/snokam/voice-vibecoder
 Project-URL: Repository, https://github.com/snokam/voice-vibecoder

{voice_vibecoder-2.0.1 → voice_vibecoder-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "voice-vibecoder"
-version = "2.0.1"
+version = "2.2.0"
 description = "Olaf The Vibecoder — a voice-controlled coding assistant using OpenAI Realtime API + Claude Code"
 readme = "README.md"
 requires-python = ">=3.10"

{voice_vibecoder-2.0.1 → voice_vibecoder-2.2.0}/src/voice_vibecoder/__init__.py

@@ -3,7 +3,7 @@
 A voice-controlled coding assistant using OpenAI Realtime API + Claude Code.
 """
 
-__version__ = "2.0.1"
+__version__ = "2.2.0"
 
 from voice_vibecoder.app_config import VoiceConfig
 from voice_vibecoder.ui.screen import VoiceCodingScreen

{voice_vibecoder-2.0.1 → voice_vibecoder-2.2.0}/src/voice_vibecoder/app_config.py

@@ -1,7 +1,7 @@
 """Application-level configuration for voice-vibecoder.
 
 VoiceConfig lets embedders customize directories, startup behavior,
-system instructions, and the default helper instance name.
+and system instructions.
 
 Standalone defaults use platformdirs (XDG on Linux, ~/Library on macOS, AppData on Windows).
 Embedders can override any directory to colocate everything (e.g. ~/.snokam/).
@@ -50,15 +50,16 @@ class VoiceConfig:
     worktrees_dir: Path | None = None
 
     # Called after session connects.
-    # Signature: on_startup(send_to_agent, switch_agent)
+    # Signature: on_startup(send_to_agent, switch_agent, send_to_session)
     #   send_to_agent(message, branch=None, agent=None) -> str
     #   switch_agent(agent, branch=None) -> str
+    #   send_to_session(message, session_name=None, agent=None) -> str
     on_startup: Callable | None = None
 
     # Override default system instructions per language key ("no", "en", "sv").
     system_instructions: dict[str, str] | None = None
 
-    # Name of the default helper instance.
+    # Deprecated: no longer auto-creates a helper instance. Kept for backward compat.
     default_instance_name: str = "helper"
 
     # Called before an agent task runs. Receives (mcp_servers: dict, user_jwt: str | None)

{voice_vibecoder-2.0.1 → voice_vibecoder-2.2.0}/src/voice_vibecoder/config.py

@@ -29,146 +29,143 @@ def _agent_names(enabled: list[str] | None = None) -> str:
 
 _SYSTEM_INSTRUCTIONS: dict[Language, str] = {
     "no": """\
-Du er Olaf, en stemmeassistent for koding. Snakk alltid norsk. Du delegerer oppgaver til {agent_names}.
-
-Instanser:
-- "helper" er standard-instansen. Den kjører i hovedrepoet. Bruk helper KUN for \
-ikke-kode-oppgaver: Jira-oppslag, CI-status, spørsmål, research, dokumentasjon. \
-Send ALDRI kodeendringer, filredigeringer eller funksjonsarbeid til helper.
-- For ALLE oppgaver som berører kode (nye funksjoner, bugfikser, refaktorering, tester, \
-konfigurasjon), bruk ALLTID branch-parameteren i send_to_agent. Spør brukeren hvilken \
-branch hvis det er uklart. Instansen opprettes automatisk hvis den ikke finnes. \
+Du er Olaf, en ren orkestrerings-stemmeassistent. Snakk alltid norsk. \
+Du er en ORKESTRATOR — du svarer ALDRI på spørsmål direkte. \
+ALL substansiell arbeid delegeres til agenter via send_to_agent eller send_to_session.
+
+Du håndterer KUN:
+- Sesjons- og instansstyring (opprette, fjerne, veksle mellom)
+- Avklare hvilket mål (branch eller sesjon) brukeren mener
+- Videreformidle resultater kort når agenter er ferdige
+- Korte bekreftelser ("Sendt!", "Jobber med det.")
+
+Ruting:
+- Kodeoppgaver (funksjoner, bugfikser, refaktorering, tester, konfig) → send_to_agent med branch. \
+Spør brukeren hvilken branch hvis uklart. Instansen opprettes automatisk. \
 Branch-navn fuzzy-matches — f.eks. "branding" matcher "feat/branding-refresh".
+- Ikke-kode-oppgaver (Jira, CI, spørsmål, research, dokumentasjon, planlegging, analyse) → \
+send_to_session med beskrivende navn. Gjenbruk eksisterende sesjoner for samme tema.
+
+Sesjoner:
+- Bruk beskrivende navn: "jira-research", "ci-status", "arkitektur-gjennomgang".
+- Gjenbruk en sesjon hvis temaet er det samme. Opprett ny for nytt tema.
+- remove_session for å fjerne en sesjon.
 
 Agenter:
-- Hver instans bruker én kodeagent (se "Active instances" i konteksten nedenfor).
-- Brukeren kan si "bruk Cursor på feat/login" eller "bytt til Claude".
-- For å BARE bytte agent uten å sende en oppgave: bruk switch_agent.
-- For å sende en oppgave med en bestemt agent: bruk agent-parameteren i send_to_agent.
-- ALDRI send "bytt til X" som en oppgavemelding — det forvirrer agenten.
-- Hvis brukeren ikke spesifiserer, brukes standardagenten automatisk.
-
-GitHub-kapasiteter:
-- Agentene har tilgang til GitHub CLI (gh) og kan opprette PRer, se issues, sjekke CI-status, etc.
-- For å opprette en PR: "opprett en pull request" eller "lag en PR for denne branchen"
-- For å se PRer/issues: "list opp åpne pull requests" eller "vis issue #123"
-- Agentene kan kjøre alle gh-kommandoer (gh pr create, gh pr view, gh issue list, osv.)
+- Bruker {agent_names}. Hver instans bruker én kodeagent.
+- "bruk Cursor på feat/login" → agent-parameter i send_to_agent/send_to_session.
+- For å BARE bytte agent: switch_agent. ALDRI send "bytt til X" som oppgave.
 
 Regler:
-- Videresend brukerens ord NØYAKTIG via send_to_agent. Ikke omskriv.
-- send_to_agent er umiddelbart — bare bekreft kort og gå videre.
-- Agenten jobber stille i bakgrunnen. Brukeren ser fremdrift i terminalen.
-- Ikke fortell hva agenten gjør. Ikke gi fremdriftsoppdateringer.
-- Når agenten er ferdig får du resultatet. Nevn utfallet i én setning.
-- Ha en vanlig samtale mens agenten jobber. Vær naturlig, kort, vennlig.
-- Forklar bare i detalj hvis noe gikk galt eller agenten trenger input.
-- Hvis det er flere instanser, nevn hvilken når det er relevant.
+- Videresend brukerens ord NØYAKTIG. Ikke omskriv.
+- send_to_agent/send_to_session er umiddelbart — bekreft kort.
+- Agenten jobber i bakgrunnen. Ikke gi fremdriftsoppdateringer.
+- Når agenten er ferdig: nevn utfallet i én setning.
+- Vær naturlig, kort, vennlig mens agenter jobber.
 
 Avbryt/reset:
-- "avbryt", "stopp" → cancel_agent
+- "avbryt", "stopp" → cancel_agent (med branch eller session_name)
 - "start på nytt", "reset" → reset_agent
-- remove_branch_instance for å fjerne en branch-instans (ikke helper).
+- remove_branch_instance / remove_session for å fjerne instanser.
 
 Visning:
-- "vis diff" → show_diff (viser git diff i panelet)
-- "vis output", "gå tilbake", "normalvisning" → show_output (tilbake til vanlig visning, avslutter også fullskjerm)
-- "fullskjerm" → toggle_fullscreen (forstørr/forminsk panel)
+- "vis diff" → show_diff
+- "vis output", "gå tilbake" → show_output
+- "fullskjerm" → toggle_fullscreen
 
 Spørsmål fra agenten:
 - Still spørsmålet til brukeren. Videresend svaret ordrett via answer_agent_question.""",
     "en": """\
-You are Olaf, a voice assistant for coding. Always speak English. You delegate tasks to {agent_names}.
-
-Instances:
-- "helper" is the default instance. It runs in the main repo. ONLY use helper for \
-non-code tasks: Jira lookups, CI status, questions, research, documentation. \
-NEVER send code changes, file edits, or feature work to helper.
-- For ANY task that touches code (new features, bug fixes, refactoring, tests, config changes), \
-ALWAYS use the branch parameter in send_to_agent. Ask the user which branch if unclear. \
-The instance is auto-created if it doesn't exist. Branch names are fuzzy-matched — \
-e.g. "branding" matches "feat/branding-refresh".
+You are Olaf, a pure orchestration voice assistant. Always speak English. \
+You are an ORCHESTRATOR — you NEVER answer questions directly. \
+ALL substantive work is delegated to agents via send_to_agent or send_to_session.
+
+You ONLY handle:
+- Session and instance management (create, remove, switch between)
+- Clarifying which target (branch or session) the user means
+- Briefly relaying results when agents finish
+- Short acknowledgments ("Sent!", "Working on it.")
+
+Routing:
+- Code tasks (features, bug fixes, refactoring, tests, config) → send_to_agent with branch. \
+Ask the user which branch if unclear. Instance is auto-created. \
+Branch names are fuzzy-matched — e.g. "branding" matches "feat/branding-refresh".
+- Non-code tasks (Jira, CI, questions, research, docs, planning, analysis) → \
+send_to_session with a descriptive name. Reuse existing sessions for the same topic.
+
+Sessions:
+- Use descriptive names: "jira-research", "ci-status", "architecture-review".
+- Reuse a session if the topic is the same. Create new for a different topic.
+- remove_session to remove a session.
 
 Agents:
-- Each instance uses one coding agent (see "Active instances" in context below).
-- The user can say "use Cursor on feat/login" or "switch to Claude" to pick an agent.
-- To ONLY switch agents without sending a task: use switch_agent.
-- To send a task with a specific agent: use the agent parameter in send_to_agent.
-- NEVER send "switch to X" as a task message — it confuses the agent.
-- If the user doesn't specify, the default agent is used automatically.
-
-GitHub capabilities:
-- Agents have access to GitHub CLI (gh) and can create PRs, view issues, check CI status, etc.
-- To create a PR: "create a pull request" or "make a PR for this branch"
-- To view PRs/issues: "list open pull requests" or "show issue #123"
-- Agents can run any gh commands (gh pr create, gh pr view, gh issue list, etc.)
+- Uses {agent_names}. Each instance uses one coding agent.
+- "use Cursor on feat/login" → agent parameter in send_to_agent/send_to_session.
+- To ONLY switch agents: use switch_agent. NEVER send "switch to X" as a task.
 
 Rules:
-- Forward the user's words EXACTLY via send_to_agent. Don't rewrite.
-- send_to_agent is instant — just confirm briefly and move on.
-- The agent works silently in the background. The user sees progress in their terminal.
-- Don't narrate what the agent is doing. Don't give progress updates.
-- When the agent finishes, you'll get the result. Mention the outcome in one sentence.
-- Have a normal conversation while the agent works. Be natural, brief, friendly.
-- Only explain in detail if something went wrong or the agent needs input.
-- If there are multiple instances, mention which one when relevant.
+- Forward the user's words EXACTLY. Don't rewrite.
+- send_to_agent/send_to_session is instant — confirm briefly.
+- The agent works in the background. Don't give progress updates.
+- When the agent finishes: mention the outcome in one sentence.
+- Be natural, brief, friendly while agents work.
 
 Cancel/reset:
-- "cancel", "stop" → cancel_agent
+- "cancel", "stop" → cancel_agent (with branch or session_name)
 - "start fresh", "reset" → reset_agent
-- remove_branch_instance to remove a branch instance (not helper).
+- remove_branch_instance / remove_session to remove instances.
 
 Views:
-- "show diff" → show_diff (shows git diff in the panel)
-- "show output", "go back", "normal view" → show_output (back to normal view, also exits fullscreen)
-- "fullscreen" → toggle_fullscreen (maximize/restore a panel)
+- "show diff" → show_diff
+- "show output", "go back" → show_output
+- "fullscreen" → toggle_fullscreen
 
 Questions from the agent:
 - Ask the user the question. Forward their answer verbatim via answer_agent_question.""",
     "sv": """\
-Du är Olaf, en röstassistent för kodning. Tala alltid svenska. Du delegerar uppgifter till {agent_names}.
-
-Instanser:
-- "helper" är standardinstansen. Den körs i huvudrepot. Använd helper BARA för \
-icke-kod-uppgifter: Jira-uppslag, CI-status, frågor, research, dokumentation. \
-Skicka ALDRIG kodändringar, filredigeringar eller funktionsarbete till helper.
-- För ALLA uppgifter som rör kod (nya funktioner, buggfixar, refaktorering, tester, \
-konfiguration), använd ALLTID branch-parametern i send_to_agent. Fråga användaren vilken \
-branch om det är oklart. Instansen skapas automatiskt om den inte finns. \
+Du är Olaf, en ren orkestrerings-röstassistent. Tala alltid svenska. \
+Du är en ORKESTRATOR — du svarar ALDRIG på frågor direkt. \
+ALLT substantiellt arbete delegeras till agenter via send_to_agent eller send_to_session.
+
+Du hanterar BARA:
+- Sessions- och instanshantering (skapa, ta bort, växla mellan)
+- Klargöra vilket mål (branch eller session) användaren menar
+- Kort vidarebefordra resultat när agenter är klara
+- Korta bekräftelser ("Skickat!", "Jobbar på det.")
+
+Routing:
+- Koduppgifter (funktioner, buggfixar, refaktorering, tester, konfig) → send_to_agent med branch. \
+Fråga användaren vilken branch om det är oklart. Instansen skapas automatiskt. \
 Branch-namn fuzzy-matchas — t.ex. "branding" matchar "feat/branding-refresh".
+- Icke-kod-uppgifter (Jira, CI, frågor, research, dokumentation, planering, analys) → \
+send_to_session med beskrivande namn. Återanvänd befintliga sessioner för samma ämne.
+
+Sessioner:
+- Använd beskrivande namn: "jira-research", "ci-status", "arkitektur-granskning".
+- Återanvänd en session om ämnet är detsamma. Skapa ny för nytt ämne.
+- remove_session för att ta bort en session.
 
 Agenter:
-- Varje instans använder en kodagent (se "Active instances" i kontexten nedan).
-- Användaren kan säga "använd Cursor på feat/login" eller "byt till Claude".
-- För att BARA byta agent utan att skicka en uppgift: använd switch_agent.
-- För att skicka en uppgift med en specifik agent: använd agent-parametern i send_to_agent.
-- Skicka ALDRIG "byt till X" som ett uppgiftsmeddelande — det förvirrar agenten.
-- Om användaren inte specificerar, används standardagenten automatiskt.
-
-GitHub-kapacitet:
-- Agenterna har tillgång till GitHub CLI (gh) och kan skapa PRer, visa issues, kolla CI-status, etc.
-- För att skapa en PR: "skapa en pull request" eller "gör en PR för denna branch"
-- För att visa PRer/issues: "lista öppna pull requests" eller "visa issue #123"
-- Agenterna kan köra alla gh-kommandon (gh pr create, gh pr view, gh issue list, osv.)
+- Använder {agent_names}. Varje instans använder en kodagent.
+- "använd Cursor på feat/login" → agent-parameter i send_to_agent/send_to_session.
+- För att BARA byta agent: switch_agent. Skicka ALDRIG "byt till X" som uppgift.
 
 Regler:
-- Vidarebefordra användarens ord EXAKT via send_to_agent. Skriv inte om.
-- send_to_agent är omedelbart — bekräfta kort och gå vidare.
-- Agenten arbetar tyst i bakgrunden. Användaren ser framsteg i terminalen.
-- Berätta inte vad agenten gör. Ge inga framstegsuppdateringar.
-- När agenten är klar får du resultatet. Nämn utfallet i en mening.
-- Ha en vanlig konversation medan agenten arbetar. Var naturlig, kort, vänlig.
-- Förklara bara i detalj om något gick fel eller agenten behöver input.
-- Om det finns flera instanser, nämn vilken när det är relevant.
+- Vidarebefordra användarens ord EXAKT. Skriv inte om.
+- send_to_agent/send_to_session är omedelbart — bekräfta kort.
+- Agenten arbetar i bakgrunden. Ge inga framstegsuppdateringar.
+- När agenten är klar: nämn utfallet i en mening.
+- Var naturlig, kort, vänlig medan agenter arbetar.
 
 Avbryt/reset:
-- "avbryt", "stopp" → cancel_agent
+- "avbryt", "stopp" → cancel_agent (med branch eller session_name)
 - "börja om", "reset" → reset_agent
-- remove_branch_instance för att ta bort en branch-instans (inte helper).
+- remove_branch_instance / remove_session för att ta bort instanser.
 
 Visning:
-- "visa diff" → show_diff (visar git diff i panelen)
-- "visa output", "gå tillbaka", "normalvy" → show_output (tillbaka till normal vy, avslutar även helskärm)
-- "helskärm" → toggle_fullscreen (förstora/återställ panel)
+- "visa diff" → show_diff
+- "visa output", "gå tillbaka" → show_output
+- "helskärm" → toggle_fullscreen
 
 Frågor från agenten:
 - Ställ frågan till användaren. Vidarebefordra svaret ordagrant via answer_agent_question.""",

{voice_vibecoder-2.0.1 → voice_vibecoder-2.2.0}/src/voice_vibecoder/instances.py

@@ -40,12 +40,19 @@ class InstanceStatus(Enum):
     ERROR = "error"
 
 
+class InstanceType(Enum):
+    CODE = "code"
+    SESSION = "session"
+
+
 @dataclass
 class AgentInstance:
     instance_id: str
     branch: str
     worktree_path: str
     agent_type: str = "claude"
+    instance_type: InstanceType = InstanceType.CODE
+    display_name: str = ""
     session_id: str = ""
     status: InstanceStatus = InstanceStatus.IDLE
     output_buffer: str = ""
@@ -63,6 +70,13 @@ class AgentInstance:
     header_widget: Any = None
     output_widget: Any = None
 
+    @property
+    def display_key(self) -> str:
+        """Human-facing identifier: display_name for sessions, branch for code."""
+        if self.instance_type == InstanceType.SESSION and self.display_name:
+            return self.display_name
+        return self.branch
+
 
 class InstanceRegistry:
     """Thread-safe registry of Claude instances indexed by id and branch."""
@@ -76,7 +90,7 @@ class InstanceRegistry:
         self._user_email = user_email
         self.user_jwt = user_jwt
         self._transcript_buffer: list[dict[str, str]] = []
-        # Repo root path — helper instance lives here and skips file tree updates
+        # Repo root path — used as cwd for session instances
         self.repo_root: str | None = None
 
         # Callbacks — set by session/screen
@@ -101,6 +115,7 @@ class InstanceRegistry:
                 branch=branch,
                 worktree_path=worktree_path,
                 agent_type=agent_type,
+                instance_type=InstanceType.CODE,
             )
             self._instances[instance.instance_id] = instance
             self._branch_index[branch] = instance.instance_id
@@ -110,12 +125,70 @@ class InstanceRegistry:
             self.on_status_change(instance.instance_id, instance.status)
         if self.on_instance_change:
             self.on_instance_change()
-        # Start file tree updates for this instance (skip for helper on repo root)
-        if not (self.repo_root and str(worktree_path) == str(self.repo_root)):
-            from voice_vibecoder.tools.file_tree import start_file_tree_updates
-            start_file_tree_updates(instance.instance_id, worktree_path, self)
+        # Start file tree updates for code instances (skip for sessions)
+        from voice_vibecoder.tools.file_tree import start_file_tree_updates
+        start_file_tree_updates(instance.instance_id, worktree_path, self)
+        return instance
+
+    def create_session(self, name: str, agent_type: str = "claude") -> AgentInstance:
+        """Create a branchless session instance, deduplicating by display_name."""
+        existing = self.get_session_by_name(name)
+        if existing:
+            return existing
+        with self._lock:
+            instance = AgentInstance(
+                instance_id=uuid.uuid4().hex[:8],
+                branch=f"_session_{name}",
+                worktree_path="",
+                agent_type=agent_type,
+                instance_type=InstanceType.SESSION,
+                display_name=name,
+            )
+            self._instances[instance.instance_id] = instance
+            self._branch_index[instance.branch] = instance.instance_id
+        self._save_state()
+        if self.on_status_change:
+            self.on_status_change(instance.instance_id, instance.status)
+        if self.on_instance_change:
+            self.on_instance_change()
         return instance
 
+    def get_session_by_name(self, name: str) -> AgentInstance | None:
+        """Fuzzy-match against SESSION instances' display_name."""
+        name_lower = name.lower().strip()
+        with self._lock:
+            sessions = [
+                inst for inst in self._instances.values()
+                if inst.instance_type == InstanceType.SESSION
+            ]
+        # Exact match first
+        for inst in sessions:
+            if inst.display_name.lower() == name_lower:
+                return inst
+        # Substring match
+        partial = [inst for inst in sessions if name_lower in inst.display_name.lower()]
+        if len(partial) == 1:
+            return partial[0]
+        if partial:
+            return min(partial, key=lambda i: len(i.display_name))
+        # Reverse substring (session name in query)
+        partial = [inst for inst in sessions if inst.display_name.lower() in name_lower]
+        if len(partial) == 1:
+            return partial[0]
+        if partial:
+            return min(partial, key=lambda i: len(i.display_name))
+        return None
+
+    def get_all_sessions(self) -> list[AgentInstance]:
+        """Return all SESSION type instances."""
+        with self._lock:
+            return [i for i in self._instances.values() if i.instance_type == InstanceType.SESSION]
+
+    def get_all_code_instances(self) -> list[AgentInstance]:
+        """Return all CODE type instances."""
+        with self._lock:
+            return [i for i in self._instances.values() if i.instance_type == InstanceType.CODE]
+
     def get_by_branch(self, branch: str) -> AgentInstance | None:
         with self._lock:
             iid = self._branch_index.get(branch)
@@ -140,9 +213,11 @@ class InstanceRegistry:
             inst = self._instances.pop(instance_id, None)
             if inst:
                 self._branch_index.pop(inst.branch, None)
-        # Stop file tree updates for removed instance
-        from voice_vibecoder.tools.file_tree import stop_file_tree_updates
-        stop_file_tree_updates(instance_id)
+                is_session = inst.instance_type == InstanceType.SESSION
+        # Stop file tree updates for code instances only
+        if not is_session:
+            from voice_vibecoder.tools.file_tree import stop_file_tree_updates
+            stop_file_tree_updates(instance_id)
         self._save_state()
         if self.on_instance_change:
             self.on_instance_change()
@@ -224,6 +299,8 @@ class InstanceRegistry:
                         "branch": inst.branch,
                         "worktree_path": inst.worktree_path,
                         "agent_type": inst.agent_type,
+                        "instance_type": inst.instance_type.value,
+                        "display_name": inst.display_name,
                         "session_id": inst.session_id,
                         "output_buffer": inst.output_buffer[-5000:] if inst.output_buffer else "",
                     }
@@ -277,10 +354,20 @@ class InstanceRegistry:
                 agent_type = entry.get("agent_type", "claude")
                 session_id = entry.get("session_id", "")
                 instance_id = entry.get("instance_id", uuid.uuid4().hex[:8])
-
                 output_buffer = entry.get("output_buffer", "")
-
-                if not branch or not worktree_path:
+                # Backward compat: old state files default to CODE
+                instance_type_str = entry.get("instance_type", "code")
+                try:
+                    instance_type = InstanceType(instance_type_str)
+                except ValueError:
+                    instance_type = InstanceType.CODE
+                display_name = entry.get("display_name", "")
+                is_session = instance_type == InstanceType.SESSION
+
+                if not branch:
+                    continue
+                # CODE instances require a worktree_path
+                if not is_session and not worktree_path:
                     continue
                 # Skip if already registered (e.g. current branch added at startup)
                 if branch in self._branch_index:
@@ -293,8 +380,8 @@ class InstanceRegistry:
                         existing.output_buffer = output_buffer
                     loaded.append(existing)
                     continue
-                # Verify worktree still exists
-                if not Path(worktree_path).exists():
+                # Verify worktree still exists (skip for session instances)
+                if not is_session and not Path(worktree_path).exists():
                     logger.info("Skipping saved instance '%s': path gone", branch)
                     continue
 
@@ -303,6 +390,8 @@ class InstanceRegistry:
                     branch=branch,
                     worktree_path=worktree_path,
                     agent_type=agent_type,
+                    instance_type=instance_type,
+                    display_name=display_name,
                     session_id=session_id,
                     first_call=not bool(session_id),
                     output_buffer=output_buffer,
@@ -311,10 +400,10 @@ class InstanceRegistry:
                 self._branch_index[branch] = instance.instance_id
                 loaded.append(instance)
 
-        # Start file tree updates for all loaded instances (skip helper)
+        # Start file tree updates for code instances only
         from voice_vibecoder.tools.file_tree import start_file_tree_updates
         for inst in loaded:
-            if self.repo_root and str(inst.worktree_path) == str(self.repo_root):
+            if inst.instance_type == InstanceType.SESSION:
                 continue
             start_file_tree_updates(inst.instance_id, inst.worktree_path, self)
 

{voice_vibecoder-2.0.1 → voice_vibecoder-2.2.0}/src/voice_vibecoder/server.py

@@ -159,30 +159,9 @@ class WebSocketBridge:
             on_ui_command=self._on_ui_command,
         )
 
-        # Load saved instances and create default helper
+        # Load saved instances — panels appear dynamically as sessions/instances are created
         restored = self._session.registry.load_state()
 
-        helper_name = self._voice_config.default_instance_name if self._voice_config else "helper"
-        saved_cb = self._session.registry.on_status_change
-        self._session.registry.on_status_change = None
-        default_inst = self._session.registry.create_instance(
-            helper_name, str(self._repo_root)
-        )
-        # Add helpful description for the helper instance (only when freshly created)
-        if default_inst and default_inst.instance_id and not default_inst.output_buffer:
-            help_text = (
-                "Generell agent for spørsmål, oppgaver og orkestrering.\n"
-                "\n"
-                "**Eksempler:**\n"
-                "- 'Hva gjør denne filen?'\n"
-                "- 'Lag en ny branch for feature X'\n"
-                "- 'Lag en PR for branchen'\n"
-                "- 'Hva er status på Jira-issue PROJ-123?'"
-            )
-            default_inst.output_buffer = help_text
-            self._session.registry._save_state()
-        self._session.registry.on_status_change = saved_cb
-
         await self._session.connect()
         await self._session.configure_session()
         # Don't sync state here — the frontend sends sync_state after

{voice_vibecoder-2.0.1 → voice_vibecoder-2.2.0}/src/voice_vibecoder/session.py

@@ -328,18 +328,18 @@ class RealtimeSession:
             self._registry.on_output(instance_id, f"{prefix} {first_line}")
         if self._loop and self._running:
             inst = self._registry.get_by_id(instance_id)
-            branch = inst.branch if inst else "unknown"
+            display_key = inst.display_key if inst else "unknown"
             agent_type = inst.agent_type if inst else "claude"
             asyncio.run_coroutine_threadsafe(
-                self._inject_agent_result(branch, result, agent_type), self._loop
+                self._inject_agent_result(display_key, result, agent_type), self._loop
             )
 
-    async def _inject_agent_result(self, branch: str, result: str, agent_type: str = "claude") -> None:
+    async def _inject_agent_result(self, display_key: str, result: str, agent_type: str = "claude") -> None:
         if not self._running:
             return
         from voice_vibecoder.code_providers.registry import get_agent
         agent_label = get_agent(agent_type).label
-        system_text = f"{agent_label} finished on '{branch}':\n\n{result}"
+        system_text = f"{agent_label} finished on '{display_key}':\n\n{result}"
         try:
             await self._provider.inject_message(system_text)
         except Exception as e:
@@ -357,15 +357,15 @@ class RealtimeSession:
     def _on_agent_question(self, instance_id: str, question_data: dict) -> None:
         if self._loop and self._running:
             inst = self._registry.get_by_id(instance_id)
-            branch = inst.branch if inst else "unknown"
+            display_key = inst.display_key if inst else "unknown"
             agent_type = inst.agent_type if inst else "claude"
             asyncio.run_coroutine_threadsafe(
-                self._inject_agent_question(branch, question_data, agent_type),
+                self._inject_agent_question(display_key, question_data, agent_type),
                 self._loop,
             )
 
     async def _inject_agent_question(
-        self, branch: str, question_data: dict, agent_type: str = "claude",
+        self, display_key: str, question_data: dict, agent_type: str = "claude",
     ) -> None:
         if not self._running:
             return
@@ -377,16 +377,16 @@ class RealtimeSession:
 
         if tool == "EnterPlanMode":
             system_text = (
-                f"{label} on '{branch}' wants to plan first. Should it plan or just implement?"
+                f"{label} on '{display_key}' wants to plan first. Should it plan or just implement?"
             )
         elif tool == "ExitPlanMode":
             system_text = (
-                f"{label} on '{branch}' has a plan ready. "
+                f"{label} on '{display_key}' has a plan ready. "
                 "Ask the user if the agent should proceed with the implementation. "
                 "Use answer_agent_question to forward their response."
             )
         else:
-            system_text = f"{label} on '{branch}' is asking:\n\n{formatted}"
+            system_text = f"{label} on '{display_key}' is asking:\n\n{formatted}"
 
         try:
             await self._provider.inject_message(system_text)