Skip to content

Settings reference

Settings has nine sections. Several of them exist to tell you what WeftKit will not do — controls that are unavailable in a build say so plainly rather than appearing as toggles that quietly do nothing.

General

Appearance, first-run setup, and workspace defaults. The theme follows the operating system unless you choose Dark or Light explicitly. Capture defaults — the default browser and the capture profile (Economy, Standard, or High Fidelity) — seed new projects, which can override them individually. First-run setup can be reopened at any time.

WeftKit General settings showing theme options System, Dark and Light, a reduced-motion row marked Unavailable, default browser and capture profile selectors, and an Open setup button.
General. The reduced-motion row is marked Unavailable rather than shown as a dead toggle.

Browsers

Discovered installations and their declared compatibility contracts. Discovery never implies a certified live adapter: an installed browser is listed with its channel and executable path, and separately with what its adapter can and cannot do — browser control, DOM and accessibility snapshots, network metadata, action screenshots, native window video, and AI repair. You can re-run discovery or probe a specific executable.

WeftKit Browsers settings listing Google Chrome with a Setup required badge and a capability contract table, followed by Mozilla Firefox marked Unavailable.
Capability contracts are stated per browser, including the capabilities that are absent.
Chrome, Edge, Brave, and Chromium use the probed Chromium adapter. Firefox and Safari are inventoried honestly but remain unavailable until dedicated adapters pass their own compatibility suites.

AI providers

The active provider, per-provider credentials and endpoints, and hard budgets. Runs use the active provider unless the run preflight overrides it, and deterministic replay never needs one at all. API keys are write-only: they go to the OS credential vault and are never shown again.

WeftKit AI provider settings showing an active-provider selector listing eleven providers, a fallback readiness badge, and an API key field described as write-only.
Eleven providers in one list — API, local runtime, and CLI agent alike.

Saving a key validates its shape only. Access is verified by the first bounded provider response, and the app says so instead of claiming a connection it has not made.

Models

The model price registry: bundled list prices plus your own overrides, in USD per million tokens. Rates are copied into each transaction at request time, so history never reprices itself when you change a rate later. Any model without a bundled or custom rate is priced at the WeftKit default fallback rate and included in totals with a Fallback badge — never shown as free.

The WeftKit model price registry listing models per provider with input, output and cached rates, source badges, and per-row actions.
Every row states where its rate came from: bundled default, your custom override, or the fallback.

Costs

Display currency and the FX source behind it. USD is the immutable ledger base; any other currency is a view-time conversion, and WeftKit refuses to guess a rate — you record the rate and its provenance before a converted total will be shown.

WeftKit cost settings showing the display currency selector and the required exchange-rate provenance fields.
A converted total is only ever as trustworthy as its rate, so the rate’s provenance is required.

Privacy

The default privacy profile for new projects, and the controls that cannot be weakened. Strict is designed for routine testing; Diagnostic still enforces sensitive-field controls. Network response bodies have no global toggle — native capture defaults to metadata only. Sensitive screenshots must be masked before they persist. Global input monitoring is not used: WeftKit observes only its launched browser session.

WeftKit privacy settings showing the default profile selector and rows stating Metadata only, Mask required, and Not used.
Privacy is enforced at collection boundaries; UI toggles cannot weaken these controls.

Storage

Local artifact storage and retention. Reports, screenshots, journals, and replay output stay on the device; the panel shows volume usage, the artifact root (read-only, managed by the desktop core), the default retention window that new projects inherit, and a planning estimate for Standard capture per hour.

WeftKit storage settings showing volume usage, a read-only artifact root, retention selector, an hourly capture estimate, and a warning that artifact encryption is not active.
Storage states its own gap: artifact encryption is not active in this build.
LimitationWorker artifacts are local plaintext files. Use test accounts and synthetic data until an encrypted artifact store reports itself available.

Safety

Authorization, domain boundaries, consequential actions, and human gates. Your authorized-use acknowledgement is recorded for the local installation, and each project’s top-level navigation allowlist is listed. Below them sit the hard rules, described in the app as product invariants rather than convenience preferences:

WeftKit hard safety rules
RuleWhat it means
No CAPTCHA bypassReplay pauses or stops. AI cannot solve or circumvent a challenge.
No stealth or evasionNo anti-detection, browser fingerprint spoofing, or bot-evasion behaviour.
Consequential actions require policyPayments, irreversible deletion, publication, and external messages need explicit handling.
Recorded assertions cannot be weakenedRepair proposals must validate against the immutable revision.
WeftKit safety settings showing the accepted authorized-use acknowledgement, project boundaries with an allowlisted domain, and the four hard safety rules.
Safety. The four rules are invariants; there is no setting that relaxes them.

Diagnostics

Desktop core, adapters, permissions, and honest capability coverage — the version, schema version, run mode, and which capabilities are reporting themselves as ready. This is the first place to look when a capability you expected is missing.

WeftKit diagnostics settings showing the app version, run mode, schema version, and capability status.
Diagnostics reports the running mode and schema so a support conversation starts from facts.