{"id":50931504,"url":"https://github.com/goonobu-dot/claude-code-workbench","last_synced_at":"2026-06-17T05:00:37.455Z","repository":{"id":365224170,"uuid":"1270697194","full_name":"goonobu-dot/claude-code-workbench","owner":"goonobu-dot","description":"A macOS/tmux workbench for running up to 9 Claude Code CLI sessions in one window for parallel OSS maintenance and research.","archived":false,"fork":false,"pushed_at":"2026-06-16T11:02:15.000Z","size":634,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-16T13:07:03.102Z","etag":null,"topics":["agent-workbench","ai-agents","claude-code","macos","oss-maintenance","tmux"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/goonobu-dot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-16T01:03:07.000Z","updated_at":"2026-06-16T11:02:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/goonobu-dot/claude-code-workbench","commit_stats":null,"previous_names":["goonobu-dot/claude-code-workbench"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/goonobu-dot/claude-code-workbench","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goonobu-dot%2Fclaude-code-workbench","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goonobu-dot%2Fclaude-code-workbench/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goonobu-dot%2Fclaude-code-workbench/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goonobu-dot%2Fclaude-code-workbench/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/goonobu-dot","download_url":"https://codeload.github.com/goonobu-dot/claude-code-workbench/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goonobu-dot%2Fclaude-code-workbench/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34434496,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-workbench","ai-agents","claude-code","macos","oss-maintenance","tmux"],"created_at":"2026-06-17T05:00:36.790Z","updated_at":"2026-06-17T05:00:37.449Z","avatar_url":"https://github.com/goonobu-dot.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Code Workbench\n\n[![CI](https://github.com/goonobu-dot/claude-code-workbench/actions/workflows/ci.yml/badge.svg)](https://github.com/goonobu-dot/claude-code-workbench/actions/workflows/ci.yml)\n[![Release](https://img.shields.io/github/v/release/goonobu-dot/claude-code-workbench)](https://github.com/goonobu-dot/claude-code-workbench/releases)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\nA macOS/tmux workbench for running up to 9 Claude Code CLI sessions in one Terminal window.\n\nThis is a focused public version of a real local workflow: launch several Claude Code panes, point them at one shared idea folder, and use them for research, ideation, implementation planning, and comparison.\n\nThis project is not affiliated with Anthropic.\n\n![Claude Code Workbench terminal preview](docs/assets/workbench-preview.svg)\n\n## Why This Exists\n\nOne AI-agent chat is useful. Several panes are better when you want independent angles on the same problem.\n\nUse this workbench for:\n\n- parallel research\n- competing solution ideas\n- feature planning\n- review and risk checks\n- collecting outputs into one shared folder\n- keeping a repeatable Claude Code multi-pane setup\n\n## Requirements\n\n- macOS\n- `tmux`\n- Claude Code CLI installed as `claude` or configured with `CLAUDE_WORKBENCH_COMMAND`\n- Python 3 and Pillow only if you regenerate the icon\n\nInstall tmux with Homebrew:\n\n```bash\nbrew install tmux\n```\n\n## Quick Start\n\nOne-command install:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/goonobu-dot/claude-code-workbench/main/scripts/install.sh | bash\n```\n\nThen launch:\n\n```bash\ncd \"$HOME/ClaudeCodeWorkbench/claude-code-workbench\"\nmake demo\n./scripts/launch_claude_tmux.sh\n```\n\nCheck your local setup without starting a workbench session:\n\n```bash\n./scripts/doctor.sh\n```\n\nRun the local validation suite:\n\n```bash\nmake test\n```\n\nCreate a reusable maintainer workflow folder before launching panes:\n\n```bash\n./scripts/new_workflow.sh issue-triage\nCLAUDE_WORKBENCH_IDEA_DIR=\"$HOME/ClaudeCodeWorkbench/Idea\" ./scripts/launch_claude_tmux.sh\n```\n\nStart directly from a public GitHub issue or pull request URL:\n\n```bash\n./scripts/create_workflow_from_url.sh https://github.com/owner/repo/issues/123\n./scripts/create_workflow_from_url.sh https://github.com/owner/repo/pull/123\n```\n\nLaunch with role-specific prompts generated from `pane-roles.md`:\n\n```bash\nCLAUDE_WORKBENCH_IDEA_DIR=\"$HOME/ClaudeCodeWorkbench/Idea\" \\\nCLAUDE_WORKBENCH_USE_ROLE_PROMPTS=1 \\\n./scripts/launch_claude_tmux.sh\n```\n\nAfter the panes write their notes, create a handoff summary:\n\n```bash\n./scripts/close_workflow.sh \"$HOME/ClaudeCodeWorkbench/Idea\"\n```\n\nExport a workflow folder for sharing:\n\n```bash\n./scripts/export_workflow.sh \"$HOME/ClaudeCodeWorkbench/Idea\"\n```\n\nImport a shared workflow archive:\n\n```bash\n./scripts/import_workflow.sh ./Idea-workflow-export.tar.gz\n```\n\nAll panes use one shared idea folder by default:\n\n```bash\n~/ClaudeCodeWorkbench/Idea\n```\n\nManual clone instead of the installer:\n\n```bash\nmkdir -p \"$HOME/ClaudeCodeWorkbench\"\ngit clone https://github.com/goonobu-dot/claude-code-workbench.git \"$HOME/ClaudeCodeWorkbench/claude-code-workbench\"\ncd \"$HOME/ClaudeCodeWorkbench/claude-code-workbench\"\n./scripts/doctor.sh\n```\n\n## Controls\n\nThe workbench uses tmux. The prefix is usually `control-b`.\n\n- `control-b z`: zoom or unzoom the active pane\n- mouse support is enabled\n- each pane starts a separate Claude Code session\n\n## Configuration\n\n```bash\nCLAUDE_WORKBENCH_PANE_COUNT=4 ./scripts/launch_claude_tmux.sh\nCLAUDE_WORKBENCH_BASE=\"$HOME/ClaudeCodeWorkbench\" ./scripts/launch_claude_tmux.sh\nCLAUDE_WORKBENCH_IDEA_DIR=\"$HOME/ClaudeCodeWorkbench/Research\" ./scripts/launch_claude_tmux.sh\nCLAUDE_WORKBENCH_COMMAND=\"/opt/homebrew/bin/claude\" ./scripts/launch_claude_tmux.sh\nCLAUDE_WORKBENCH_MODEL=\"sonnet\" ./scripts/launch_claude_tmux.sh\nCLAUDE_WORKBENCH_AUTO_SUBMIT=0 ./scripts/launch_claude_tmux.sh\n```\n\nDefaults:\n\n| Setting | Default |\n| --- | --- |\n| `CLAUDE_WORKBENCH_PANE_COUNT` | `9` |\n| `CLAUDE_WORKBENCH_SESSION` | `claude-code-9` |\n| `CLAUDE_WORKBENCH_BASE` | `~/ClaudeCodeWorkbench` |\n| `CLAUDE_WORKBENCH_IDEA_DIR` | `~/ClaudeCodeWorkbench/Idea` |\n| `CLAUDE_WORKBENCH_MODEL` | `sonnet` |\n| `CLAUDE_WORKBENCH_EFFORT` | `low` |\n| `CLAUDE_WORKBENCH_PERMISSION_MODE` | `auto` |\n| `CLAUDE_WORKBENCH_AUTO_SUBMIT` | `1` |\n\n## Build The macOS App\n\n```bash\n./scripts/build_claude_app.sh\nopen \"$HOME/Applications/Claude Code Workbench.app\"\n```\n\nThe generated app opens Terminal and launches the tmux workbench. The checked-in AppleScript does not contain a personal path. By default, it expects this repository at:\n\n```bash\n~/ClaudeCodeWorkbench/claude-code-workbench\n```\n\n## Workflow Recipes\n\nSee [docs/workflows.md](docs/workflows.md) for practical ways to use the panes without creating noise.\n\nSee also:\n\n- [docs/oss-maintainer-use-cases.md](docs/oss-maintainer-use-cases.md)\n- [docs/showcase.md](docs/showcase.md)\n- [docs/why.md](docs/why.md)\n- [docs/one-minute-demo.md](docs/one-minute-demo.md)\n- [docs/commands.md](docs/commands.md)\n- [docs/architecture.md](docs/architecture.md)\n- [docs/workflow-templates.md](docs/workflow-templates.md)\n- [docs/workflow-sharing.md](docs/workflow-sharing.md)\n- [docs/troubleshooting.md](docs/troubleshooting.md)\n- [docs/faq.md](docs/faq.md)\n- [docs/publication-checklist.md](docs/publication-checklist.md)\n- [docs/openai-codex-for-oss.md](docs/openai-codex-for-oss.md)\n- [docs/adoption-plan.md](docs/adoption-plan.md)\n\nExample:\n\n- [examples/issue-triage-demo](examples/issue-triage-demo)\n- [examples/pr-review-demo](examples/pr-review-demo)\n- [examples/release-prep-demo](examples/release-prep-demo)\n- [examples/feature-discovery-demo](examples/feature-discovery-demo)\n\nProject operations:\n\n- [ROADMAP.md](ROADMAP.md)\n- [CHANGELOG.md](CHANGELOG.md)\n- [SECURITY.md](SECURITY.md)\n\nIf you try it on a real or fictional maintainer task, share the result with the\n[usage report issue template](.github/ISSUE_TEMPLATE/usage_report.yml). Reports\nabout confusing setup steps are as useful as reports about successful workflows.\n\n## Safety Notes\n\nThis repository intentionally does not include local logs, `.env` files, prompt histories, Obsidian vaults, generated agent output, or app bundles.\n\nBefore publishing your own fork, run:\n\n```bash\nmake test\n```\n\n## Project Status\n\nThis is an early public release. It is intentionally small: shell scripts, AppleScript launchers, generated icon assets, tests, and CI.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoonobu-dot%2Fclaude-code-workbench","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoonobu-dot%2Fclaude-code-workbench","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoonobu-dot%2Fclaude-code-workbench/lists"}