{"id":46032604,"url":"https://github.com/mr8bithk/claude-terminal","last_synced_at":"2026-03-13T06:08:09.796Z","repository":{"id":341309356,"uuid":"1169629390","full_name":"Mr8BitHK/claude-terminal","owner":"Mr8BitHK","description":"Tabbed terminal manager for Claude Code sessions — run multiple AI coding agents side-by-side with worktree integration, session persistence,  and auto-naming. Built with Electron for Windows.","archived":false,"fork":false,"pushed_at":"2026-03-04T01:23:29.000Z","size":3912,"stargazers_count":5,"open_issues_count":4,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-04T13:57:35.396Z","etag":null,"topics":["claude","claude-ai","claude-code","developer-tools","electron","git-worktrees","session-management","tabs","terminal","xterm"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/Mr8BitHK.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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-03-01T00:52:57.000Z","updated_at":"2026-03-04T01:23:33.000Z","dependencies_parsed_at":"2026-03-04T10:01:51.274Z","dependency_job_id":null,"html_url":"https://github.com/Mr8BitHK/claude-terminal","commit_stats":null,"previous_names":["mr8bithk/claude-terminal"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/Mr8BitHK/claude-terminal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mr8BitHK%2Fclaude-terminal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mr8BitHK%2Fclaude-terminal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mr8BitHK%2Fclaude-terminal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mr8BitHK%2Fclaude-terminal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mr8BitHK","download_url":"https://codeload.github.com/Mr8BitHK/claude-terminal/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mr8BitHK%2Fclaude-terminal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30121059,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T10:44:24.758Z","status":"ssl_error","status_checked_at":"2026-03-05T10:44:15.079Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["claude","claude-ai","claude-code","developer-tools","electron","git-worktrees","session-management","tabs","terminal","xterm"],"created_at":"2026-03-01T04:14:31.549Z","updated_at":"2026-03-05T11:01:20.754Z","avatar_url":"https://github.com/Mr8BitHK.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ClaudeTerminal\n\n[![GitHub release](https://img.shields.io/github/v/release/Mr8BitHK/claude-terminal)](https://github.com/Mr8BitHK/claude-terminal/releases/latest)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue)](#download)\n\n![ClaudeTerminal demo](docs/quickdemo.gif)\n\nA tabbed terminal manager for running multiple **Claude Code** sessions side by side — with multi-project workspaces, session persistence, git worktree integration, and auto-naming.\n\nThink Windows Terminal, but purpose-built for Claude Code.\n\n## Why ClaudeTerminal?\n\nIf you use Claude Code, you've probably found yourself juggling multiple terminal windows — one for your main task, one for a bug fix on a worktree, a shell tab for git operations. ClaudeTerminal puts all of that in one window with:\n\n- **Visual status at a glance** — see which sessions are working, idle, or need input without switching tabs\n- **Multi-project workspaces** — run sessions across multiple repositories in one window, each with its own color tint\n- **Session persistence** — close the app, reopen it, pick up where you left off\n- **One-click worktrees** — `Ctrl+W` creates a git worktree and scopes a new Claude session to it\n- **No context pollution** — each tab is isolated, with auto-generated descriptive names\n- **Desktop notifications** — get notified when a background session finishes or needs attention\n\n## Download\n\nGrab the latest release for your platform:\n\n**[Download from GitHub Releases](https://github.com/Mr8BitHK/claude-terminal/releases/latest)**\n\n| Platform | Format |\n|----------|--------|\n| Windows  | `.exe` installer |\n| macOS    | `.zip` |\n| Linux    | `.deb`, `.rpm` |\n\n\u003e **Prerequisites:** [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) must be installed and authenticated.\n\u003e\n\u003e Windows is the primary platform. macOS and Linux builds are provided but less tested.\n\n## Features\n\n### Tabbed Claude Code Sessions\n- **Claude tabs** — open multiple Claude Code sessions, each in its own terminal\n- **Shell tabs** — open plain PowerShell or WSL terminals alongside Claude sessions, with distinct icons per shell type\n- **Auto-naming** — uses Claude Haiku to analyze your first prompt and automatically generate descriptive tab names (e.g. \"Auth Bug Fix\" instead of \"Tab 3\")\n\n### Session Persistence\n- Tabs, names, and working directories are saved automatically on every state change\n- Full session restoration on app restart — every Claude session resumes exactly where you left off\n\n### Git Worktree Integration\n- Built-in worktree manager\n- Open new Claude sessions scoped to a specific worktree with `Ctrl+W`\n- Branches from the current directory's git branch, not just main\n\n### Multi-Project Workspaces\n- Open sessions across multiple repositories in a single window with `Ctrl+N`\n- Each project gets a distinct **color tint** on the window border so you always know which project is active\n- **Project sidebar** — shows all open projects with tab status counts; appears automatically when you have more than one project\n- **Project switcher** — `Ctrl+P` opens a quick-switch overlay with keyboard navigation\n- **Arrow key navigation** — `Ctrl+↑/↓` cycles between projects; `Ctrl+←/→` cycles tabs within the active project\n- Each project's tabs, worktrees, hooks, and git state are fully isolated from each other\n\n### Repository Hooks\n- Configure shell commands that run automatically on lifecycle events like `worktree:created`, `tab:created`, `session:started`, and more\n- Managed via a built-in UI dialog — no config files to edit manually\n- Per-repository config stored in `.claude-terminal/hooks.json`\n\n**Example:** Auto-install dependencies when a new worktree is created:\n```json\n{\n  \"hooks\": [\n    {\n      \"id\": \"install-deps\",\n      \"name\": \"Install dependencies\",\n      \"event\": \"worktree:created\",\n      \"commands\": [\n        { \"path\": \".\", \"command\": \"pnpm i\" }\n      ],\n      \"enabled\": true\n    }\n  ]\n}\n```\n\n![Hook execution status](docs/hooks-status.png)\n\n### Status \u0026 Notifications\n- **Per-tab status icons** — animated icons show whether each session is working, idle, or needs input\n- **Window title** — displays aggregate status (Idle/Working) so you can see it in your taskbar\n- **Status bar** — session status summary and keyboard shortcut hints\n- **Desktop notifications** — native OS notifications when Claude sessions complete tasks, encounter errors, or need your attention. Clicking a notification focuses the relevant tab.\n\n### Remote Access\n- Access your ClaudeTerminal sessions from any device via a Cloudflare tunnel\n- One-click activation generates a short access code and QR code\n- Read-only web client — view terminal output from your phone or another machine\n- Auto-reconnect on connection drops\n\n## Keyboard Shortcuts\n\n**Tabs**\n\n| Shortcut | Action |\n|----------|--------|\n| `Ctrl+T` | New Claude tab |\n| `Ctrl+W` | New worktree tab |\n| `Ctrl+Shift+P` | New PowerShell tab |\n| `Ctrl+Shift+L` | New WSL tab |\n| `Ctrl+Tab` / `Ctrl+→` | Next tab |\n| `Ctrl+Shift+Tab` / `Ctrl+←` | Previous tab |\n| `Ctrl+1`–`Ctrl+9` | Jump to tab by number |\n| `Ctrl+F4` | Close tab |\n| `F2` | Rename tab |\n\n**Projects**\n\n| Shortcut | Action |\n|----------|--------|\n| `Ctrl+N` | Add project to workspace |\n| `Ctrl+P` | Open project switcher |\n| `Ctrl+↑` | Previous project |\n| `Ctrl+↓` | Next project |\n\n## Build from Source\n\n```bash\n# Prerequisites: Node.js, pnpm\npnpm install\npnpm start        # Development\npnpm run make     # Build installer\n```\n\n## Acknowledgements\n\nSome features were inspired by [Maestro](https://runmaestro.ai/), a multi-agent orchestration tool for Claude Code.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr8bithk%2Fclaude-terminal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmr8bithk%2Fclaude-terminal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr8bithk%2Fclaude-terminal/lists"}