Repository navigation
[FEATURE]: Add 'opencode agents' command for background session management #27746
Closed as not planned
Description
Feature hasn't been suggested before.
- I have verified this feature I'm about to request hasn't been suggested before.
Describe the enhancement you want to request
Feature Description
Add an opencode agents command that provides an interactive TUI interface for managing background agent sessions, similar to Claude Code's claude agents command.
Motivation
Claude Code has a claude agents command that opens an interactive TUI view for managing background coding sessions. This allows users to:
- View all running background sessions at a glance
- Switch between sessions easily
- Monitor session status and progress
- Dispatch new sessions with specific settings (model, effort level, permissions)
Currently, OpenCode manages background sessions through CLI commands (opencode session list,opencode -s <id>,opencode -c), which lacks the convenience of a unified interactive interface.
Proposed Solution
Add a new opencode agents command that:
- Opens an interactive TUI (similar to the main OpenCode TUI)
- Lists all background sessions with their status, model, and working directory
- Allows selecting a session to attach/resume
- Provides options to start new sessions with configurable settings
- Shows session statistics (token usage, cost, duration)
Example usage:
# Open the agents management TUI
opencode agents
# Filter by working directory
opencode agents --cwd /path/to/project
# Set default model for new sessions from the TUI
opencode agents --model anthropic/claude-sonnet-4
# Set default effort level
opencode agents --effort high
Alternatives Considered
1.
Enhance existing opencode session list: Could add interactive selection, but doesn't provide the full management experience
2.
Add flags to opencode command: Could add --list-sessions flag, but doesn't provide a unified view
3.
Create a separate opencode-tui tool: Could be a plugin, but core integration would be more seamless
Additional Context
This feature would align OpenCode with Claude Code's session management UX, making it easier for users to manage multiple concurrent coding tasks across different projects.
**Label:** `enhancement`Reacted by Jonathan Norris, chenman9226, chenggui53, Luca Abbati, j-alencar, Qwark, signalblur and Vibhor Mungee
Metadata
Metadata
Assignees
Labels
No labels
Activity
github-actions commentedon May 15, 2026
This issue might be a duplicate of existing issues. Please check:
Please review these issues to see if your request is already covered or if your proposal meaningfully differs from them.
jonathannorris commentedon May 25, 2026
Yea I agree that an
opencode agentsview would be great. Having to use Claude Code a bit more at work recently and I've found thatclaude agentsto be a really good interface for working between multiple sessions without having many terminal tabs / window / panes open. It's great to have a single TUI interface for quickly switching between sessions and backgrounding tasks for review later.github-actions commentedon Jul 25, 2026
To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.