Skip to content

add bin/archy-cockpit — persistent tmux cockpit for Archy sessions - #12

Open
Ahmad-Ez wants to merge 1 commit into
mainfrom
dev
Open

Ahmad-Ez wants to merge 1 commit into
mainfrom
dev

Conversation

@Ahmad-Ez

@Ahmad-Ez Ahmad-Ez commented Jun 2, 2026

Copy link
Copy Markdown
Owner

$(cat <<'EOF'

Summary

  • Adds bin/archy-cockpit — a small bash launcher that opens (or reattaches to) a named tmux session for any Archy project
  • 3-pane layout: conductor shell (left), live sessions.log tail (top-right), scratch shell (bottom-right)
  • Idempotent: if the session already exists, reattaches instead of creating a new one
  • Session named archy-<project-dirname> so multiple projects never collide
  • Adds a short "Cockpit" entry to the Interactive vs. Runner section of the README with the one-time PATH setup line

What it solves (V7.2 pain points)

  • Blocks your terminal — detach with Ctrl-b d, terminal is free, claude session keeps running
  • Lost session on terminal crash — tmux keeps the process alive regardless of how the terminal dies
  • No live visibility — sessions.log tail gives a real-time view of what the Conductor is doing without switching windows

What it intentionally does NOT do

  • No worktree management (Claude Code handles that in .claude/worktrees/)
  • No runner/automation integration (user prefers interactive, one-spec-at-a-time with PR review)
  • No send-keys coordination between panes (that's the fragile path the v8 blueprint replaces)

Test plan

  • chmod +x bin/archy-cockpit (already set in commit)
  • Add ~/docs-to-code/bin to PATH
  • Run archy-cockpit from inside a bootstrapped project — should open 3-pane session
  • Detach (Ctrl-b d) and re-run archy-cockpit — should reattach, not create a second session
  • Run from non-Archy dir — should print the ❌ Not an Archy project error and exit 1

https://claude.ai/code/session_01UHART3vXBeF7txW3Ae5PC6
EOF
)


Generated by Claude Code

3-pane layout: conductor shell (left), live sessions.log tail (top-right),
scratch shell (bottom-right). Idempotent: reattaches if the session already
exists. Lets you detach mid-spec and reattach later without losing the
running claude session.

https://claude.ai/code/session_01UHART3vXBeF7txW3Ae5PC6
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants