Nuanced CLI

The Nuanced CLI provides commands for startin the MCP server, indexing code, and inspecting the code graph directory in the terminal.

Usage

Quick start

# Index a package
cd my_repo/my_package
nuanced index .

# Get context for a specific function
nuanced analyze-function src/utils/helpers.ts myFunction

MCP commands

mcp

command

Start the MCP server in a directory.

Show arguments

Code graph commands

The CLI provides several commands to analyze and navigate code relationships.

index

command

Index the code in a directory.

Show arguments

directory

path

Path to the root of the project directory to index. If omitted, searches for an already indexed project directory in the current or a parent directory.

--timeout-seconds

number

Set a time limit on the allowed index time.

-f --force

Force a re-index even if no files changed after the last index.

status

command

Show the status of the index.

Show arguments

--include-unchanged

Show individual files that were unchanged since the last index. Useful for understanding which files in the project are indexed.

find-function

command

Find functions with a given name in the project.Returns a list of file paths containing the function in JSON format.

Show arguments

name

string

required

Name of the function to find.

scope

path

Path to a file or directory to limit the search to. If omitted, searches in the whole project.

analyze-function

command

Analyze a function with a given name in the project.Returns code graph information about the function in JSON format.

Show arguments

function-name

string

required

Name of the function to find.

file-scope

path

Path to a file or directory the function is located. If omitted, searches in the whole project. Fails if multiple functions are found within the given scope.

Show example

# Assuming you ran 'nuanced index .'
$ nuanced analyze-function authenticate src/middleware/auth.middleware.ts

# Example output
{
  "typescript-project:src/middleware/auth.middleware.ts:8:8:authenticate": {
    "filepath": "src/middleware/auth.middleware.ts",
    "start": "8:8",
    "end": "39:1",
    "callees": [
      "typescript-project:src/services/auth.service.ts:100:3:getUserById",
      "typescript-project:src/services/auth.service.ts:91:3:validateToken"
    ]
  }
}

License commands

activate

command

Activate Nuanced with a license key,

Show arguments

key

string

The license key to use for activation. If omitted, will ask for the key interactively.

Graph Schema

Node Types

Each node in the graph represents a module or function. Nodes are uniquely identified by fully qualified names.

Node Attributes

Function nodes in the graph returned by the nuanced analyze-function command have the following attributes:

Name	Description	Empty if
`callees`	A list of fully qualified function names uniquely identifying functions that are invoked by the function	Function has no callees
`filepath`	The relative path to the file where the function is defined	N/A
`start`	The starting line:column position of the function definition	N/A
`end`	The ending line:column position of the function definition	N/A

Architecture

Nuanced Typescript code graph builds upon Jelly’s core call graph generation, extending it with a specialized focus on AI tooling integration. In jellycg, our fork of Jelly, we export the functions that allow us to run the analysis and interact with the results to form the Nuanced code graph. We chose Jelly because it provides:

Accurate resolution of function definitions and calls across files
Full understanding of TypeScript syntax and type annotations
Reliable handling of imports, exports, and module boundaries
Support for modern JavaScript/TypeScript features

We’ve developed a layer on top that standardizes function identification and provides a consistent API for AI consumption. Our wrapper adds structured error handling and simplified querying capabilities that make it practical for real-world AI tooling scenarios.

Getting Started

Nuanced MCP Server

Nuanced LSP Container

Usage

Quick start

MCP commands

Code graph commands

License commands

Graph Schema

Node Types

Node Attributes

Architecture

Getting Started

Nuanced MCP Server

Nuanced LSP Container

​Usage

​Quick start

​MCP commands

​Code graph commands

​License commands

​Graph Schema

​Node Types

​Node Attributes

​Architecture

Usage

Quick start

MCP commands

Code graph commands

License commands

Graph Schema

Node Types

Node Attributes

Architecture