René's URL Explorer Experiment


Title: Experimental: pure-chain ChainWorkspaceBuilder + `--builder=chain` by tony · Pull Request #1054 · tmux-python/tmuxp · GitHub

Open Graph Title: Experimental: pure-chain ChainWorkspaceBuilder + `--builder=chain` by tony · Pull Request #1054 · tmux-python/tmuxp

X Title: Experimental: pure-chain ChainWorkspaceBuilder + `--builder=chain` by tony · Pull Request #1054 · tmux-python/tmuxp

Description: Summary Add a ChainWorkspaceBuilder that constructs a workspace's entire session → window → pane tree from a single libtmux._experimental.chain.ForwardPlan, resolved over the minimum number of tmux invocations instead of one subprocess per new-window / split-window. Add an opt-in --builder=chain flag to tmuxp load (Env: TMUXP_BUILDER); the default builder is unchanged. Experimental: depends on libtmux's _experimental.chain API, pinned to a sibling worktree via [tool.uv.sources]. Not for merge — companion to the libtmux experiment. Changes by area src/tmuxp/workspace/chain_builder.py (new) ChainWorkspaceBuilder, a subclass of WorkspaceBuilder, overriding build(): the session is created, then every window and pane is described in one ForwardPlan seeded from the session and resolved via ServerPlanRunner. Reuses the parent's helpers (_wait_for_pane_ready, config_after_window, focus handling, plugin hooks, before_script, session options). src/tmuxp/cli/load.py Adds --builder={default,chain} (Env TMUXP_BUILDER), threaded through command_load → load_workspace as builder_name, selecting the builder class. The rest of the load path is unchanged because the subclass mirrors the constructor, .session, and event hooks. pyproject.toml [tool.uv.sources] pins libtmux to the sibling ../libtmux worktree so the experimental chain API is importable. Design decisions Reuse the default window, don't orphan it. Seeding with ForwardPlan.from_session(session) and addressing window 1 through seed.initial_window / seed.initial_pane builds onto the session's default window instead of moving it aside and killing it (the move-to-99 + kill dance the classic builder performs). send_keys_mode, default readiness. The chain batches split + send-keys without waiting for the new pane's shell prompt. readiness builds only the structure via the chain, then sends each pane's commands shell-ready (matching the classic builder, deterministic). batched folds send-keys into the plan for the fullest "all at once" — faster, but it can race an interactive prompt. Sync, not async. tmuxp has no async today and a workspace build is causally serial (windows depend on the session; decorations depend on captured ids), so the chain's synchronous path (ServerPlanRunner / run_resolving) is the right fit. Subclass, not fork. Extending WorkspaceBuilder keeps .session, find_current_attached_session, the on_* event hooks, and the plugin lifecycle identical, so load.py needs only to pick the class. Test plan Lint + format clean on the new builder, tests, and the CLI change Type-check (mypy) clean tests/workspace/test_chain_builder.py — two/three-pane structure, window + pane focus, readiness-mode commands landing, batched mode, and --builder flag parsing Existing tests/workspace/test_builder.py and tests/cli/test_load.py still pass (the subclass leaves the default builder untouched) Smoke: tmuxp load -d --builder=chain tests/fixtures/workspace/builder/two_pane.yaml builds editor (2 panes), logging, test, matching the default builder Companion PR Depends on the libtmux experimental chain API: tmux-python/libtmux#685.

Open Graph Description: Summary Add a ChainWorkspaceBuilder that constructs a workspace's entire session → window → pane tree from a single libtmux._experimental.chain.ForwardPlan, resolved over the minimum number of...

X Description: Summary Add a ChainWorkspaceBuilder that constructs a workspace's entire session → window → pane tree from a single libtmux._experimental.chain.ForwardPlan, resolved over the minimum numbe...

Opengraph URL: https://github.com/tmux-python/tmuxp/pull/1054

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:6f93a65d-e987-a0a2-96ba-dbd3e615aa7a
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-id935E:2E2180:16995F:1EEB70:6B008277
html-safe-nonce3d823ca1567e4cdb75fd78e247c0a69a53d75bdaf7c01ae9b239ddc6c8ec8072
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5MzVFOjJFMjE4MDoxNjk5NUY6MUVFQjcwOjZCMDA4Mjc3IiwidmlzaXRvcl9pZCI6IjEzNzcxNjUxNDYyNDUzMzM2MjMiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmacf91e9ec4edd9400fc0001fa60d174c025b1515b45f4e8aabf8e5a84d2f541783
hovercard-subject-tagpull_request:3904426232
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/tmux-python/tmuxp/pull/1054/files
twitter:imagehttps://avatars.githubusercontent.com/u/26336?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/26336?s=400&v=4
og:image:altSummary Add a ChainWorkspaceBuilder that constructs a workspace's entire session → window → pane tree from a single libtmux._experimental.chain.ForwardPlan, resolved over the minimum number of...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None82c186f13e104004ab7bdb779f3195e59dd38bfde531aaa74b76470fc2462b83
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/tmux-python/tmuxp git https://github.com/tmux-python/tmuxp.git
octolytics-dimension-user_id37234308
octolytics-dimension-user_logintmux-python
octolytics-dimension-repository_id12398170
octolytics-dimension-repository_nwotmux-python/tmuxp
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id12398170
octolytics-dimension-repository_network_root_nwotmux-python/tmuxp
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
released1bc2aa1939001689f5ce935982c10a6138f745c
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/tmux-python/tmuxp/pull/1054/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Ftmux-python%2Ftmuxp%2Fpull%2F1054%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Ftmux-python%2Ftmuxp%2Fpull%2F1054%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=tmux-python%2Ftmuxp
Reloadhttps://github.com/tmux-python/tmuxp/pull/1054/files
Reloadhttps://github.com/tmux-python/tmuxp/pull/1054/files
Reloadhttps://github.com/tmux-python/tmuxp/pull/1054/files
tmux-pythonhttps://github.com/tmux-python
tmuxphttps://github.com/tmux-python/tmuxp
Codehttps://github.com/tmux-python/tmuxp
Issues113 (113)https://github.com/tmux-python/tmuxp/issues
Pull requests29 (29)https://github.com/tmux-python/tmuxp/pulls
Discussionshttps://github.com/tmux-python/tmuxp/discussions
Actionshttps://github.com/tmux-python/tmuxp/actions
Security and qualityhttps://github.com/tmux-python/tmuxp/security
Insightshttps://github.com/tmux-python/tmuxp/insights
Sign up for GitHub https://github.com/signup?return_to=%2Ftmux-python%2Ftmuxp%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Ftmux-python%2Ftmuxp%2Fissues%2Fnew%2Fchoose
tonyhttps://github.com/tony
masterhttps://github.com/tmux-python/tmuxp/tree/master
chainable-commands-experiment-00https://github.com/tmux-python/tmuxp/tree/chainable-commands-experiment-00
Conversation 0 https://github.com/tmux-python/tmuxp/pull/1054
Commits 3 https://github.com/tmux-python/tmuxp/pull/1054/commits
Checks 13 https://github.com/tmux-python/tmuxp/pull/1054/checks
Files changed https://github.com/tmux-python/tmuxp/pull/1054/files
Please reload this pagehttps://github.com/tmux-python/tmuxp/pull/1054/files
Experimental: pure-chain ChainWorkspaceBuilder + --builder=chain https://github.com/tmux-python/tmuxp/pull/1054/files#top
Show all changes 3 commits https://github.com/tmux-python/tmuxp/pull/1054/files
675fbcd py(deps[libtmux]) Pin to sibling chainable-commands worktree tony Jun 20, 2026 https://github.com/tmux-python/tmuxp/pull/1054/commits/675fbcd62db18c06505cf415ce43a246ea59b930
55e6315 workspace(feat[chain]): add ChainWorkspaceBuilder tony Jun 20, 2026 https://github.com/tmux-python/tmuxp/pull/1054/commits/55e6315797fd41ce3e41247493b827ed75244de1
c3d3d6b cli(load[builder]): --builder=chain flag tony Jun 20, 2026 https://github.com/tmux-python/tmuxp/pull/1054/commits/c3d3d6b414363f11fa4a174717ce315e528e2c00
Clear filters https://github.com/tmux-python/tmuxp/pull/1054/files
Please reload this pagehttps://github.com/tmux-python/tmuxp/pull/1054/files
Please reload this pagehttps://github.com/tmux-python/tmuxp/pull/1054/files
pyproject.toml https://github.com/tmux-python/tmuxp/pull/1054/files#diff-50c86b7ed8ac2cf95bd48334961bf0530cdc77b5a56f852c5c61b89d735fd711
load.py https://github.com/tmux-python/tmuxp/pull/1054/files#diff-5a6cefe222da9d8e8c0fc10b55805661c46f32e982551da24a26d1ec0674828c
chain_builder.py https://github.com/tmux-python/tmuxp/pull/1054/files#diff-34e79cabc88b74bb3f3980f488af4616d5ec70d0486d8b21065004ce6303f1d9
test_chain_builder.py https://github.com/tmux-python/tmuxp/pull/1054/files#diff-eeec09a74a3f67bea6c255f9a93788f77d98d5b53575669c751734c7e37443cd
uv.lock https://github.com/tmux-python/tmuxp/pull/1054/files#diff-84321598744d84dbee2318e634c74c9aae39a1c253f1c4bd17ebf9ef2f807b11
pyproject.tomlhttps://github.com/tmux-python/tmuxp/pull/1054/files#diff-50c86b7ed8ac2cf95bd48334961bf0530cdc77b5a56f852c5c61b89d735fd711
View file https://github.com/tmux-python/tmuxp/blob/c3d3d6b414363f11fa4a174717ce315e528e2c00/pyproject.toml
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/tmux-python/tmuxp/pull/1054/{{ revealButtonHref }}
https://github.com/tmux-python/tmuxp/pull/1054/files#diff-50c86b7ed8ac2cf95bd48334961bf0530cdc77b5a56f852c5c61b89d735fd711
https://github.com/tmux-python/tmuxp/pull/1054/files#diff-50c86b7ed8ac2cf95bd48334961bf0530cdc77b5a56f852c5c61b89d735fd711
src/tmuxp/cli/load.pyhttps://github.com/tmux-python/tmuxp/pull/1054/files#diff-5a6cefe222da9d8e8c0fc10b55805661c46f32e982551da24a26d1ec0674828c
View file https://github.com/tmux-python/tmuxp/blob/c3d3d6b414363f11fa4a174717ce315e528e2c00/src/tmuxp/cli/load.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/tmux-python/tmuxp/pull/1054/{{ revealButtonHref }}
https://github.com/tmux-python/tmuxp/pull/1054/files#diff-5a6cefe222da9d8e8c0fc10b55805661c46f32e982551da24a26d1ec0674828c
https://github.com/tmux-python/tmuxp/pull/1054/files#diff-5a6cefe222da9d8e8c0fc10b55805661c46f32e982551da24a26d1ec0674828c
https://github.com/tmux-python/tmuxp/pull/1054/files#diff-5a6cefe222da9d8e8c0fc10b55805661c46f32e982551da24a26d1ec0674828c
https://github.com/tmux-python/tmuxp/pull/1054/files#diff-5a6cefe222da9d8e8c0fc10b55805661c46f32e982551da24a26d1ec0674828c
https://github.com/tmux-python/tmuxp/pull/1054/files#diff-5a6cefe222da9d8e8c0fc10b55805661c46f32e982551da24a26d1ec0674828c
https://github.com/tmux-python/tmuxp/pull/1054/files#diff-5a6cefe222da9d8e8c0fc10b55805661c46f32e982551da24a26d1ec0674828c
https://github.com/tmux-python/tmuxp/pull/1054/files#diff-5a6cefe222da9d8e8c0fc10b55805661c46f32e982551da24a26d1ec0674828c
https://github.com/tmux-python/tmuxp/pull/1054/files#diff-5a6cefe222da9d8e8c0fc10b55805661c46f32e982551da24a26d1ec0674828c
https://github.com/tmux-python/tmuxp/pull/1054/files#diff-5a6cefe222da9d8e8c0fc10b55805661c46f32e982551da24a26d1ec0674828c
src/tmuxp/workspace/chain_builder.pyhttps://github.com/tmux-python/tmuxp/pull/1054/files#diff-34e79cabc88b74bb3f3980f488af4616d5ec70d0486d8b21065004ce6303f1d9
View file https://github.com/tmux-python/tmuxp/blob/c3d3d6b414363f11fa4a174717ce315e528e2c00/src/tmuxp/workspace/chain_builder.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/tmux-python/tmuxp/pull/1054/{{ revealButtonHref }}
Please reload this pagehttps://github.com/tmux-python/tmuxp/pull/1054/files
Please reload this pagehttps://github.com/tmux-python/tmuxp/pull/1054/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.