Installation

import { Tabs, TabItem } from ‘@astrojs/starlight/components’;

codectx is built in Python and can be installed via pip, uv, or pipx.

Prerequisites

• Python 3.10+
• Git (if checking out repositories)

Installation Methods

We strongly recommend installing codectx universally via uv or pipx to keep its dependencies isolated from your project environments.

If you use `uv`, installing `codectx` takes seconds:

```bash
uv tool install codectx
```

For global isolated installation using `pipx`:

```bash
pipx install codectx
```

To install directly into an active virtual environment:

```bash
pip install codectx
```

Enabling Semantic Search

To use the --query functionality for semantic file ranking, you must install the [semantic] extra which includes dependencies like sentence-transformers and lancedb:

pip install codectx[semantic]

Verify Installation

Once installed, verify the CLI is accessible:

codectx --version

If it successfully prints the version, you are ready to use codectx. Head over to the Quick Start guide to begin analyzing your codebase.