stablyai / stablyai/orca

[Feature]: Add configuration to keep terminal splits open/visible after task completion

Open
#16,670 0 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
TypeScript
Stars
71.3k
Forks
4.7k
Avg merge
14h 54m
Merged PRs (30d)
520

Description

### Problem or use case

Currently, when an agent finishes execution or a task/worktree reaches a completed or resolved state, the UI automatically unmounts or collapses the active terminal split to switch directly to the diff/review view.

While this prioritizes diff review and PR creation, it disrupts workflows where developers need to:
- Inspect full process exit states, trailing logs, and error outputs without having to manually reopen panels.
- Interact with lingering background processes, local dev servers, or REPLs started during the task run.
- Prevent abrupt layout shifts across split-pane views when running and checking parallel worktrees.

### Proposed solution

Add a user setting and/or an `orca.yaml` configuration option to control terminal lifecycle behavior upon agent completion:

- **Config Key Examples:** `keepTerminalOpenOnComplete: true` or `terminal.autoCloseOnComplete: false`
- **Behavior:** When enabled, completing a task keeps the active terminal split pinned and interactive in the foreground alongside/below the diff review view rather than collapsing the PTY split automatically.

### Alternatives or additional context

- **Current Workaround:** Manually reopening the terminal split using `Cmd/Ctrl + \`` or clicking the bottom toolbar icon after every finished run.
- **Related Context:** Having the terminal pane remain open provides continuity when transitioning between agent execution and manual verification.

Contributor guide

Open the contributing guide

Research direction

No implementation files or tests are named. Start by locating the terminal split lifecycle and the settings or orca.yaml configuration entry points, then trace what happens when an agent or worktree reaches completion. Done means an opt-in setting keeps the terminal split pinned and interactive while the diff or review view remains available.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
developer-experience, tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.