narnia

Narnia

Narnia is a single ASP.NET Core app — both an MCP server and a Blazor web UI — for browsing and searching GitHub Copilot CLI session history, recovering lost terminal windows, and managing scheduled Copilot jobs.

If you use Copilot CLI heavily, you know the pain: a Windows update reboots your machine and every active session terminal is gone. Narnia makes it easy to find and resume sessions — either by asking a new Copilot session to search for you (via MCP), or by browsing a local web interface.

---

Features

• MCP Server — one shared HTTP endpoint (/mcp) exposing 27 tools that any MCP-compatible client (including Copilot CLI) can call to search session history, recover incompatible sessions, inspect storage, clean up local sessions, and manage or transfer scheduled jobs — no per-client process to launch, every client talks to the same running instance
• Web UI — Blazor Static SSR local web interface for browsing, searching, favoriting, and reading session details, checkpoints, and conversation turns, with persistent browser-local table column widths
• Scheduled Jobs — create, edit, monitor, export, share, and safely import Windows Task Scheduler-backed copilot -p jobs with hidden execution, live logs, portable file packages, and disabled-first destination registration
• Terminal window recovery — continuously records your open Windows Terminal windows of Copilot tabs so you can reopen a whole multi-tab window after it is closed or lost, like restoring a browser window
• Session organization — save exact, ordered Session Groups for reopening together and place related sessions in overlapping Collections that can span repositories
• Broken-session recovery — detect incompatible Copilot event history, block unsafe launches, archive the broken stream, and have Copilot reseed the same session ID and folder
• Session storage — measure per-session disk usage and growth, identify stale or risky sessions, and delete validated local data through the official Copilot SDK
• Session workspace — reads supplemental metadata from ~/.copilot/session-state/ including git root and session artifact files

---

Prerequisites

• Windows x64 for the supported prebuilt release and the complete recovery/scheduling feature set
• Copilot CLI with an existing ~/.copilot/session-store.db
• .NET 10 SDK only when building from source or using the rolling plugin/source-build channel

---

Running Narnia

Narnia is a single process: starting the web app also starts the MCP server. There is no separate MCP server to build or launch.

Install a tagged Windows x64 release

Download narnia-win-x64.zip and SHA256SUMS.txt from the Releases page, verify the archive, and extract it directly into Narnia's application directory:

$expected = ((Get-Content .\SHA256SUMS.txt) -split '\s+')[0]
$actual = (Get-FileHash .\narnia-win-x64.zip -Algorithm SHA256).Hash.ToLowerInvariant()
if ($actual -ne $expected) { throw "Narnia release checksum mismatch." }

$runDir = Join-Path $env:LOCALAPPDATA 'narnia\app'
New-Item -ItemType Directory -Path $runDir -Force | Out-Null
Expand-Archive .\narnia-win-x64.zip -DestinationPath $runDir -Force
Start-Process (Join-Path $runDir 'NexusLabs.Narnia.Web.exe') `
  -ArgumentList '--urls','http://127.0.0.1:5244' `
  -WorkingDirectory $runDir `
  -WindowStyle Hidden

The release is self-contained and does not require .NET to be installed. Release executables are currently unsigned, so Windows SmartScreen may identify the publisher as unknown; verify the published SHA-256 checksum before running the archive.

To update a downloaded release, call POST http://127.0.0.1:5244/shutdown, wait for the server to exit, replace the application directory with the new ZIP contents, and start it again. Settings, schedules, and window history live outside the application directory.

Run from source

dotnet run --project src/NexusLabs.Narnia.Web

Then open http://localhost:5244 in your browser.