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

# Qredence Plugins quickstart

> Set up the Qredence Plugins repository with uv and gh, then install and run your first plugin from the marketplace inside Claude Code or OpenAI Codex.

## Prerequisites

* Python 3.11+
* [`uv`](https://docs.astral.sh/uv/)
* [GitHub CLI](https://cli.github.com/) (`gh`) for remote install
* Claude Code or OpenAI Codex

## Set up the repository

```bash theme={null}
git clone https://github.com/Qredence/qredence-plugins.git
cd qredence-plugins
uv sync --frozen --dev
```

If a plugin depends on external services, copy `.env.example` to `.env` and add the required keys.

## Install from GitHub

Install a skill across all supported agents:

```bash theme={null}
gh skill install Qredence/qredence-plugins harness-engineering
```

Install for a specific agent:

```bash theme={null}
gh skill install Qredence/qredence-plugins harness-engineering --agent claude-code
gh skill install Qredence/qredence-plugins harness-engineering --agent codex
```

Browse available skills:

```bash theme={null}
gh skill search Qredence/qredence-plugins
```

Installable skill names: `harness-engineering`, `meta-harness`, `rlm-wiki`, `symphony`, `development`, `legal`, `autoresearch-dspy`.

## Local testing

For local development or session-only testing, point Claude Code at a checkout directly:

```bash theme={null}
claude --plugin-dir ./plugins/<plugin-name>
```

Then invoke the skill, for example:

```text theme={null}
/meta-harness:meta-harness
```

## Run a plugin from Codex

When Codex creates a new worktree, `.codex/environments/environment.toml` bootstraps dependencies with:

```bash theme={null}
uv sync --frozen --dev
```

Put environment variables (`TAVILY_API_KEY`, `LINEAR_API_KEY`, etc.) in Codex settings — setup runs in a separate shell session, so exports won't persist.

## Verify the repo

```bash theme={null}
# All tests
uv run pytest

# Marketplace and manifest wiring
uv run pytest tests/test_plugin_catalogue.py

# Per-plugin validation
uv run pytest plugins/harness-engineering/tests
uv run pytest plugins/meta-harness/tests
uv run pytest plugins/rlm-wiki/tests
uv run pytest plugins/symphony/tests
```

## Next steps

<CardGroup cols={2}>
  <Card title="Claude usage" icon="anthropic" href="/qredence-plugins/claude">
    Marketplace, install commands, and packaging notes for Claude Code.
  </Card>

  <Card title="Codex usage" icon="openai" href="/qredence-plugins/codex">
    Marketplace registration, setup script, and packaging notes for Codex.
  </Card>

  <Card title="Authoring a plugin" icon="pen-to-square" href="/qredence-plugins/authoring">
    Folder layout, manifests, and the marketplace checklist.
  </Card>

  <Card title="Browse plugins" icon="cubes" href="/qredence-plugins/plugins/harness-engineering">
    Per-plugin guides and validation commands.
  </Card>
</CardGroup>