Skip to content

Clarify tclone setup and preserve tmux attach env#31

Merged
yiying-zhang merged 2 commits into
mainfrom
agent/tclone-setup-docs
Jul 25, 2026
Merged

Clarify tclone setup and preserve tmux attach env#31
yiying-zhang merged 2 commits into
mainfrom
agent/tclone-setup-docs

Conversation

@yiying-zhang

@yiying-zhang yiying-zhang commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Summary

  • preserve GENSEE_TMP_ROOT, TMPDIR, and CONTAINERS_STORAGE_CONF when tmux attach panes re-enter gensee run attach
  • document the host tclone setup in the README, including btrfs Podman storage, image-store matching, temp-root placement, and shared wrapper usage
  • expand tclone docs with the setup and troubleshooting details found while debugging test-gensee

Why

Forks could be created successfully while the tmux pane failed to appear because the attach pane lost the storage/tmp environment and looked in a different Podman store. The README also did not contain enough information to reproduce the working test-gensee setup without outside notes.

Validation

  • cargo fmt -p gensee-crate-cli
  • cargo test -p gensee-crate-cli tclone_host_tmux_attach_command -- --nocapture
  • git diff --check README.md

Companion docs PR: GenseeAI/os4agent#4.

@yiying-zhang
yiying-zhang marked this pull request as ready for review July 24, 2026 22:01
@yiying-zhang yiying-zhang changed the title Clarify tclone host setup Clarify tclone setup and preserve tmux attach env Jul 24, 2026
@shengqi-gensee

Copy link
Copy Markdown
Contributor

LGTM

@yiying-zhang
yiying-zhang merged commit 768ec0f into main Jul 25, 2026
4 checks passed
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