Repository navigation
feat: open background sessions with claude attach - #174
Merged
Merged
Conversation
ccs asks claude agents --json every 10s for background sessions (claude --bg). They show "bg <state>" and keep ●: Enter opens claude attach <id> in a new tmux window or iTerm tab, ^X K twice stops one, and a session started by another's claude --bg nests under it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QUnP8jVL2NG9cWmohJTyun
brtkwr
enabled auto-merge
October 30, 2026 09:38
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Option 0 from the relay design (docs/design/relay.md): Claude Code's own
claude --bgdoes the delegating, and ccs makes those sessions visible and openable.claude agents --json(0.3s, off the UI thread) and keeps thekind: backgroundsessions with their shortidandstate. If the call fails (noclaude, or one too old foragents), ccs keeps its last answer.●, because unlike T3 Code's sessions they can be opened, and showbg working/bg blockedon the grey row.claude attach <id>in a new tmux window or iTerm tab, never in place. Without either, ccs says to run the command yourself.^X K: pressed twice within 5s, runsclaude stop <id>.claude --bgnests under it, asclaude -pones already do.Tested with fake
claudeandtmuxbinaries; there were no background sessions on this machine to try for real.🤖 Generated with Claude Code
https://claude.ai/code/session_01QUnP8jVL2NG9cWmohJTyun