Language-server-backed code navigation for Namzu agents.

Install · Usage · Documentation

Code navigation for an agent — definitions, references, symbols and diagnostics — served by a real language server rather than by grep. One server per language, routed by file extension, disposed with the run.

Install

pnpm add @namzu/sdk @namzu/lsp

@namzu/sdk is a peer dependency. Install both.

Usage

import { RoutingCodeNavigationProvider } from '@namzu/lsp'
import { getCodeNavigationTools, ToolRegistry } from '@namzu/sdk'

const rootDir = process.cwd()

const codeNavigation = new RoutingCodeNavigationProvider({
  routes: [
    { extensions: ['.ts', '.tsx'], server: { command: 'ts-server', args: ['--stdio'], rootDir } },
    { extensions: ['.py'], server: { command: 'py-server', rootDir } },
  ],
})

const registry = new ToolRegistry()
for (const tool of getCodeNavigationTools(codeNavigation)) registry.register(tool)

// …and when the run is over:
await codeNavigation.dispose()

Documentation

• Code navigation — routing, the four operations and containment
• Namzu docs

License

FSL-1.1-MIT, converting to MIT two years after each release.