Skip to content

CLI Overview ​

The nekosearch executable prepares your documentation catalog and starts its MCP server. Snapshot management and client configuration are explicit commands; serving is local and read-only.

sh
nekosearch --help

Command families ​

TaskCommands
Interactive onboarding and client selectionsetup
Build without installingbuild
Install documentationadd --dir, add --github, add --from, add nestjs@11, add nestjs@12
Inspect the cataloglist, status
Refresh curated documentationupdate nestjs@11, update nestjs@12
Remove an installed snapshotremove
Configure or remove Grok Build registrationmcp configure grok-build, mcp remove grok-build
Start the MCP stdio processserve

There are no CLI search or fetch subcommands. Agents use the MCP tools to retrieve documentation.

Source selectors ​

Commands address sources using source@version, for example nestjs@12 or my-api@1. Use list to inspect installed selectors. MCP clients discover the selectors loaded into their session with list_docs.

Adding an existing selector fails rather than overwriting it. Only the curated NestJS integration has a public update command. See Updating & Removing for custom replacements.

Network access ​

CommandUses network
build, list, remove, add --dir, add --fromNo
statusNo, unless --check-upstream explicitly requests checks
serve, mcp configure grok-build, mcp remove grok-buildNo NekoSearch documentation download; provider commands delegate to Grok CLI
setupOnly for selected curated documentation downloads
add --github, curated add and updateYes, HTTPS to GitHub

The server does not expose HTTP or SSE transport. Your MCP client starts a child process and communicates with it over stdin/stdout. Logs go to stderr.

Exit and output behavior ​

Successful commands generally exit 0. Operational failures exit 1. Unknown command forms and invalid status or GitHub-add arguments exit 2; setup also exits 2 in a non-interactive terminal. Setup cancellation exits 130.

list and status write readable state to stdout. build writes its summary and diagnostics to stderr. serve reserves stdout for MCP protocol traffic. There is no general-purpose CLI --json output option.

Use the Command Reference for accepted command forms, options, and errors.

Local documentation. Explicit sources. Better context.