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

# Runnable examples

> Clone, run, and test the reference Praxa HTTP, memory-federation, and MCP examples used by this documentation.

The public docs repository includes a dependency-pinned examples workspace.
Its tests use local fakes, so you can verify request construction and package
behavior before creating a credential.

## Run the examples

```bash theme={null}
git clone https://github.com/praxa-labs/praxa-docs.git
cd praxa-docs
npm ci
npm run examples:test
```

The suite verifies:

* exact <code>@praxa/sdk</code> mission request, path, and idempotency behavior;
* stable Execution Fabric idempotency and terminal polling;
* exact <code>@praxa/sdk/memory</code> import and partial-source behavior;
* exact <code>@praxa/mcp-contracts</code> protocol, version, annotation, and
  12-tool surface; and
* exact <code>@praxa/cli</code> release constants plus write-free memory
  planning.

## Example inventory

<CardGroup cols={2}>
  <Card title="TypeScript SDK quickstart" icon="code" href="https://github.com/praxa-labs/praxa-docs/tree/main/examples/sdk">
    Run the same fake-transport contract test used by the SDK quickstart before
    connecting a deployment-specific Gateway.
  </Card>

  <Card title="Durable task client" icon="play" href="https://github.com/praxa-labs/praxa-docs/tree/main/examples/execution-fabric">
    Submit and poll a v1 task with stable idempotency and injectable transport
    tests.
  </Card>

  <Card title="Custom memory source" icon="database" href="https://github.com/praxa-labs/praxa-docs/tree/main/examples/memory-federation">
    Verify provenance-rich recall and explicit partial degradation.
  </Card>

  <Card title="MCP contract smoke" icon="plug" href="https://github.com/praxa-labs/praxa-docs/tree/main/examples/mcp">
    Inspect exact protocol versions, server identity, annotations, and wire
    names.
  </Card>

  <Card title="CLI contract smoke" icon="terminal" href="https://github.com/praxa-labs/praxa-docs/tree/main/examples/cli">
    Verify release constants and confirm memory planning remains local and
    write-free.
  </Card>

  <Card title="Framework tutorials" icon="code" href="/tutorials/overview">
    Add the same trust boundary to TypeScript, Next.js, Nuxt, Express,
    Workers, Python, FastAPI, Rust, Go, Spring, .NET, mobile, or agent hosts.
  </Card>
</CardGroup>

## Run a live task

After local tests pass, create a disposable personal key with
<code>execute:write</code> and <code>runs:read</code>:

```bash theme={null}
export PRAXA_API_KEY="praxa_sk_<redacted>"
node examples/execution-fabric/durable-task.mjs \
  "Summarize this incident and propose a safe next action."
```

The script prints the admitted run and polls to terminal. A live task can
consume quota; revoke the disposable key after cleanup.

<Note>
  Local tests prove package and client behavior. The live command proves only
  the tenant, scope, deployment, and task path you actually exercise.
</Note>