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

# Experimental Features

Experimental features are opt-in and are provided without compatibility guarantees. They may break, change, or be removed at any time. Use them at your own risk.

## What "experimental" means

When a feature is marked experimental, Paperclip is still evaluating the product shape and implementation details.

* The feature is not part of the stable operator contract yet.
* UI, API, CLI, behavior, and stored configuration may change as the feature evolves.
* Paperclip does not promise compatibility, rollback, migration, or long-term support for experimental features.

If you need stable behavior for an important workflow, do not rely on an experimental feature.

## Where you enable them

Board operators enable or disable experiments from **Instance Settings > Experimental** in the app.

The CLI exposes the same surface:

```sh theme={null}
pnpm paperclipai instance settings:experimental
npx paperclipai instance settings:experimental:update --payload-json '{...}'
```

Those commands change the same opt-in settings that the UI manages.

## When to use them

Experimental features are best used when you are:

* evaluating a new capability before wider rollout
* testing a non-critical workflow
* comfortable with behavior changes between releases
* prepared to stop using the feature if it changes or disappears

## Operator expectations

Before enabling an experimental feature:

* decide whether the workflow can tolerate breakage or churn
* avoid making the feature a dependency for stable production processes
* keep the scope small until you understand how the feature behaves in your company
* watch release notes and docs for changes to the feature contract

## Related references

* See [Status Cards](/guides/board-operator/status-cards) for the watched-query summary experiment, refresh policies, and cost model.
* See the CLI caveat in [Control-Plane Commands](/cli/control-plane-commands).
* See the repo CLI reference in [`doc/CLI.md`](https://github.com/paperclipai/paperclip/blob/master/doc/CLI.md) when working from the repository.