### Apply Minimal Narsil-MCP Configuration

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/configs/README.md

This command copies the minimal configuration file to the user's Narsil-MCP configuration directory, enabling a fast and lightweight code intelligence setup.

```bash
cp examples/configs/minimal.yaml ~/.config/narsil-mcp/config.yaml
```

--------------------------------

### Minimal Narsil-MCP Configuration

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/configuration.md

This configuration enables basic repository, symbols, search, and LSP tools while disabling others. It sets performance limits for tool count and startup latency. This is a good starting point for a minimal setup.

```yaml
version: "1.0"
preset: "minimal"

tools:
  categories:
    Repository:
      enabled: true
    Symbols:
      enabled: true
    Search:
      enabled: true
    LSP:
      enabled: true

    # Disable everything else
    Git:
      enabled: false
    CallGraph:
      enabled: false
    Security:
      enabled: false
    SupplyChain:
      enabled: false
    Analysis:
      enabled: false

performance:
  max_tool_count: 30
  startup_latency_ms: 5
```

--------------------------------

### Run narsil-mcp with recommended flags

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/getting-started.md

A recommended command-line configuration for narsil-mcp that enables Git integration, call graph analysis, and persistent indexing for faster startup times. Adjust the project path as needed.

```bash
narsil-mcp --repos /path/to/project --git --call-graph --persist
```

--------------------------------

### Install narsil-mcp using Homebrew, npm, or Cargo

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/getting-started.md

Install the narsil-mcp tool using package managers like Homebrew for macOS/Linux, npm for all platforms, or Cargo for Rust users. Alternatively, download pre-compiled binaries from GitHub releases.

```bash
# Homebrew (macOS/Linux)
brew install postrv/narsil/narsil-mcp

# npm (all platforms)
npm install -g narsil-mcp

# Cargo (Rust users)
cargo install narsil-mcp

# Or download binary from GitHub releases
```

--------------------------------

### Configure Claude Code (CLI) for narsil-mcp

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/getting-started.md

Set up narsil-mcp for Claude Code by adding configuration to `~/.claude/settings.json`. This allows the CLI tool to leverage narsil-mcp for code analysis within the current directory.

```json
{
  "mcpServers": {
    "narsil-mcp": {
      "command": "narsil-mcp",
      "args": ["--repos", ".", "--git", "--call-graph"]
    }
  }
}
```

--------------------------------

### Apply Balanced Narsil-MCP Configuration

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/configs/README.md

This command copies the balanced configuration file to the user's Narsil-MCP configuration directory, providing a full-featured code intelligence setup for daily development.

```bash
cp examples/configs/balanced.yaml ~/.config/narsil-mcp/config.yaml
```

--------------------------------

### Verify narsil-mcp Installation

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/getting-started.md

After installation, verify that narsil-mcp is correctly installed and accessible by running the version command. This confirms the binary is in your system's PATH.

```bash
narsil-mcp --version
# narsil-mcp 1.1.4
```

--------------------------------

### Start Narsil-MCP Server (Bash)

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/configuration.md

Command to start the Narsil-MCP server, specifying the project directory to analyze. This is a common command used after configuring the tool.

```bash
narsil-mcp --repos ~/project
```

--------------------------------

### React Example with CodeIntelClient

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/wasm.md

An example of integrating `CodeIntelClient` into a React component. It initializes the client, indexes provided files, and displays extracted symbols in a list.

```tsx
import { useEffect, useState } from 'react';
import { CodeIntelClient, Symbol } from '@narsil-mcp/wasm';

function CodeExplorer({ files }: { files: Record<string, string> }) {
  const [client, setClient] = useState<CodeIntelClient | null>(null);
  const [symbols, setSymbols] = useState<Symbol[]>([]);

  useEffect(() => {
    const init = async () => {
      const c = new CodeIntelClient();
      await c.init();

      // Index all files
      for (const [path, content] of Object.entries(files)) {
        c.indexFile(path, content);
      }

      setClient(c);
      setSymbols(c.findSymbols());
    };
    init();
  }, [files]);

  return (
    <ul>
      {symbols.map(s => (
        <li key={`${s.file_path}:${s.name}`}>
          {s.kind}: {s.name} ({s.file_path}:{s.start_line})
        </li>
      ))}
    </ul>
  );
}

```

--------------------------------

### Frontend Development Commands (Bash)

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/frontend.md

Common npm commands for managing the frontend development environment. These include installing dependencies, starting the development server, building for production, and previewing the production build.

```bash
cd frontend
npm install
npm run dev      # Development server
npm run build    # Production build
npm run preview  # Preview production build
```

--------------------------------

### Run Frontend in Development Mode (Bash)

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/frontend.md

Starts the narsil-mcp API server and the frontend development server separately. This setup is recommended for frontend development, allowing independent iteration on both the backend and frontend.

```bash
# Terminal 1: Start the API server
./target/release/narsil-mcp --repos ~/project --http --call-graph

# Terminal 2: Start the frontend dev server
cd frontend
npm install
npm run dev
# Frontend runs on http://localhost:5173, connects to API on :3000
```

--------------------------------

### Configure Claude Desktop for narsil-mcp

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/getting-started.md

Configure Claude Desktop to use narsil-mcp by editing the `claude_desktop_config.json` file. This involves specifying the command to run narsil-mcp and its arguments, such as the project repository path.

```json
{
  "mcpServers": {
    "narsil-mcp": {
      "command": "narsil-mcp",
      "args": ["--repos", "/path/to/your/project", "--git", "--call-graph"]
    }
  }
}
```

--------------------------------

### narsil-mcp Configuration File Example

Source: https://context7.com/postrv/narsil-mcp/llms.txt

Provides an example of a `config.yaml` file for narsil-mcp, demonstrating how to set a preset, enable/disable tool categories, override specific tool configurations, and adjust performance settings.

```yaml
version: "1.0"
preset: "balanced"

tools:
  categories:
    Repository:
      enabled: true
    Symbols:
      enabled: true
    Search:
      enabled: true
    Git:
      enabled: true
    Security:
      enabled: true

  overrides:
    neural_search:
      enabled: false
      reason: "Too slow for interactive use"
    generate_sbom:
      enabled: true
      config:
        format: "cyclonedx"

performance:
  max_tool_count: 50
```

--------------------------------

### Example Copilot Chat Prompts for Codebase Analysis

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/integrations/vscode-copilot.md

Demonstrates example prompts to use with Copilot Chat for interacting with the narsil-mcp analysis of a codebase. These prompts cover general structure, API endpoints, function call tracing, and security vulnerability checks.

```markdown
@workspace What's the structure of this project?

@workspace Find all API endpoints

@workspace What calls the handlePayment function?

@workspace Are there any security issues?
```

--------------------------------

### CCG Bundle Structure Example

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/ccg-spec.md

This example shows the typical file structure within a CCG bundle, which is a ZIP archive containing different layers of the code context graph. It includes manifest, architecture, symbol index, full detail files, and optional access control and README files.

```bash
repo-name.ccg.zip/
  manifest.json         # Layer 0
  architecture.json     # Layer 1
  symbol-index.nq.gz    # Layer 2
  full-detail.nq.gz     # Layer 3
  acl.ttl               # Access control (optional)
  README.md             # Human-readable summary (optional)
```

--------------------------------

### Verify narsil-mcp Setup with Copilot Chat

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/integrations/vscode-copilot.md

Provides a command to verify that narsil-mcp has correctly indexed the repositories within the VS Code workspace. This prompt, when used in Copilot Chat, should list all indexed repositories, confirming the setup.

```markdown
@workspace List the indexed repositories
```

--------------------------------

### Setup Neural Embeddings for Semantic Search

Source: https://context7.com/postrv/narsil-mcp/llms.txt

Configure narsil-mcp for neural semantic search using embeddings. An interactive wizard is recommended for setup.

```bash
# Interactive wizard (recommended)
narsil-mcp config init --neural
```

--------------------------------

### Narsil MCP Server Configuration Example

Source: https://github.com/postrv/narsil-mcp/blob/main/narsil-plugin/README.md

An example `.mcp.json` file demonstrating how to configure the narsil-mcp server with various options such as repository paths, git integration, call graph analysis, and persistence.

```json
{
  "mcpServers": {
    "narsil-mcp": {
      "command": "narsil-mcp",
      "args": [
        "--repos", "~/projects/myrepo",
        "--git",
        "--call-graph",
        "--neural",
        "--persist",
        "--watch"
      ],
      "env": {
        "VOYAGE_API_KEY": "your-key-here"
      }
    }
  }
}
```

--------------------------------

### CLI Usage for Multiple Repositories

Source: https://github.com/postrv/narsil-mcp/blob/main/npm/README.md

Command-line interface usage for narsil-mcp. This example shows how to index multiple specified repositories.

```bash
narsil-mcp --repos ~/project1 ~/project2
```

--------------------------------

### Generic Endpoint Example

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/api.md

This section provides a template for a generic API endpoint, illustrating the expected structure for requests and responses.

```APIDOC
## [METHOD] /path

### Description
Description

### Method
[METHOD]

### Endpoint
/path

### Parameters
#### Path Parameters

#### Query Parameters

#### Request Body

### Request Example
```json
{}
```

### Response
#### Success Response (200)

#### Response Example
```json
{}
```
```

--------------------------------

### CCG Registry URL Pattern Example

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/ccg-spec.md

This example illustrates the URL pattern used to access CCGs published on the `codecontextgraph.com` registry. It shows how to specify the host, owner, repository, and commit hash to retrieve specific layers of the graph, including a 'latest' version alias.

```http
https://codecontextgraph.com/ccg/{host}/{owner}/{repo}@{commit}/manifest.json
https://codecontextgraph.com/ccg/{host}/{owner}/{repo}@{commit}/architecture.json
https://codecontextgraph.com/ccg/{host}/{owner}/{repo}@{commit}/symbol-index.nq.gz
https://codecontextgraph.com/ccg/{host}/{owner}/{repo}@{commit}/full-detail.nq.gz

**Latest version alias:**
https://codecontextgraph.com/ccg/{host}/{owner}/{repo}/latest/manifest.json
```

--------------------------------

### Customize Narsil-MCP Configuration with Overrides

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/configs/README.md

This YAML snippet demonstrates how to customize a Narsil-MCP configuration by enabling specific tools, such as neural search, with a reason for the override.

```yaml
# Enable additional tools
tools:
  overrides:
    neural_search:
      enabled: true
      reason: "I have API key and want neural search"
```

--------------------------------

### Rust Example Code

Source: https://github.com/postrv/narsil-mcp/blob/main/tests/README.md

A simple Rust code snippet demonstrating a struct `User` and a function `process_user`. This serves as a test fixture for Rust code parsing.

```rust
pub struct User {
    pub name: String,
    pub age: u32,
}

pub fn process_user(user: &User) -> bool {
    true
}
```

--------------------------------

### Load and Query RDF Layers with Oxigraph

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/ccg/README.md

Shows how to load N-Quads files (Layer 2) into an Oxigraph triplestore and query them using SPARQL to retrieve method complexity.

```bash
# Using Oxigraph
oxigraph load --file layer2-symbol-index.nq --location /tmp/ccg-db

# Query with SPARQL
oxigraph query --location /tmp/ccg-db --query "
  PREFIX narsil: <https://narsilmcp.com/ontology/v1#>
  SELECT ?fn ?complexity WHERE {
    ?fn a narsil:Method ;
        narsil:complexity ?complexity .
    FILTER(?complexity > 5)
  }
"
```

--------------------------------

### Global narsil-mcp Configuration for Claude Code

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/integrations/claude-code.md

Configures narsil-mcp as a server for Claude Code in the global settings. This setup indexes the current working directory when Claude Code starts. It requires Claude Code and narsil-mcp to be installed.

```json
{
  "mcpServers": {
    "narsil-mcp": {
      "command": "narsil-mcp",
      "args": [
        "--repos", ".",
        "--git",
        "--call-graph"
      ]
    }
  }
}
```

--------------------------------

### Rust Source Snippet Example

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/ccg-spec.md

This snippet provides an example of a source code snippet for a complex function in Rust. It's used to represent the starting point of analysis for specific functions, aiding in understanding their behavior and context.

```rust
pub fn complex_function(input: &str) -> Result<Output> {
    // ... source code ...
}
```

--------------------------------

### Manage Narsil MCP Configuration via CLI

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/configuration.md

Provides examples of Narsil MCP CLI commands for managing configuration. These commands allow users to view, validate, and initialize configuration files.

```bash
narsil-mcp config show

# Show as JSON
narsil-mcp config show --format json

# Show configuration for specific repo
narsil-mcp config show --repo ~/project
```

```bash
# Validate user config
narsil-mcp config validate ~/.config/narsil-mcp/config.yaml

# Validate project config
narsil-mcp config validate .narsil.yaml

# Validate and show errors
narsil-mcp config validate my-config.yaml --verbose
```

```bash
# Interactive wizard
narsil-mcp config init

# Initialize with a specific preset
narsil-mcp config init --preset balanced

# Create project config
narsil-mcp config init --project

# Create user config
narsil-mcp config init --user
```

--------------------------------

### Enable debug logging for narsil-mcp

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/getting-started.md

Enable detailed debug logging for narsil-mcp by setting the `RUST_LOG` environment variable to `debug` before running the command. This is useful for diagnosing tool call failures.

```bash
RUST_LOG=debug narsil-mcp --repos /path/to/project
```

--------------------------------

### Apply Full Narsil-MCP Configuration

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/configs/README.md

This command copies the full configuration file to the user's Narsil-MCP configuration directory, enabling comprehensive code intelligence for deep analysis with all available tools.

```bash
cp examples/configs/full.yaml ~/.config/narsil-mcp/config.yaml
```

--------------------------------

### Configure VS Code Copilot for narsil-mcp

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/getting-started.md

Integrate narsil-mcp with VS Code Copilot by creating a `.vscode/mcp.json` file in your workspace. This enables Copilot to utilize narsil-mcp for code intelligence features.

```json
{
  "servers": {
    "narsil-mcp": {
      "command": "narsil-mcp",
      "args": ["--repos", "${workspaceFolder}", "--git", "--call-graph"]
    }
  }
}
```

--------------------------------

### Run Narsil-MCP with All Flags for Complete Analysis

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/configs/README.md

This command runs Narsil-MCP with all available flags, including --neural and --remote, to leverage the full feature set for comprehensive code intelligence and deep analysis.

```bash
narsil-mcp --repos ~/project --git --call-graph --neural --remote
```

--------------------------------

### Export and Query CCG with narsil-mcp

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/ccg/README.md

Illustrates how to use the `narsil-mcp` tool to export a Code Context Graph for a repository and query it using SPARQL for vulnerability information.

```bash
# Export CCG for a repository
narsil-mcp --repos ./myproject --graph export_ccg

# Query the CCG with SPARQL
narsil-mcp query_ccg --query "
  SELECT ?finding ?severity WHERE {
    ?finding a narsil:Vulnerability ;
             narsil:severity ?severity .
    FILTER(?severity = 'HIGH')
  }
"
```

--------------------------------

### Pretty Print JSON-LD Layers with jq

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/ccg/README.md

Demonstrates how to use the `jq` command-line tool to pretty-print JSON-LD files, specifically for Layer 0 and Layer 1 of the CCG.

```bash
# Pretty print Layer 0
cat layer0-manifest.json | jq .

# Pretty print Layer 1
cat layer1-architecture.json | jq .
```

--------------------------------

### Setup Narsil-MCP for Ralph Automation

Source: https://github.com/postrv/narsil-mcp/blob/main/README.md

Installs narsil-mcp and demonstrates its usage with Ralph automation suite for enhanced code intelligence capabilities like security scanning and dependency analysis.

```bash
# Install narsil-mcp (Ralph auto-detects it)
cargo install narsil-mcp

# Ralph's quality gates use these tools:
narsil-mcp scan_security --repo <name>
narsil-mcp check_type_errors --repo <name> --path src
narsil-mcp find_injection_vulnerabilities --repo <name>
```

--------------------------------

### Run Narsil-MCP with Flags for Full Features

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/configs/README.md

This command executes Narsil-MCP with specific flags to enable Git integration and call graph analysis, utilizing the balanced configuration for enhanced daily development capabilities.

```bash
narsil-mcp --repos ~/project --git --call-graph
```

--------------------------------

### Troubleshoot 'Repository not indexed' errors

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/getting-started.md

Address 'Repository not indexed' issues by confirming the specified repository path is valid and contains code. Check file permissions and attempt explicit re-indexing using the `--reindex` flag.

```bash
narsil-mcp --repos /path/to/project --reindex
```

--------------------------------

### Full narsil-mcp Configuration Example (JSON)

Source: https://github.com/postrv/narsil-mcp/blob/main/configs/README.md

A comprehensive JSON configuration for narsil-mcp, specifying the command, arguments like repository path, git integration, call graph analysis, persistence, watch mode, and streaming. It also includes environment variables for logging and API keys.

```json
{
  "mcpServers": {
    "narsil-mcp": {
      "command": "narsil-mcp",
      "args": [
        "--repos", "${workspaceFolder}",
        "--git",
        "--call-graph",
        "--persist",
        "--watch",
        "--streaming"
      ],
      "env": {
        "RUST_LOG": "warn",
        "VOYAGE_API_KEY": "your-key-here"
      }
    }
  }
}
```

--------------------------------

### Configure ESLint with React and React DOM Plugins

Source: https://github.com/postrv/narsil-mcp/blob/main/frontend/README.md

This JavaScript code configures ESLint to include recommended lint rules for React and React DOM using external plugins. It assumes 'eslint-plugin-react-x' and 'eslint-plugin-react-dom' are installed.

```javascript
// eslint.config.js
import reactX from 'eslint-plugin-react-x'
import reactDom from 'eslint-plugin-react-dom'

export default defineConfig([
  globalIgnores(['dist']),
  {
    files: ['**/*.{ts,tsx}']
    extends: [
      // Other configs...
      // Enable lint rules for React
      reactX.configs['recommended-typescript'],
      // Enable lint rules for React DOM
      reactDom.configs.recommended,
    ],
    languageOptions: {
      parserOptions: {
        project: ['./tsconfig.node.json', './tsconfig.app.json'],
        tsconfigRootDir: import.meta.dirname
      },
      // other options...
    },
  },
])
```

--------------------------------

### HTTP API Graph Endpoint Example (HTTP)

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/frontend.md

Demonstrates the GET request format for retrieving graph visualization data from the narsil-mcp HTTP API. It includes parameters for specifying the repository, view type, traversal depth, and an optional focus function.

```http
GET /graph?repo=myrepo&view=call&depth=3&function=main
```

--------------------------------

### Troubleshooting Build Errors: macOS and Ubuntu/Debian

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/wasm.md

Provides commands to resolve build errors related to missing C compilers or tree-sitter during WASM builds on macOS and Ubuntu/Debian systems. It guides users through installing necessary tools like xcode-select, emscripten, and build-essential.

```bash
# macOS
xcode-select --install
brew install emscripten

# Ubuntu/Debian
sudo apt install build-essential emscripten
```

--------------------------------

### Install narsil-mcp via npm

Source: https://github.com/postrv/narsil-mcp/blob/main/npm/README.md

Installs the narsil-mcp package globally using npm. This is the standard installation method for Node.js users.

```bash
npm install -g narsil-mcp
```

--------------------------------

### Troubleshooting Slow narsil-mcp Startup

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/playbooks/integrations/claude-code.md

Addresses slow startup times for narsil-mcp by recommending the use of persistence. Enabling the `--persist` flag and specifying an `--index-path` allows narsil-mcp to cache its index, significantly speeding up subsequent launches.

```json
"args": ["--repos", ".", "--persist", "--index-path", ".claude/cache"]
```

--------------------------------

### Configure Narsil MCP with Environment Variables

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/configuration.md

Shows how to use environment variables like NARSIL_CONFIG_PATH, NARSIL_ENABLED_CATEGORIES, and NARSIL_DISABLED_TOOLS to customize Narsil MCP behavior. These variables offer fine-grained control over configuration and tool selection.

```bash
export NARSIL_CONFIG_PATH=/path/to/my-config.yaml
narsil-mcp --repos ~/project
```

```bash
# Enable only Repository, Symbols, and Search categories
export NARSIL_ENABLED_CATEGORIES=Repository,Symbols,Search
narsil-mcp --repos ~/project
```

```bash
# Disable slow tools
export NARSIL_DISABLED_TOOLS=neural_search,generate_sbom,find_semantic_clones
narsil-mcp --repos ~/project
```

```bash
# Apply balanced preset but disable slow tools
export NARSIL_PRESET=balanced
export NARSIL_DISABLED_TOOLS=neural_search,generate_sbom

# Enable only core categories
export NARSIL_ENABLED_CATEGORIES=Repository,Symbols,Search,Git

narsil-mcp --repos ~/project --git
```

--------------------------------

### Install Narsil Plugin via Marketplace

Source: https://github.com/postrv/narsil-mcp/blob/main/narsil-plugin/README.md

Installs the Narsil plugin for Claude Code from the previously added marketplace. This command fetches and installs the latest version of the plugin.

```shell
/plugin install narsil@narsil-mcp
```

--------------------------------

### Basic Usage of CodeIntelClient (JavaScript/TypeScript)

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/wasm.md

Demonstrates the fundamental usage of the `CodeIntelClient` in JavaScript or TypeScript. It shows how to initialize the client, index files, find symbols, search code, and retrieve statistics.

```typescript
import { CodeIntelClient } from '@narsil-mcp/wasm';

// Create and initialize the client
const client = new CodeIntelClient();
await client.init();

// Index files
client.indexFile('src/main.rs', rustSourceCode);
client.indexFile('src/lib.py', pythonSourceCode);

// Find symbols
const symbols = client.findSymbols('Handler');
const classes = client.findSymbols(null, 'class');

// Search code
const results = client.search('error handling');

// Find similar code
const similar = client.findSimilar('fn process_request(req: Request) -> Response');

// Get statistics
console.log(client.stats()); // { files: 2, symbols: 15, embeddings: 12 }
```

--------------------------------

### Install narsil-mcp via Homebrew

Source: https://github.com/postrv/narsil-mcp/blob/main/npm/README.md

Installs narsil-mcp on macOS using the Homebrew package manager. This adds the narsil-mcp formula to the user's Homebrew installation.

```bash
brew install postrv/tap/narsil-mcp
```

--------------------------------

### Install narsil-mcp via Homebrew (macOS/Linux)

Source: https://github.com/postrv/narsil-mcp/blob/main/README.md

Installs the narsil-mcp package using the Homebrew package manager on macOS and Linux systems. This is a recommended method for easy installation and updates.

```bash
brew tap postrv/narsil
brew install narsil-mcp
```

--------------------------------

### Basic CLI Usage for Indexing

Source: https://github.com/postrv/narsil-mcp/blob/main/npm/README.md

Command-line interface usage for narsil-mcp. This example demonstrates how to index the current directory with Git and call graph analysis enabled.

```bash
narsil-mcp --repos . --git --call-graph
```

--------------------------------

### Create Project-Specific Narsil-MCP Configuration

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/configs/README.md

This bash command creates a `.narsil.yaml` file in the repository root, allowing for project-specific Narsil-MCP settings that override user configurations.

```bash
cd ~/my-project
cat > .narsil.yaml <<EOF
version: "1.0"
tools:
  categories:
    Security:
      enabled: true  # Always enable security scanning for this project
  overrides:
    generate_sbom:
      enabled: true  # This project requires SBOM generation
EOF
```

--------------------------------

### Install narsil-mcp via Package Managers

Source: https://context7.com/postrv/narsil-mcp/llms.txt

Provides commands to install the narsil-mcp tool using various package managers like Homebrew, npm, and Cargo, as well as a one-line installation script.

```bash
# Homebrew (macOS/Linux)
brew tap postrv/narsil
brew install narsil-mcp

# npm (all platforms)
npm install -g narsil-mcp

# Cargo (Rust)
cargo install narsil-mcp

# One-line install script
curl -fsSL https://raw.githubusercontent.com/postrv/narsil-mcp/main/install.sh | bash
```

--------------------------------

### CLI Usage for Enabling All Features

Source: https://github.com/postrv/narsil-mcp/blob/main/npm/README.md

Command-line interface usage for narsil-mcp. This example demonstrates enabling all available features, including persistence and watching for changes.

```bash
narsil-mcp --repos . --git --call-graph --persist --watch
```

--------------------------------

### Install Claude Code Plugin for Narsil-MCP

Source: https://github.com/postrv/narsil-mcp/blob/main/README.md

Installs the narsil-mcp plugin for Claude Code, enabling slash commands and skills for effective tool usage. Installation can be done via the marketplace or directly from GitHub.

```shell
/plugin marketplace add postrv/narsil-mcp
/plugin install narsil@narsil-mcp
```

```shell
/plugin install github:postrv/narsil-mcp/narsil-plugin
```

--------------------------------

### Project-Specific Narsil-MCP Configuration (YAML)

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/configuration.md

This example shows a project-specific configuration file (`.narsil.yaml`) that overrides user-level settings. It enforces security scanning and SBOM generation for compliance, with specific configurations for license checking.

```yaml
# ~/my-project/.narsil.yaml
version: "1.0"

tools:
  categories:
    # Always enable security scanning for this project
    Security:
      enabled: true

    # This project requires SBOM
    SupplyChain:
      enabled: true

  overrides:
    generate_sbom:
      enabled: true
      reason: "Required for compliance"
      config:
        format: "spdx"

    check_licenses:
      enabled: true
      config:
        project_license: "MIT"
        fail_on_copyleft: true

performance:
  max_tool_count: 60
```

--------------------------------

### Install narsil-mcp via Cargo (Rust/npm)

Source: https://github.com/postrv/narsil-mcp/blob/main/README.md

Installs the narsil-mcp package using the Cargo build system and package manager for Rust projects, available on all platforms. Also shows installation via npm for Node.js environments.

```bash
cargo install narsil-mcp

npm install -g narsil-mcp
```

--------------------------------

### List and Search Tools

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/configuration.md

Lists available tools, optionally filtering by category or searching by keyword. The 'narsil-mcp tools list' command shows all tools, while 'narsil-mcp tools search "<query>"' finds specific tools. 'narsil-mcp tools show <tool_name>' displays detailed information about a tool.

```bash
# List all tools
narsil-mcp tools list

# List tools in a category
narsil-mcp tools list --category Search

# Search for tools
narsil-mcp tools search "git"

# Show tool details
narsil-mcp tools show get_blame
```

--------------------------------

### Install narsil-mcp WebAssembly Package

Source: https://context7.com/postrv/narsil-mcp/llms.txt

Install the narsil-mcp WebAssembly package using npm for browser-based code analysis.

```bash
npm install @narsil-mcp/wasm
```

--------------------------------

### Run Narsil-MCP with Git Flag for Security Tracking

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/configs/README.md

This command executes Narsil-MCP with the --git flag, enabling Git integration for tracking vulnerability history, specifically when using the security-focused configuration.

```bash
narsil-mcp --repos ~/project --git
```

--------------------------------

### Install narsil-mcp via Cargo

Source: https://github.com/postrv/narsil-mcp/blob/main/npm/README.md

Installs narsil-mcp by building it from source using the Cargo package manager. This requires a Rust development environment.

```bash
cargo install narsil-mcp
```

--------------------------------

### Install narsil-mcp WASM Package

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/wasm.md

Installs the narsil-mcp WebAssembly package using either npm or yarn, making it available for use in your JavaScript or TypeScript projects.

```bash
npm install @narsil-mcp/wasm
# or
yarn add @narsil-mcp/wasm
```

--------------------------------

### Apply Security-Focused Narsil-MCP Configuration

Source: https://github.com/postrv/narsil-mcp/blob/main/examples/configs/README.md

This command copies the security-focused configuration file to the user's Narsil-MCP configuration directory, optimizing for security auditing and supply chain analysis.

```bash
cp examples/configs/security-focused.yaml ~/.config/narsil-mcp/config.yaml
```

--------------------------------

### Install Rust WASM Target and wasm-pack

Source: https://github.com/postrv/narsil-mcp/blob/main/docs/wasm.md

Installs the necessary Rust target for WebAssembly compilation and the wasm-pack tool for building and publishing Rust-generated WebAssembly packages.

```bash
rustup target add wasm32-unknown-unknown
cargo install wasm-pack
```