Installation

Before starting, create a Docent account, install uv, and install either Claude Code or Codex.

Automated (recommended)
Manual

Open your project directory. Replace your-project with its path.

cd your-project

Run setup.

uvx docent@latest setup

This installs or updates the SDK and agent plugin, then helps you save and validate a Docent API key.

If this is not already a Python project, setup explains what it will create and asks before running uv init.

When setup finishes, restart Claude Code or start a new Codex session.

Install the Docent SDK

Go to your project directory, replacing your-project with its path:

cd your-project

Then initialize Python project metadata when needed and add Docent:

[ -f pyproject.toml ] || uv init --bare
uv add docent

If Docent is already declared in the project, update it within the project’s existing version constraint:

uv sync --upgrade-package docent

Install the coding-agent plugin

Claude Code
Codex
Other IDEs

claude plugin marketplace add TransluceAI/claude-code-plugins
claude plugin install docent@transluce-plugins

To update an existing installation:

claude plugin marketplace update transluce-plugins
claude plugin update docent@transluce-plugins

Restart Claude Code after installation or update.

codex plugin marketplace add TransluceAI/codex-plugins
codex plugin add docent@transluce-plugins

To update an existing installation, refresh the marketplace. Codex refreshes installed plugins from the new snapshot automatically:

codex plugin marketplace upgrade transluce-plugins

Start a new Codex session afterward.

Create the global config

mkdir -p ~/.docent
cat <<'EOF' > ~/.docent/docent.env
DOCENT_API_KEY=<YOUR_API_KEY>
DOCENT_DOMAIN=docent.transluce.org
EOF
chmod 600 ~/.docent/docent.env

Project-level docent.env files remain available when a repository needs to override the global configuration.

After setup, run your first analysis.

Get Started

Analysis Plans

Ingestion

Data Models

Guides

Legacy

Support