MCPcopy Index your code
hub / github.com/MertPROJ/xshell

github.com/MertPROJ/xshell @v1.5.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.5.0 ↗ · + Follow
466 symbols 813 edges 44 files 17 documented · 4%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

xshell

xshell

A native home for your Claude Code sessions.

License: MIT Platform Latest Release Built with Tauri Built with Rust

Independent project. Not affiliated with, endorsed by, or a product of Anthropic. xshell reads files written by the official claude CLI and spawns it as a subprocess. "Claude" and "Claude Code" are trademarks of Anthropic, PBC.

Preview

xshell demo

🌐 xshell.sh

Why this exists

Open terminal. cd somewhere. Type claude. Repeat for every project, every day.

xshell skips that. All your projects, all your past sessions, all the costs — one screen, one click.

How it works

xshell reads the files Claude Code writes to ~/.claude/ and spawns the claude CLI when you start a session. No API proxy, no telemetry, no replacement implementation. If Claude Code works on your machine, xshell works.

What you see

Every project on your machine that Claude Code has touched. Every session, sorted by what you opened last. Cost per session, per project, per day.

The data is all in ~/.claude/ already. xshell just shows it in one place.

Features

  • 🗂️ Sidebar with every project Claude Code has touched. Pin, group, drag-and-drop.
  • 📜 One-click session resume with full history per project.
  • 💻 Real terminals, splittable side-by-side. xterm.js + native PTYs.
  • 🌿 Live branch and worktree awareness in the sidebar.
  • 🧩 Context tree for skills, agents, plugins, MCP servers, hooks, slash commands, and CLAUDE.md.
  • 📊 Cost, context, and rate-limit tracking per session and across your account.
  • 🪶 Inline git panel with diff counts and staging.

Built with Tauri 2 and Rust. Native on Windows, macOS, and Linux.

Install

The fastest way — one line, works everywhere:

Windows (PowerShell)

irm https://xshell.sh/install.ps1 | iex

macOS / Linux

curl -fsSL https://xshell.sh/install.sh | bash

The script downloads the right binary for your platform from the latest GitHub release into ~/.xshell/bin/, drops a Start Menu / .desktop entry, adds itself to PATH, and launches the app. Re-run the same command to update.

Or download an installer directly

Platform File
Windows xshell_<version>_x64_en-US.msi or xshell_<version>_x64-setup.exe
macOS xshell_<version>_universal.dmg
Linux xshell_<version>_amd64.deb, xshell-<version>-1.x86_64.rpm, or xshell_<version>_amd64.AppImage

The claude CLI must be installed and on PATH.

Contributing

Issues and pull requests welcome. See CONTRIBUTING.md for development setup, project structure, and PR guidelines.

License

MIT © 2026 xshell Contributors

xshell is independent software. It reads files written by Anthropic's claude CLI and runs claude as a subprocess. "Claude" and "Claude Code" are trademarks of Anthropic, PBC.

Extension points exported contracts — how you extend this code

AgentMeta (Interface)
(no doc)
src/agents.tsx
ProjectInfo (Interface)
(no doc)
src/types.ts
CursorIconProps (Interface)
(no doc)
src/components/CursorIcon.tsx
ReleaseEntry (Interface)
(no doc)
src/hooks/useUpdateCheck.ts
CodexProjectInfo (Interface)
(no doc)
src/types.ts
TabBarProps (Interface)
(no doc)
src/components/TabBar.tsx
UpdateInfo (Interface)
(no doc)
src/hooks/useUpdateCheck.ts
AgentContextItem (Interface)
(no doc)
src/types.ts

Core symbols most depended-on inside this repo

ttProps
called by 35
src/components/Tooltip.tsx
showTooltip
called by 9
src/components/TabBar.tsx
x
called by 9
src/components/HomeView.tsx
get_claude_projects_dir
called by 8
src-tauri/src/lib.rs
git_cmd
called by 8
src-tauri/src/lib.rs
collectLeafIds
called by 7
src/layout.ts
useTooltip
called by 7
src/components/Tooltip.tsx
useTt
called by 7
src/components/Tooltip.tsx

Shape

Function 349
Interface 81
Class 36

Languages

TypeScript75%
Rust25%

Modules by API surface

src-tauri/src/lib.rs114 symbols
src/types.ts39 symbols
src/components/HomeView.tsx38 symbols
src/components/TerminalTab.tsx33 symbols
src/components/SkillsPanel.tsx28 symbols
src/components/Sidebar.tsx18 symbols
src/components/TabBar.tsx15 symbols
src/components/FileExplorerPanel.tsx14 symbols
src/components/RateLimitIndicator.tsx13 symbols
src/components/DetailedSessionInfoWizard.tsx13 symbols
src/components/QuickActionsDialog.tsx11 symbols
src/App.tsx11 symbols

For agents

$ claude mcp add xshell \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact