Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/shironex/omniscribe

Orchestrate multiple AI coding sessions in parallel
https://github.com/shironex/omniscribe

ai claude claude-code electron parallel-agents terminal-based

Last synced: about 1 month ago
JSON representation

Orchestrate multiple AI coding sessions in parallel

Awesome Lists containing this project

README 

          





  Omniscribe

  
Omniscribe


  
Orchestrate multiple AI coding sessions in parallel



[![GitHub Release](https://img.shields.io/github/v/release/Shironex/omniscribe?style=flat&color=blue)](https://github.com/Shironex/omniscribe/releases/latest)

[![Downloads](https://img.shields.io/github/downloads/Shironex/omniscribe/total?style=flat&color=green)](https://github.com/Shironex/omniscribe/releases/latest)

[![Electron](https://img.shields.io/badge/Electron-40.2-47848F?logo=electron&logoColor=white)](https://www.electronjs.org/)

[![React](https://img.shields.io/badge/React-18.3-61DAFB?logo=react&logoColor=white)](https://react.dev/)

[![NestJS](https://img.shields.io/badge/NestJS-10.4-E0234E?logo=nestjs&logoColor=white)](https://nestjs.com/)

[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)

[![OS](https://img.shields.io/badge/OS-Windows%20%7C%20macOS-0078D4)](https://github.com/Shironex/omniscribe)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)



**[Download Latest Release](https://github.com/Shironex/omniscribe/releases/latest)** | [macOS](https://github.com/Shironex/omniscribe/releases/latest) | [Windows](https://github.com/Shironex/omniscribe/releases/latest)



**[Beta Releases](https://github.com/Shironex/omniscribe/releases)** — opt into pre-release builds via Settings > About > Updates






## Table of Contents



- [About](#about)

- [Screenshots](#screenshots)

- [Features](#features)

- [Keyboard Shortcuts](#keyboard-shortcuts)

- [Requirements](#requirements)

- [Quick Start](#quick-start)

- [Development](#development)

- [Architecture](#architecture)

- [Tech Stack](#tech-stack)

- [Beta Releases](#beta-releases)

- [Roadmap](#roadmap)

- [Contributing](#contributing)

- [License](#license)



## About



Omniscribe is a desktop application for managing multiple AI coding assistant sessions simultaneously. With a plugin-based architecture supporting Claude Code and OpenAI Codex CLI, you can run up to 12 sessions in parallel, each with its own GPU-accelerated terminal, optional git worktree isolation, and MCP server configuration.



## Screenshots



### Multi-Session Grid with Quick Actions



![Multi-session grid with quick actions menu](assets/quick_actions.png)



### Main View



![Main grid view with 6 parallel sessions](assets/main.png)



### Settings



![Settings view with Claude CLI integration](assets/settings.png)



## Features



| Feature                | Description                                                                                          |

| ---------------------- | ---------------------------------------------------------------------------------------------------- |

| **Multi-Session Grid** | Run up to 12 AI sessions in parallel with GPU-accelerated terminal views                             |

| **Real-Time Status**   | Track session states: idle, working, planning, needs_input, finished                                 |

| **Session History**    | Browse, search, and filter past Claude Code sessions with branch filtering and sort controls         |

| **Resume & Fork**      | Resume any previous session or fork it into a new conversation branch                                |

| **Continue Last**      | One-click button to continue the most recent Claude Code conversation                                |

| **Drag & Drop**        | Rearrange terminals by dragging; resizable panels with drag dividers                                 |

| **Terminal Search**    | Ctrl+Shift+F search bar with regex and case-sensitive modes                                          |

| **12 Terminal Themes** | dracula, nord, gruvbox, and more                                                                     |

| **8 UI Themes**        | Forge (default, dark), Carbon, Ember, Iceberg, Nord, Gruvbox, Dracula, Paper (light)                 |

| **Terminal Settings**  | Font family/size, cursor style, scrollback, theme — all applied live                                 |

| **Smart Copy/Paste**   | Ctrl+C copies selection or sends ^C; Ctrl+V pastes from clipboard                                    |

| **File Path Links**    | Clickable file paths in terminal output open directly in VS Code                                     |

| **Quick Actions**      | AI-powered shortcuts for git workflows (commit, push, pull, resolve conflicts) and development tasks |

| **Git Worktrees**      | Isolate each session in its own git worktree for parallel development                                |

| **MCP Integration**    | Configure Model Context Protocol servers per session                                                 |

| **Hooks Integration**  | Automatic Claude Code hooks for instant session detection via SessionStart/SessionEnd events         |

| **Project Tabs**       | Manage multiple projects with persistent recent history                                              |

| **Cross-Platform**     | Native support for Windows and macOS                                                                 |



## Keyboard Shortcuts



| Shortcut               | Action                           |

| ---------------------- | -------------------------------- |

| `N`                    | Add new session slot             |

| `Shift + N`            | Open launch presets modal        |

| `L`                    | Launch all pending sessions      |

| `1-9`, `0`, `-`, `=`   | Launch individual session (1-12) |

| `Ctrl/Cmd + K`         | Stop all running sessions        |

| `Ctrl/Cmd + ,`         | Toggle settings                  |

| `Ctrl/Cmd + Shift + H` | Toggle session history panel     |

| `Ctrl/Cmd + W`         | Close current project tab        |

| `Ctrl/Cmd + 1-9`       | Switch project tab by index      |

| `Ctrl/Cmd + L`         | Clear focused terminal           |

| `Ctrl/Cmd + F`         | Toggle terminal search bar       |



## Requirements



- **Node.js** >= 22.0.0

- **pnpm** >= 9.0.0



## Quick Start



```bash

# Clone the repository

git clone https://github.com/Shironex/omniscribe.git

cd omniscribe



# Install dependencies

pnpm install



# Start development

pnpm dev



# Build for production

pnpm build



# Package for distribution

pnpm package          # Current platform

pnpm package:win      # Windows

pnpm package:mac      # macOS

```



## Development



```bash

# Run tests

pnpm test



# Run tests with coverage

pnpm test:cov



# Type checking

pnpm typecheck



# Lint code

pnpm lint



# Format code

pnpm format



# Check formatting

pnpm format:check

```



## Architecture



```

omniscribe/

├── apps/

│   ├── desktop/       # Electron + NestJS backend

│   ├── web/           # React frontend

│   └── mcp-server/    # MCP status server

└── packages/

    ├── plugin-api/    # Plugin API contracts and base classes

    ├── plugins/

    │   ├── provider-claude/  # Claude Code provider plugin

    │   └── provider-codex/   # OpenAI Codex CLI provider plugin

    └── shared/        # Shared types and utilities

```



**Communication Flow:**



```

┌─────────────────────────────────┐

│     Electron Main Process       │

│  ┌───────────────────────────┐  │

│  │    NestJS Backend         │  │

│  │  Terminal │ Session │ Git │  │

│  │    MCP    │ Workspace     │  │

│  └───────────────────────────┘  │

│              │ WebSocket        │

└──────────────┼──────────────────┘

               │

┌──────────────┼──────────────────┐

│     Electron Renderer           │

│  ┌───────────────────────────┐  │

│  │    React + Zustand        │  │

│  │   Terminal Grid │ Stores  │  │

│  └───────────────────────────┘  │

└─────────────────────────────────┘

```



## Tech Stack



| Layer    | Technology                 |

| -------- | -------------------------- |

| Desktop  | Electron 40                |

| Backend  | NestJS 10                  |

| Frontend | React 18, Zustand 5        |

| Terminal | xterm.js (WebGL), node-pty |

| Styling  | Tailwind CSS               |

| Build    | Vite, esbuild              |

| IPC      | Socket.io, Electron IPC    |



## Beta Releases



Omniscribe supports a beta update channel for testing new features before stable release.



**To opt in:**



1. Open **Settings > About > Updates**

2. Click the **Beta** button to switch channels

3. The app will automatically check for and offer beta updates



**To opt out:** Switch back to **Stable** in the same settings panel. If a stable version is older than your current beta, a downgrade will be offered.



Beta releases are tagged with a `-beta` suffix (e.g. `v0.5.0-beta.1`) and marked as pre-release on the [Releases page](https://github.com/Shironex/omniscribe/releases).



## Roadmap



Track our progress on the [public project board](https://github.com/users/Shironex/projects/7).



### v1.1 — Plugin System & Multi-Provider Support



Omniscribe is now a **universal AI coding orchestrator** with a plugin architecture supporting multiple providers.



| Phase                      | Description                                                   | Status      |

| -------------------------- | ------------------------------------------------------------- | ----------- |

| Plugin API Contracts       | Typed interfaces and manifest format for provider plugins     | Done        |

| Backend Infrastructure     | Plugin registry, dynamic module loading, service delegation   | Done        |

| Claude Provider Extraction | Move Claude-specific logic into a plugin package              | Done        |

| Frontend Extensions        | Slot-based UI injection, dynamic settings, in-app marketplace | Done        |

| Codex Provider             | Second provider (OpenAI Codex CLI) proving the architecture   | In Progress |



The Codex provider is functional for session management and usage tracking. MCP integration for Codex is still in development.



**Want to add a provider?** See the [Creating a Provider](https://shironex.github.io/omniscribe/sdk/creating-a-provider) guide and the [API Reference](https://shironex.github.io/omniscribe/docs/api).



## Contributing



Contributions are welcome! Feel free to:



- [Submit an issue](https://github.com/Shironex/omniscribe/issues) for bugs or feature requests

- Open a pull request with improvements

- Read the [Creating a Provider](https://shironex.github.io/omniscribe/sdk/creating-a-provider) guide to contribute a provider plugin

- Share feedback and suggestions



## License



This project is licensed under the [MIT License](LICENSE).



---



[Back to top](#top)