> ## Documentation Index
> Fetch the complete documentation index at: https://docs.transluce.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Docent SDK and coding agent plugin

Before starting, [create a Docent account](https://docent.transluce.org/signup),
install [`uv`](https://docs.astral.sh/uv/getting-started/installation/), and install
either [Claude Code](https://claude.com/claude-code) or
[Codex](https://help.openai.com/en/articles/11096431).

<Tabs>
  <Tab title="Automated (recommended)">
    Open your project directory. Replace `your-project` with its path.

    ```shell theme={null}
    cd your-project
    ```

    Run setup.

    ```shell theme={null}
    uvx docent@latest setup
    ```

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

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

    When setup finishes, restart Claude Code or start a new Codex session.
  </Tab>

  <Tab title="Manual">
    <Steps>
      <Step title="Install the Docent SDK">
        Go to your project directory, replacing `your-project` with its path:

        ```shell theme={null}
        cd your-project
        ```

        Then initialize Python project metadata when needed and add Docent:

        ```shell theme={null}
        [ -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:

        ```shell theme={null}
        uv sync --upgrade-package docent
        ```
      </Step>

      <Step title="Install the coding-agent plugin">
        <Tabs>
          <Tab title="Claude Code">
            ```shell theme={null}
            claude plugin marketplace add TransluceAI/claude-code-plugins
            claude plugin install docent@transluce-plugins
            ```

            To update an existing installation:

            ```shell theme={null}
            claude plugin marketplace update transluce-plugins
            claude plugin update docent@transluce-plugins
            ```

            Restart Claude Code after installation or update.
          </Tab>

          <Tab title="Codex">
            ```shell theme={null}
            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:

            ```shell theme={null}
            codex plugin marketplace upgrade transluce-plugins
            ```

            Start a new Codex session afterward.
          </Tab>

          <Tab title="Other IDEs">
            Download the skill files directly and pass the file contents directly
            in your prompt context:

            * [Claude Code Docent SKILL.md](https://github.com/TransluceAI/claude-code-plugins/blob/main/plugins/docent/skills/docent/SKILL.md)
            * [Codex Docent SKILL.md](https://github.com/TransluceAI/codex-plugins/blob/main/plugins/docent/skills/docent/SKILL.md)
          </Tab>
        </Tabs>
      </Step>

      <Step title="Create the global config">
        ```shell theme={null}
        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.
      </Step>
    </Steps>
  </Tab>
</Tabs>

After setup, [run your first analysis](/analysis/quickstart).