Configuration¶

Narnia reads configuration from environment variables. No API key is required — all data is local to your machine.

Environment Variables¶

Variable	Default	Description
`NARNIA__DatabasePath`	`~/.copilot/session-store.db`	Path to the Copilot CLI SQLite session database
`NARNIA__SessionStatePath`	`~/.copilot/session-state/`	Directory containing per-session state folders
`NARNIA__WebUiUrl`	`http://localhost:5244`	URL where the Narnia web UI will be served
`NARNIA__WebProjectPath`	(auto-detected)	Path to the `NexusLabs.Narnia.Web` project (used by `open_narnia_ui` when a published binary is not found)

Setting Variables in mcp-config.json¶

Pass environment variables via the env block in your MCP client config:

{
  "mcpServers": {
    "narnia": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/narnia/src/NexusLabs.Narnia.McpServer"],
      "env": {
        "NARNIA__DatabasePath": "D:\\custom-path\\session-store.db",
        "NARNIA__SessionStatePath": "D:\\custom-path\\session-state\\"
      }
    }
  }
}

Default Paths¶

The defaults resolve to the standard Copilot CLI locations on all platforms:

Windows: C:\Users\{username}\.copilot\
macOS / Linux: ~/.copilot/

If your Copilot CLI data is in the default location, no configuration is required.

Web UI Port¶

If port 5244 is in use, set NARNIA__WebUiUrl to a different port:

"env": {
  "NARNIA__WebUiUrl": "http://localhost:6244"
}

The open_narnia_ui MCP tool uses this value to health-check and open the correct URL.