# CARBON settings

Reusable private test context for local CARBON execution.

## Project activity & overrides

Global defaults are reusable. Select a project to see its actual command frequency and host telemetry, then optionally override only its browser controls and report detail. Secrets always remain global.

No project loaded yet.
Project report detail
Project browser controller
Global test execution context Apply one reusable login, prompt, and document set to CARBON tests across projects.
LOCAL · GLOBAL
Test username or email

Available to local CARBON test execution as `CARBON_TEST_USERNAME`. It is not copied into test definitions or reports.

Test password

Injected only into an approved child test runner as `CARBON_TEST_PASSWORD`. CARBON never returns the value to the coding agent, settings page, or reports.

Checking…
Global test prompt

CARBON adds this instruction to local generation and execution workflows without allowing it to weaken safety or evidence requirements.

Global context documents

Add up to 20 local documents, 10 MB each and 50 MB total. CARBON keeps locked local copies and exposes only their paths to the coding agent so the right local reader can load them. They are treated as untrusted reference data, never as instructions, and are not uploaded by local workflows. Keep passwords and API keys in the credential fields, not documents.

Execution and optional services Configure local execution, browser control, and optional model-assisted screenshot review.
Output detail

Verbose is the CARBON default. It explains meaningful progress, selected tests, evidence, findings, unknowns, skipped or blocked work, and prioritized next actions. Every mode keeps the generated HTML report complete.

Browser execution

Local mode uses the browser already installed in your coding agent. Premium mode sends only the scoped run to testers.ai when you invoke a testers-prefixed command.

Preferred local browser control

CARBON tries this first. Automatic stays inside the allowed list below and reports when no permitted controller can satisfy the test.

Allowed local browser controls

Choose every fallback CARBON may use. At least one is required. The current Chrome session is intentionally off by default.

Coding-agent isolated browser A separate local test context supplied by Codex, Claude, Cursor, or another host. RECOMMENDED Vibium / WebDriver BiDi Use CARBON's local Vibium compatibility and native CLI adapter when installed. LOCAL Playwright / CDP Use a project or host Playwright bridge when it is available. LOCAL Selenium / WebDriver Use an existing compatible Selenium runner without replacing CARBON's test intent. LOCAL My current Chrome session May access logged-in tabs and live user state. Enable only when that state is necessary. SENSITIVE
External quality systems Read Jira/Xray and TestRail cases, results, and known issues into CARBON. Global connection defaults can be narrowed per project without storing secrets in the repository.

### Read first. Sync only after a reviewed preview.

Connecting grants read access only in normal CARBON workflows. External creates, updates, or result publications require a separate digest-protected preview, explicit approval of the exact scope, and confirmation that you export or back up the affected project first. CARBON does not support deletion.

Jira + Xray
Jira site URL
Jira account email
Default Jira project key
Default known-issue JQL
Jira API token

Create and revoke tokens in Atlassian account security ↗. Never paste a token into chat.

Checking…
Xray Cloud API URL
Xray client ID

Create an API key in Xray Global Settings → API Keys. Xray authentication docs ↗

Xray client secret
Checking…
Default Xray test JQL
TestRail
TestRail site URL
TestRail account email
TestRail API key

Enable the API and create a personal API key in TestRail's My Settings. TestRail API setup ↗

Checking…
Default project ID
Default suite ID
Default section ID for approved creates
Default run IDs for result reads

CARBON reads results only for these explicit run IDs, up to 10.

Suggest connecting external test or issue evidence when it could change confidence

When enabled, CARBON may recommend `/carbon_integrations` if Jira/Xray, TestRail, or another inaccessible system appears to be a meaningful evidence gap. It never connects automatically.

AI screenshot quick checks Optionally let AI Upgrade add sparse visual-review checkpoints to existing automation.
Model provider

Local means CARBON runs the test code on this machine. The selected screenshot and short review focus are still sent to this model provider when an inserted quick check runs.

Exact model name

CARBON does not guess a model name. Choose a current vision-capable model from your provider account so upgrades stay explicit and reproducible.

Model provider API key

The key is stored in macOS Keychain when available, with a locked local fallback. It is exposed to approved child test runners only through the provider's standard environment variable and is never written into test source.

Checking…
Do not use screenshots containing passwords, tokens, private customer data, payment details, health data, or other sensitive information unless transmission to the selected provider is explicitly authorized.
Email

Unlocks one passwordless targeted UX pass each UTC day and one two-page mixed-feature report each UTC week.

testers.ai Premium Cloud API key (required for premium features)

### Need a cloud API key?

Create an account or manage an existing one, then bring the generated key back to this protected local page.

1. 1 Create or sign in to your testers.ai accountNew accounts verify their work email before dashboard access.
2. 2 Open Account · change password · API keysSelect Generate CI API key, then copy the generated `jk_…` key.
3. 3 Paste it here and save settingsCARBON stores it in macOS Keychain when available, with a locked local fallback.

Create testers.ai account ↗ Open account & API keys ↗
Never paste an API key into chat, source code, a test case, or a context document. Add it only through this protected settings field.

Required for the managed browser, history, chatbot runs, saved tests, and paid cloud usage. Open the steering workspace.

Checking…
Optional service recommendations

When on, CARBON may show one relevant IcebergQA recommendation when the current result creates a real need. It shows no ad without a matching context, never shows more than one per report, waits at least 24 hours between promotions, and waits seven days before repeating the same offer.

Share anonymous CARBON usage events

Sends only allowlisted action names—such as Help, Browser Test, Test Run, and First Activation—to Fathom. CARBON never sends prompts, URLs, credentials, paths, test data, screenshots, logs, or report contents. Turn this off at any time.

Advanced connection
Cloud API URL

Keep the default unless your team uses a private testers.ai deployment.

This page is served only on your computer with a one-time session token. Test and model credentials go to macOS Keychain when available, with user-only file fallbacks. Raw secrets are never returned to the page, chat, reports, or plugin metadata. Context documents remain local.

Confirm settings change