# Config

Optional. A project needs none.

```ts
// praecise.config.ts
import { defineConfig } from "@praecise/harness";

export default defineConfig({
  name: "Acme Support",
  quality: "balanced",
  port: 3000,
});
```

Every field is optional:

| | |
|---|---|
| `name`, `version`, `description` | What the app is called (the folder's name by default), the version it publishes itself as (`0.1.0` by default), and one line on what it is for. |
| `quality` | The default for every agent that does not set its own. |
| `preference` | `"cost"`, `"balanced"` (the default) or `"quality"`: what to favour when cost and quality pull apart. Under `"quality"` the ladder is not climbed: the strongest rung answers at full depth and nothing is checked. |
| `explore` | The share of routing decisions sent somewhere the estimate would not have sent them, so the routing record can be read back. Off by default; `EXPLORATION` (2%) is the value to use, and anything above 5% is clamped. Ignored under `preference: "cost"` and `"quality"`. |
| `port` | The dev server's port. 3000 by default. |
| `models` | The endpoints, in the order they are preferred (see [Install](#install)). |
| `limits` | `depth`, `concurrency` (4 steps at once), `timeout` (600 seconds a step), `budget` (tokens a run may spend), `calls`, `spend`, `retries` and `retryDelay`. |
| `store` | The store an agent remembers into when it asks for one without naming it. |
| `stateDir` | Where runs, conversations, memory, recordings and the rest of the app's state are kept. `.praecise` by default. |
| `strict` | Refuse where the framework would otherwise be friendly. An app with no model endpoint answers with a placeholder so that a new folder does something; with `strict: true`, or `PRAECISE_STRICT` set in the environment where the config says nothing, it refuses. An app whose configured endpoints cannot be reached refuses either way. |
| `record` | Keep each exchange for [`praecise capture`](#cases-from-what-really-happened). |
| `registries` | The indexes [`praecise search` and `praecise add`](#skills-and-plugins-from-a-registry) read. |
| `plugins` | [Plugins](#plugins). |
| `ask` | What `/ask` may spend and where it reads: `quality`, `mode` (`list`, `summarize`, `generate`), `agent`, `limit`, `store`, `type`. Left out, `/ask` retrieves and ranks without reaching a model. |
| `ingest` | How files become text for `praecise ingest`: `using` is `native`, `model`, `mcp` or `cloud`, beside the `url` and `credential` of the service that does it. |
| `selves` | Where [selves](#an-agent-that-remembers-who-it-is) live. |
