Installation

Prerequisites

From the root of the repo you want to index:

bash

npx @ctxo/init

This detects your languages, installs the right @ctxo/lang-* plugins, adds git hooks, and creates a starter .ctxo/config.yaml.

bash

npx ctxo doctor

All green? You are done.

If anything is red or yellow:

bash

npx ctxo doctor --fix

This runs a dependency-ordered remediation pass (missing plugins, stale cache, broken hooks). Add --dry-run first if you want to preview.

@ctxo/init auto-detects what your repo uses. To add more languages after the fact, install the plugin package directly:

pnpmnpmyarn

bash

pnpm add -D @ctxo/lang-typescript
# or: @ctxo/lang-go, @ctxo/lang-csharp

bash

npm install -D @ctxo/lang-typescript

bash

yarn add -D @ctxo/lang-typescript

After install, re-index so the plugin takes effect:

bash

npx ctxo index