Skip to content

umage-ai/CodeShellManager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

150 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

CodeShellManager

Build Latest Release winget Chocolatey License: MIT

🌐 umage.ai/products/code-shell-manager β€” product page, screenshots, and latest news

A Windows desktop app for running multiple AI coding agents side-by-side β€” Claude Code, Codex, GitHub Copilot, or any CLI tool β€” in a tabbed and grid-layout terminal host.

Built with WPF + xterm.js + Windows ConPTY for full pseudo-terminal fidelity.

CodeShellManager screenshot showing four Claude Code sessions in a 2Γ—2 grid layout


Features

  • Multi-terminal grid β€” run up to 18 sessions simultaneously in configurable layouts (1, 2, 3, 4, 6 columns; 2Γ—2, 6Γ—2, 6Γ—3 grids); the active pane is highlighted with a 2px accent ring so it's easy to spot
  • Sleep & wake β€” πŸ’€ button parks a session: PTY torn down, but the session (and its notes) stays in the sidebar so you can wake it later from where you left off. Great when you have many long-running projects but only need a few live at once.
  • Full-text search β€” all terminal output indexed to SQLite FTS5; instant search across every session, ever
  • Per-project notepad β€” collapsible πŸ“ notes panel on every terminal, auto-saved and searchable
  • Alert detection β€” detects when Claude is waiting for input or tool approval; green/orange dot indicators
  • Git status β€” shows branch and dirty state in the sidebar per session
  • Session rename β€” double-click any session name or click ✏ to rename inline
  • Auto-resume β€” automatically resumes the last Claude Code session when restoring on startup (--resume <id>); toggleable in Settings
  • SSH remote sessions β€” connect to remote hosts using your existing SSH config; sessions persist across restarts
  • Session history β€” clicking a search result from a closed session offers to relaunch it
  • Configurable launch commands β€” customise the commands available in the New Session dialog
  • Claude badge β€” sessions running claude commands get a visual indicator
  • Tray icon β€” minimises to system tray; balloon notifications for alerts
  • Settings window β€” all options configurable; persisted as JSON

Requirements

Note: The .msi installer does not bundle the WebView2 runtime. If you're on Windows 10 and see a blank terminal pane, install the WebView2 runtime from the link above.

Installation

winget (recommended)

winget install UmageAI.CodeShellManager

Future updates pick up automatically with winget upgrade UmageAI.CodeShellManager (or winget upgrade --all).

Chocolatey

choco install codeshellmanager

Upgrade with choco upgrade codeshellmanager (or choco upgrade all).

Download from Releases

  1. Go to Releases
  2. Download either:
    • CodeShellManager-x.y.z-Setup.msi β€” installer (adds Start Menu + Desktop shortcuts, supports uninstall via Apps & Features)
    • CodeShellManager-x.y.z-win-x64.zip β€” portable; extract and run CodeShellManager.exe

Build from source

Requirements: .NET 10 SDK, Windows 10/11

git clone https://github.com/umage-ai/CodeShellManager.git
cd CodeShellManager
dotnet run --project src/CodeShellManager/CodeShellManager.csproj

Command-line flags

Flag Effect
--clean Start with no preloaded sessions and skip writing state.json for the run. Useful when developing β€” your saved sessions/settings are left untouched.

Keyboard Shortcuts

Key Action
Ctrl+T New session
Ctrl+W Close active session
Ctrl+F Toggle search
Ctrl+Tab Cycle sessions
Escape (in search) Close search panel

Layout Options

Click the layout buttons in the toolbar (right side):

Button Layout
β–£ Single pane
β–₯ 2 columns
β–¦ 3 columns
⊞ 2Γ—2 grid
⇔ 2 rows
4 4 columns
6 6 columns
6Γ—2 6 columns Γ— 2 rows (12 panes)
6Γ—3 6 columns Γ— 3 rows (18 panes)

Contributing

Issues and pull requests are welcome. See CLAUDE.md for architecture notes and coding conventions.

License

MIT β€” see LICENSE.


By umage.ai