René's URL Explorer Experiment


Title: Workspace builder roadmap: classic default, pluggable builders, readiness policy, and parallel loading · Issue #1058 · tmux-python/tmuxp · GitHub

Open Graph Title: Workspace builder roadmap: classic default, pluggable builders, readiness policy, and parallel loading · Issue #1058 · tmux-python/tmuxp

X Title: Workspace builder roadmap: classic default, pluggable builders, readiness policy, and parallel loading · Issue #1058 · tmux-python/tmuxp

Description: Summary Workspace loading performance work has exposed several concerns that should be separated instead of solved in one builder implementation. Related context: #1053 reports slow workspace loads. #1056 experiments with faster per-wind...

Open Graph Description: Summary Workspace loading performance work has exposed several concerns that should be separated instead of solved in one builder implementation. Related context: #1053 reports slow workspace loads...

X Description: Summary Workspace loading performance work has exposed several concerns that should be separated instead of solved in one builder implementation. Related context: #1053 reports slow workspace loads...

Opengraph URL: https://github.com/tmux-python/tmuxp/issues/1058

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Workspace builder roadmap: classic default, pluggable builders, readiness policy, and parallel loading","articleBody":"## Summary\n\nWorkspace loading performance work has exposed several concerns that should be separated instead of solved in one builder implementation.\n\nRelated context:\n\n- #1053 reports slow workspace loads.\n- #1056 experiments with faster per-window pane readiness.\n- #1054 explores an experimental chain-based builder.\n- #1049 is part of the broader workspace parity work that makes builder behavior and imported workspace semantics more important.\n\nThis issue is an umbrella for a staged workspace-builder roadmap. The first step should keep the classic behavior as the default and make builder selection explicit. Later steps can add a formal builder interface, readiness-policy configuration, and a parallel builder without risking compatibility for existing workspace files.\n\n## Proposed stages\n\n### 1. Classic builder base PR\n\nKeep the existing `WorkspaceBuilder` behavior as the default and make that default explicit as the classic builder.\n\nThe base PR should:\n\n- Treat the current builder as the classic builder.\n- Keep classic behavior as the default.\n- Add a workspace config parameter that selects a builder by Python dotted path.\n- Route `tmuxp load` through that builder selection.\n- Preserve existing workspace behavior unless a different builder is explicitly configured.\n- Avoid changing pane-readiness behavior or parallelizing behavior in the same PR.\n\nExample shape:\n\n```yaml\nworkspace_builder: tmuxp.workspace.builder.WorkspaceBuilder\n```\n\nThe exact key name can be refined in the PR, but the behavior should be clear: users can point tmuxp at a builder class by Python dotted path.\n\n### 2. Builder protocol and entry points\n\nCreate a follow-up issue and PR for a formal workspace-builder interface.\n\nThat work should define what a custom builder must provide, including constructor expectations, `.build()`, `.session`, progress callbacks, script-output callbacks, plugin lifecycle compatibility, and append/detached behavior.\n\nIt should also consider package entry points so builders can be distributed outside tmuxp without requiring users to reference internal module paths directly.\n\nThe interface should allow both sync and future async builders, even if tmuxp only executes sync builders initially.\n\n### 3. Pane-readiness configuration\n\nCreate a follow-up issue and PR for configuring pane-readiness behavior separately from builder selection.\n\nThis should allow users to choose whether tmuxp waits for pane prompts before layout and command dispatch. The default should preserve today’s safe behavior unless there is a deliberate compatibility decision.\n\nPossible policy shape:\n\n```yaml\npane_readiness: auto\n```\n\nPotential values:\n\n- `auto`: enable readiness waiting when it is needed for known shell behavior, especially zsh prompt redraw safety.\n- `always`: always wait for default-shell panes before layout and command dispatch.\n- `never`: skip readiness waiting for users who prefer speed and accept prompt/layout race risk.\n\nThis should remain useful even before a parallel builder exists.\n\n### 4. Parallel builder\n\nCreate a follow-up issue and PR for a parallel builder that is explicitly opt-in.\n\nThat builder can prioritize faster pane creation and concurrent readiness observation, while the classic builder remains available for configurations that depend on strict pane-by-pane side effects.\n\nThe parallel builder should document that pane commands are not guaranteed to prepare later pane split-time inputs such as `start_directory`, `shell`, `window_shell`, or pane environment. Users who need those dependencies can keep the classic builder or move setup into `before_script` / `shell_command_before`.\n\n### 5. Developer documentation\n\nAdd developer docs for workspace builder classes.\n\nThe docs should explain:\n\n- How tmuxp loads a workspace and hands it to a builder.\n- How custom builders can use libtmux object APIs and raw tmux commands.\n- Which builder hooks and callbacks must be honored.\n- How to test a custom builder.\n- How to configure a custom builder by dotted path or entry point.\n- When to use classic behavior versus experimental or parallel behavior.\n\nDocs should include small examples and test guidance so external builders are realistic, not just theoretically supported.\n\n## Goals\n\n- Preserve compatibility by keeping the classic builder as the default.\n- Avoid hiding behavior changes behind heuristics.\n- Let performance work continue through explicit opt-in builders.\n- Give advanced users a supported way to customize builder behavior.\n- Keep pane-readiness policy independent from builder architecture.\n\n## Non-goals\n\n- Do not merge the parallel behavior into the default builder as part of the base PR.\n- Do not require the chain builder experiment to be production-ready before defining the classic-builder selection path.\n- Do not make async execution required in the first interface PR.\n- Do not remove existing plugin lifecycle hooks or progress callbacks.\n\n## Acceptance criteria\n\n- A base PR exists that keeps classic behavior as the default and supports selecting a builder class by Python dotted path.\n- Follow-up issues exist for the builder protocol / entry points, pane-readiness configuration, parallel builder, and developer documentation.\n- Public docs explain the classic builder default and how custom builders can be configured.\n- Existing workspace files continue to load with classic behavior unless they opt into a different builder.\n","author":{"url":"https://github.com/tony","@type":"Person","name":"tony"},"datePublished":"2026-06-27T23:16:36Z","url":"https://github.com/tmux-python/tmuxp/issues/1058"}

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/_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format)
route-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:df4e58b9-88d0-f30e-8808-c8a2f790a601
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idCD9E:172DDC:4F3953:6B6690:6B0071B6
html-safe-nonceffababbc321379757c5419b55fd30144dc92f2153253172801061fe551263009
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDRDlFOjE3MkREQzo0RjM5NTM6NkI2NjkwOjZCMDA3MUI2IiwidmlzaXRvcl9pZCI6IjU0MTYzMjMzNzgzNDY3NTAzOTAiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac5fba82f4ad871e8ad5a539c9dc328337bb342d3bf161d73736f14fb56d50a541
hovercard-subject-tagissue:4760294281
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/tmux-python/tmuxp/1058/issue_layout
twitter:imagehttps://opengraph.githubassets.com/52d8085ea2214f5b024624df2db36b08254947fc43e398acc096496dca5f2386/tmux-python/tmuxp/issues/1058
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/52d8085ea2214f5b024624df2db36b08254947fc43e398acc096496dca5f2386/tmux-python/tmuxp/issues/1058
og:image:altSummary Workspace loading performance work has exposed several concerns that should be separated instead of solved in one builder implementation. Related context: #1053 reports slow workspace loads...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernametony
hostnamegithub.com
expected-hostnamegithub.com
None75c2b65dd205f26961d0c29afed1a8d0bb7cca9f05780571dfd1ef93eb539d16
turbo-cache-controlno-preview
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
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release84e563eb4b55f8fa102f325f117533cee9e3df4a
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/tmux-python/tmuxp/issues/1058#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Ftmux-python%2Ftmuxp%2Fissues%2F1058
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%2Fissues%2F1058
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=tmux-python%2Ftmuxp
Reloadhttps://github.com/tmux-python/tmuxp/issues/1058
Reloadhttps://github.com/tmux-python/tmuxp/issues/1058
Reloadhttps://github.com/tmux-python/tmuxp/issues/1058
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
https://github.com/tmux-python/tmuxp
New issuehttps://github.com/login?return_to=https://github.com/tmux-python/tmuxp/issues/1058
New issuehttps://github.com/login?return_to=https://github.com/tmux-python/tmuxp/issues/1058
Workspace builder roadmap: classic default, pluggable builders, readiness policy, and parallel loadinghttps://github.com/tmux-python/tmuxp/issues/1058#top
WorkspaceBuilderhttps://github.com/tmux-python/tmuxp/issues?q=state%3Aopen%20label%3A%22WorkspaceBuilder%22
enhancementhttps://github.com/tmux-python/tmuxp/issues?q=state%3Aopen%20label%3A%22enhancement%22
need-commentsInvitation for contributors and users to provide feedback on issue, for further consideration.https://github.com/tmux-python/tmuxp/issues?q=state%3Aopen%20label%3A%22need-comments%22
https://github.com/tony
tonyhttps://github.com/tony
on Jun 27, 2026https://github.com/tmux-python/tmuxp/issues/1058#issue-4760294281
Very slow performance opening layouts/workspaces #1053https://github.com/tmux-python/tmuxp/issues/1053
Wait for a window's panes concurrently to speed up loads #1056https://github.com/tmux-python/tmuxp/pull/1056
Experimental: pure-chain ChainWorkspaceBuilder + --builder=chain #1054https://github.com/tmux-python/tmuxp/pull/1054
Workspace(feat[importers]): Add tmuxinator and teamocil parity fallbacks #1049https://github.com/tmux-python/tmuxp/pull/1049
tonyhttps://github.com/tony
enhancementhttps://github.com/tmux-python/tmuxp/issues?q=state%3Aopen%20label%3A%22enhancement%22
need-commentsInvitation for contributors and users to provide feedback on issue, for further consideration.https://github.com/tmux-python/tmuxp/issues?q=state%3Aopen%20label%3A%22need-comments%22
WorkspaceBuilderhttps://github.com/tmux-python/tmuxp/issues?q=state%3Aopen%20label%3A%22WorkspaceBuilder%22
on Jun 27, 2026https://github.com/tmux-python/tmuxp/issues/1058#event-27290074402
tonyhttps://github.com/tony
on Jun 27, 2026https://github.com/tmux-python/tmuxp/issues/1058#event-27290278432
WorkspaceBuilder: make the classic builder selectable by dotted path #1059https://github.com/tmux-python/tmuxp/issues/1059
WorkspaceBuilder: define a public builder protocol and entry points #1060https://github.com/tmux-python/tmuxp/issues/1060
WorkspaceBuilder: make pane readiness configurable #1061https://github.com/tmux-python/tmuxp/issues/1061
WorkspaceBuilder: add an opt-in parallel builder #1062https://github.com/tmux-python/tmuxp/issues/1062
Docs: document custom workspace builders #1063https://github.com/tmux-python/tmuxp/issues/1063
https://github.com/tony
tonyhttps://github.com/tony
on Jun 27, 2026https://github.com/tmux-python/tmuxp/issues/1058#issuecomment-4822961802
WorkspaceBuilder: make the classic builder selectable by dotted path #1059https://github.com/tmux-python/tmuxp/issues/1059
WorkspaceBuilder: define a public builder protocol and entry points #1060https://github.com/tmux-python/tmuxp/issues/1060
WorkspaceBuilder: make pane readiness configurable #1061https://github.com/tmux-python/tmuxp/issues/1061
WorkspaceBuilder: add an opt-in parallel builder #1062https://github.com/tmux-python/tmuxp/issues/1062
Docs: document custom workspace builders #1063https://github.com/tmux-python/tmuxp/issues/1063
https://github.com/tony
tonyhttps://github.com/tony
on Jun 29, 2026https://github.com/tmux-python/tmuxp/issues/1058#issuecomment-4827985339
#1066https://github.com/tmux-python/tmuxp/pull/1066
WorkspaceBuilder: make the classic builder selectable by dotted path #1059https://github.com/tmux-python/tmuxp/issues/1059
WorkspaceBuilder: define a public builder protocol and entry points #1060https://github.com/tmux-python/tmuxp/issues/1060
WorkspaceBuilder: make pane readiness configurable #1061https://github.com/tmux-python/tmuxp/issues/1061
WorkspaceBuilder: add an opt-in parallel builder #1062https://github.com/tmux-python/tmuxp/issues/1062
Docs: document custom workspace builders #1063https://github.com/tmux-python/tmuxp/issues/1063
#1062https://github.com/tmux-python/tmuxp/issues/1062
Sign up for freehttps://github.com/signup?return_to=https://github.com/tmux-python/tmuxp/issues/1058
Sign in to commenthttps://github.com/login?return_to=https://github.com/tmux-python/tmuxp/issues/1058
WorkspaceBuilderhttps://github.com/tmux-python/tmuxp/issues?q=state%3Aopen%20label%3A%22WorkspaceBuilder%22
enhancementhttps://github.com/tmux-python/tmuxp/issues?q=state%3Aopen%20label%3A%22enhancement%22
need-commentsInvitation for contributors and users to provide feedback on issue, for further consideration.https://github.com/tmux-python/tmuxp/issues?q=state%3Aopen%20label%3A%22need-comments%22
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.