Skip to content

Getting Started

Prerequisites

  • .NET 10 SDK
  • GitHub Copilot CLI with at least one session in ~/.copilot/session-store.db

Step 1: Get Narnia

Option A — Clone and build from source:

git clone https://github.com/ncosentino/narnia.git
cd narnia
dotnet build

Option B — Download the published binary:

Download the latest release from GitHub Releases for your platform.

Step 2: Configure Your MCP Client

Add Narnia to your MCP client configuration. See Setup by Tool for per-client snippets.

For GitHub Copilot CLI, add to ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "narnia": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "C:\\path\\to\\narnia\\src\\NexusLabs.Narnia.McpServer"
      ]
    }
  }
}

Replace the path with the actual location of the cloned repo on your machine.

Step 3: Verify the Tools Are Available

Start a new Copilot CLI session. Ask it:

"List my most recent Narnia sessions"

or

"Find sessions where I was working on the macerus project"

You should see results from your local session history.

Step 4 (Optional): Run the Web UI

The Narnia web UI provides a visual browser for session history. Start it from the repo root:

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

Then navigate to http://localhost:5244 in your browser.

You can also ask your MCP client to open it for you via the open_narnia_ui tool.

Next Steps