Shob - Run multiple CLI agents across sessions within a single project

Shob is a desktop app for running and organizing multiple CLI agents in one workspace. It helps you keep parallel sessions focused, persistent, and easy to switch between.

Why Shob

• Run multiple CLI sessions side by side.
• Keep session context inside the same project.
• Switch quickly between tasks without losing flow.
• Use a desktop-first experience powered by Electron.

Tech Stack

• React 19 + TypeScript
• Vite
• Electron
• pnpm

Project Structure

• src/: React UI and client logic
• src/components/: UI components and app views
• electron/: Electron main/preload process code
• .github/workflows/: Build and release workflow

Requirements

• Node.js 22+
• pnpm

Quick Start

pnpm install
pnpm electron

Build

pnpm build
pnpm build:electron

Scripts

• pnpm dev: Start Vite dev server
• pnpm electron: Run Electron app in development
• pnpm build: Type-check and build frontend
• pnpm build:electron: Build desktop installers with electron-builder
• pnpm lint: Run ESLint
• pnpm preview: Preview production frontend build

Release

GitHub Actions builds desktop installers when you push a version tag.

git tag vX.Y.Z
git push origin vX.Y.Z

Workflow output includes platform builds for Windows, macOS, and Linux.

License

Proprietary or internal use by default unless you add a license file.