claude-terminal

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #llm #machine-learning #rust #docker #macos #java #awesome #kubernetes #pytorch #mcp #open-source

claude-terminal

(★ 15)

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.

claude-terminal Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ClaudeTerminal

[![GitHub release](https://img.shields.io/github/v/release/Mr8BitHK/claude-terminal)](https://github.com/Mr8BitHK/claude-terminal/releases/latest)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/Mr8BitHK/claude-terminal/master/LICENSE)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue)](https://raw.githubusercontent.com/Mr8BitHK/claude-terminal/master/)

![ClaudeTerminal demo](https://raw.githubusercontent.com/Mr8BitHK/claude-terminal/master/docs/quickdemo.gif)

A tabbed terminal manager for running multiple **Claude Code** sessions side by side — with multi-project workspaces, session persistence, git worktree integration, and auto-naming.

Think Windows Terminal, but purpose-built for Claude Code.

## Why ClaudeTerminal?

If 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:

- **Visual status at a glance** — see which sessions are working, idle, or need input without switching tabs
- **Multi-project workspaces** — run sessions across multiple repositories in one window, each with its own color tint
- **Session persistence** — close the app, reopen it, pick up where you left off
- **One-click worktrees** — `Ctrl+W` creates a git worktree and scopes a new Claude session to it
- **No context pollution** — each tab is isolated, with auto-generated descriptive names
- **Desktop notifications** — get notified when a background session finishes or needs attention

## Download

Grab the latest release for your platform:

**[Download from GitHub Releases](https://github.com/Mr8BitHK/claude-terminal/releases/latest)**

| Platform | Format |
|----------|--------|
| Windows  | `.exe` installer |
| macOS    | `.zip` |
| Linux    | `.deb`, `.rpm` |

> **Prerequisites:** [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) must be installed and authenticated.
>
> Windows is the primary platform. macOS and Linux builds are provided but less tested.

## Features

### Tabbed Claude Code Sessions
- **Claude tabs** — open multiple Claude Code sessions, each in its own terminal
- **Shell tabs** — open plain PowerShell or WSL terminals alongside Claude sessions, with distinct icons per shell type
- **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")

### Session Persistence
- Tabs, names, and working directories are saved automatically on every state change
- Full session restoration on app restart — every Claude session resumes exactly where you left off

### Git Worktree Integration
- Built-in worktree manager
- Open new Claude sessions scoped to a specific worktree with `Ctrl+W`
- Branches from the current directory's git branch, not just main

### Multi-Project Workspaces
- Open sessions across multiple repositories in a single window with `Ctrl+N`
- Each project gets a distinct **color tint** on the window border so you always know which project is active
- **Project sidebar** — shows all open projects with tab status counts; appears automatically when you have more than one project
- **Project switcher** — `Ctrl+P` opens a quick-switch overlay with keyboard navigation
- **Arrow key navigation** — `Ctrl+↑/↓` cycles between projects; `Ctrl+←/→` cycles tabs within the active project
- Each project's tabs, worktrees, hooks, and git state are fully isolated from each other

### Repository Hooks
- Configure shell commands that run automatically on lifecycle events like `worktree:created`, `tab:created`, `session:started`, and more
- Managed via a built-in UI dialog — no config files to edit manually
- Per-repository config stored in `.claude-terminal/hooks.json`

**Example:** Auto-install dependencies when a new worktree is created:
```json
{
  "hooks": [
    {
      "id": "install-deps",
      "name": "Install dependencies",
      "event": "worktree:created",
      "commands": [
        { "path": ".", "command": "pnpm i" }
      ],
      "enabled": true
    }
  ]
}
```

![Hook execution status](https://raw.githubusercontent.com/Mr8BitHK/claude-terminal/master/docs/hooks-status.png)

### Status & Notifications
- **Per-tab status icons** — animated icons show whether each session is working, idle, or needs input
- **Window title** — displays aggregate status (Idle/Working) so you can see it in your taskbar
- **Status bar** — session status summary and keyboard shortcut hints
- **Desktop notifications** — native OS notifications when Claude sessions complete tasks, encounter errors, or need your attention. Clicking a notification focuses the relevant tab.

### Remote Access
- Access your ClaudeTerminal sessions from any device via a Cloudflare tunnel
- One-click activation generates a short access code and QR code
- Read-only web client — view terminal output from your phone or another machine
- Auto-reconnect on connection drops

## Keyboard Shortcuts

**Tabs**

| Shortcut | Action |
|----------|--------|
| `Ctrl+T` | New Claude tab |
| `Ctrl+W` | New worktree tab |
| `Ctrl+Shift+P` | New PowerShell tab |
| `Ctrl+Shift+L` | New WSL tab |
| `Ctrl+Tab` / `Ctrl+→` | Next tab |
| `Ctrl+Shift+Tab` / `Ctrl+←` | Previous tab |
| `Ctrl+1`–`Ctrl+9` | Jump to tab by number |
| `Ctrl+F4` | Close tab |
| `F2` | Rename tab |

**Projects**

| Shortcut | Action |
|----------|--------|
| `Ctrl+N` | Add project to workspace |
| `Ctrl+P` | Open project switcher |
| `Ctrl+↑` | Previous project |
| `Ctrl+↓` | Next project |

## Build from Source

```bash
# Prerequisites: Node.js, pnpm
pnpm install
pnpm start        # Development
pnpm run make     # Build installer
```

## Acknowledgements

Some features were inspired by [Maestro](https://runmaestro.ai/), a multi-agent orchestration tool for Claude Code.

## License

[MIT](LICENSE)

claude-terminal

claude-terminal Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

claude-terminal

claude-terminal Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README