Skip to content

Feature: Expose TUI Session Management Commands via ACP (for Zed integration) #8931

New issue
New issue
Closed
xsa-dev/anomalyco-opencode
#1
Closed
Feature: Expose TUI Session Management Commands via ACP (for Zed integration)#8931
xsa-dev/anomalyco-opencode
#1
Assignees
thdxr

Description

@KristjanMinn
KristjanMinn
opened on Jan 16, 2026

Summary

Expose OpenCode's TUI session management features (session list, switch session, new session, rename, fork, etc.) through the ACP (Agent Client Protocol) so they can be used in external clients like Zed's agent panel.

Problem

When using OpenCode via Zed's agent panel (or any ACP client), users lose access to the powerful session management features available in the TUI:

TUI Command Palette (Ctrl+P) features NOT available in ACP:

Feature TUI ACP/Zed
Switch session Ctrl+X L ❌ Not available
New session Ctrl+X N ❌ Not available
Rename session Ctrl+R ❌ Not available
Fork from message menu ❌ Not available
Compact session Ctrl+X C /compact only
Undo/redo message Ctrl+X U/R ❌ Not available
Export session Ctrl+X X ❌ Not available
Copy session transcript menu ❌ Not available
Jump to message Ctrl+X G ❌ Not available

This creates a significant UX gap between TUI and Zed users. Zed users cannot:

  1. Resume previous sessions
  2. Switch between active sessions
  3. Fork conversations at specific points
  4. Navigate session history

Current Architecture

Zed Editor
    │
    │ launches: opencode acp
    │ communicates via: JSON-RPC over stdio (ACP)
    ▼
OpenCode ACP Server (headless)
    │
    │ HTTP SDK API
    ▼
OpenCode Server (sessions exist here)

The TUI is a completely separate code path. ACP runs headless with no access to TUI components.

Proposed Solution

Extend the ACP protocol to expose session management operations:

1. New ACP Methods

// List available sessions
acp.session.list({ 
  limit?: number,
  projectPath?: string 
}) → Session[]

// Switch to existing session
acp.session.switch({ 
  sessionId: string 
}) → void

// Create new session
acp.session.create({ 
  title?: string 
}) → Session

// Fork session from specific message
acp.session.fork({ 
  sessionId: string,
  messageId: string 
}) → Session

// Rename session
acp.session.rename({ 
  sessionId: string,
  title: string 
}) → void

// Delete session
acp.session.delete({ 
  sessionId: string 
}) → void

// Get session info
acp.session.info({ 
  sessionId: string 
}) → SessionInfo

// Undo last message
acp.session.undo({ 
  sessionId: string 
}) → void

// Redo message
acp.session.redo({ 
  sessionId: string 
}) → void

2. Zed Integration

These methods would allow Zed to:

  • Show a session picker in the agent panel UI
  • Add keybindings for session operations
  • Display session history in the sidebar
  • Enable "Continue previous session" workflows

3. Backward Compatibility

This is purely additive — existing ACP clients continue to work unchanged.

Use Cases

  1. Resume work across sessions: User opens Zed, wants to continue yesterday's refactoring session instead of starting fresh

  2. Context switching: User working on feature A needs to quickly answer a question about feature B, then return to A

  3. Branching conversations: User wants to try two different approaches from the same starting point

  4. Session organization: User wants to rename "ACP Session 447d300d-e99b-41ae..." to "Auth refactor discussion"

References

Environment

  • OpenCode version: 1.1.23
  • Zed extension: opencode (from extension marketplace)
  • OS: Linux

Activity

  1. github-actions
    assigned
    thdxr
    on Jan 16, 2026

  2. github-actions commented on Jan 16, 2026

    @github-actions
    github-actionsBot
    on Jan 16, 2026 – with GitHub Actions
    Contributor

    This issue might be a duplicate of existing issues. Please check:

    Additionally, for keybind-related aspects of this request, please also check our pinned keybinds documentation: #4997

  3. xsa-dev
    added 5 commits that reference this issue on Jan 29, 2026

    Add session management types for ACP protocol

    7d9c311

    Add ACP session management handlers

    7b8c8fa

    Register session management tools in ACP agent server

    6041dc3

    Implement session management handlers for ACP

    eb6188b

    Fix agent.ts - Correct session management imports and handlers

    359a88f

  4. xsa-dev commented on Jan 30, 2026

    @xsa-dev
    xsa-dev
    on Jan 30, 2026

    PR with Implementation Available 🎉

    Hi @thdxr! This feature request has a working implementation ready for review:

    PR: xsa-dev#1
    Branch: feat/acp-session-management-v2

    What the PR adds:

    ✅ 13 Session Management ACP Commands:

    • listSessions - List all available sessions
    • switchSession - Switch to a different session
    • createSession - Create a new session
    • forkSession - Fork the current session
    • renameSession - Rename a session
    • deleteSession - Delete a session
    • getSessionInfo - Get information about a session
    • undoMessage - Undo the last message
    • redoMessage - Redo the last message
    • compactSession - Compact the session
    • exportSession - Export a session (text/json/markdown)
    • jumpToMessage - Jump to a specific message
    • duplicateSession - Duplicate a session

    Files Changed:

    1. packages/opencode/src/acp/agent.ts - ACP command registration and handlers
    2. packages/opencode/src/acp/session-handlers.ts - Session management implementations
    3. packages/opencode/src/acp/session-types.ts - TypeScript interfaces

    Usage Example:

    # List sessions
opencode acp -- /listSessions --limit 10

# Switch session  
opencode acp -- /switchSession --session-id <uuid>

# Create new session
opencode acp -- /createSession --title "Feature X"

# Export session
opencode acp -- /exportSession --session-id <uuid> --format markdown

    Notes from Author:

    This is a simplified implementation that uses file-based storage for sessions. Future work could integrate with OpenCode's internal session storage via SDK for more robust session management.

    Related Feature Requests:

    The PR is mergeable and ready for review. Let me know if you need any changes!

  5. xsa-dev commented on Jan 30, 2026

    @xsa-dev
    xsa-dev
    on Jan 30, 2026

    Note: This implementation was AI-generated using OpenCode itself! 🤖✨

    PR with Implementation Available 🎉

    Hi @thdxr! This feature request has a working implementation ready for review:

    PR: xsa-dev#1
    Branch: feat/acp-session-management-v2

    What the PR adds:

    ✅ 13 Session Management ACP Commands:

    • listSessions - List all available sessions
    • switchSession - Switch to a different session
    • createSession - Create a new session
    • forkSession - Fork the current session
    • renameSession - Rename a session
    • deleteSession - Delete a session
    • getSessionInfo - Get information about a session
    • undoMessage - Undo the last message
    • redoMessage - Redo the last message
    • compactSession - Compact the session
    • exportSession - Export a session (text/json/markdown)
    • jumpToMessage - Jump to a specific message
    • duplicateSession - Duplicate a session

    Files Changed:

    1. packages/opencode/src/acp/agent.ts - ACP command registration and handlers
    2. packages/opencode/src/acp/session-handlers.ts - Session management implementations
    3. packages/opencode/src/acp/session-types.ts - TypeScript interfaces

    Usage Example:

    # List sessions
opencode acp -- /listSessions --limit 10

# Switch session  
opencode acp -- /switchSession --session-id <uuid>

# Create new session
opencode acp -- /createSession --title "Feature X"

# Export session
opencode acp -- /exportSession --session-id <uuid> --format markdown

    Notes from Author:

    This is a simplified implementation that uses file-based storage for sessions. Future work could integrate with OpenCode's internal session storage via SDK for more robust session management.

    Related Feature Requests:

    The PR is mergeable and ready for review. Let me know if you need any changes!

  6. xsa-dev
    added a commit that references this issue on Jan 31, 2026

    feat(acp): Expose TUI Session Management Commands via ACP (anomalyco#…

    55b7f11

  7. jackeydou commented on Feb 13, 2026

    @jackeydou
    jackeydou
    on Feb 13, 2026

    I saw there was another merged PR that implements session/list and session/fork, I am still wondering if it's possible that opencode acp can support session export and import like opencode CLI?

  8. catatafishen
    added a commit that references this issue on Mar 29, 2026

    feat: implement session/resume RPC for OpenCode

    08de9a3

  9. github-actions commented on Apr 15, 2026

    @github-actions
    github-actionsBot
    on Apr 15, 2026 – with GitHub Actions
    Contributor

    To stay organized issues are automatically closed after 90 days of no activity. If the issue is still relevant please open a new one.

  10. github-actions
    closed this as completedon Apr 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions