Skip to content

Configuration Reference

Release status

RightNow Agent is coming soon for Windows, macOS and Linux. Installation commands and workflows in these guides are reference material until the public release is available.

Every documented key, its default, and how it resolves. Start with the Configuration guide for files and layers.

Precedence is field-specific: security requirements can outrank command-line and environment values, while model, project, and appearance settings use narrower rules shown below. Spend limits use microcents: 1 microcent = one millionth of a cent.

Files

  • config.toml is active configuration; requirements.toml and managed_config.toml add requirement and managed layers.
  • config/rightnow.toml is the source template; installer.toml records installer and update state.
  • pager.toml separately controls TUI appearance.

On Windows, all but the template live under the effective product home; macOS and Linux also read system copies of managed_config.toml and requirements.toml. Layer order and project scope are in Precedence and project scope.

config.toml keys

Grouped by TOML table; a note after a table name says where else it is read. File layers are the merged managed, user, and requirements files. Provider and model entries are on the Providers page; sandbox profiles are on the Sandbox page.

Core

KeyDefaultResolution
[cli]
auto_updateDefault: shipped false; off when unsetResolution: file layers; only an explicit true opts in
channelDefault: stableResolution: config.toml > RIGHTNOW_CHANNEL > installer.toml > stable
minimum_version / maximum_versionDefault: unset / unsetResolution: Tightest file or environment soft bound
required_minimum_version / required_maximum_versionDefault: unset / unsetResolution: Tightest requirements, file, or environment hard bound
[models]
defaultDefault: shipped: runinfraResolution: CLI -m > config.toml > catalog selection
web_searchDefault: built-in search modelResolution: CLI web-search override > environment > local config > remote > built-in
session_summary / image_description / prompt_suggestionDefault: config unset; runtime built-in / built-in / consumer defaultResolution: CLI or environment where supported > config.toml > remote > runtime default
extra_headers / temperature / top_p / max_completion_tokens / max_retries / inference_idle_timeout_secs / stream_tool_callsDefault: unset; inherit catalog or client behaviorResolution: model entry > remote or catalog values > models defaults
[agent]
name / definitionDefault: unset / unsetResolution: ACP session metadata > CLI > config.toml > environment > built-in agent
system_prompt_labelDefault: shipped: RightNowResolution: model entry > agent config > built-in label
[session]auto_compact_threshold_percent also per [model.<id>]
auto_compact_threshold_percentDefault: 85Resolution: environment > [model.<id>] > [session] > remote per-model > remote global > 85
load_envrcDefault: trueResolution: file layers > default
[rightnow]
config_version / warm_daemon / warm_daemon_persistent / one_call_transactions / preload_named_files / workspace_mapDefault: shipped: 6 / true / false / true / true / trueResolution: file layers > parser defaults
act_first / retry_recoverable_tool_failures / bounded_prompt_slimming / dynamic_tools / context_packing / eager_toolsDefault: shipped: false / true / true / true / unset / trueResolution: file layers > parser defaults
turn_model_call_limit / turn_time_budget_secs / turn_repeated_failure_limit / turn_spend_limit_microcentsDefault: shipped: 24 / 600 / 3 / 5000000; omitted: 12 / 30 / 2 / no capResolution: file layers > parser defaults
web_fetch / web_search_engine / disallowed_toolsDefault: shipped: true / duckduckgo / image and video toolsResolution: agent launches set startup defaults that outrank these keys
[features]
telemetry / feedback / lsp_toolsDefault: false / true / falseResolution: requirements > environment > config.toml > remote > built-in defaults
two_pass_compactionDefault: falseResolution: environment > config.toml > remote > built-in default
codebase_indexingDefault: trueResolution: file layers > default
remote_fetchDefault: built-in true; shipped falseResolution: requirements > managed configuration > user config.toml > built-in default; no environment or remote tier
turn_summaryDefault: built-in true; shipped falseResolution: environment > config.toml > remote > built-in default

Tools and safety

KeyDefaultResolution
[tools]
respect_gitignoreDefault: falseResolution: requirements > environment > config.toml > default
[toolset]
bash.timeout_secs / bash.output_byte_limitDefault: 120 / 20000Resolution: file layers > defaults
ask_user_question.timeout_enabled / ask_user_question.timeout_secsDefault: true / 1800Resolution: requirements > environment > user config > managed config > remote > default
web_fetch.proxy_endpointDefault: unsetResolution: config.toml > RIGHTNOW_WEB_FETCH_PROXY > remote > unset
web_fetch.allowed_domainsDefault: built-in listResolution: config.toml > remote > built-in list
web_fetch.allow_localDefault: falseResolution: config.toml > RIGHTNOW_WEB_FETCH_ALLOW_LOCAL > false
web_search.allowed_domains / web_search.excluded_domainsDefault: unset / unsetResolution: requirements > user > managed > defaults
[permission]also .rightnow/config.toml
allow / ask / deny / rulesDefault: emptyResolution: user and project rules merge; deny > ask > allow
[sandbox]
profileDefault: offResolution: requirement > CLI > environment > config.toml > default
auto_allow_bashDefault: falseResolution: requirement > environment > config.toml > default
[shell_environment_policy]
inherit / ignore_default_excludes / exclude / include_only / setDefault: all / false / empty / empty / emptyResolution: file layers > defaults

MCP

KeyDefaultResolution
[mcp]max_output_bytes also in .rightnow/config.toml
max_output_bytesDefault: 20000Resolution: requirements > environment > project > user > remote > default
startup_timeout_secDefault: 30Resolution: per-server value > requirements > environment > config.toml > remote > default
[mcp_servers.<name>]also .rightnow/config.toml
command / args / env / url / headersDefault: one transport required; optional fields unset or emptyResolution: nearest project entry replaces user entry by server name
enabled / startup_timeout_sec / tool_timeout_sec / tool_timeoutsDefault: true / 30 / 6000 / emptyResolution: nearest project entry replaces user entry by server name
cwd / type / bearer_token_env_var / oauth / oauth_client_id / oauth_client_secret_env_var / oauth_scopes / setup / expose_image_base64Default: unset / unset / unset / unset / unset / unset / empty / unset / falseResolution: nearest project entry replaces user entry by server name

Memory and compaction

KeyDefaultResolution
[memory]
enabledDefault: built-in false; shipped trueResolution: CLI memory flags > environment > local section > remote > built-in default
session.save_on_endDefault: trueResolution: file layers > default
watcher.enabledDefault: trueResolution: file layers > remote > default
index.max_chunk_chars / index.chunk_overlap_charsDefault: 1600 / 320Resolution: file layers > defaults
search.max_results / search.min_score / search.vector_weight / search.text_weight / search.recency_decayDefault: 6 / 0.35 / 0.7 / 0.3 / 0.95Resolution: file layers > remote > defaults
search.temporal_decay.enabled / search.temporal_decay.half_life_daysDefault: true / 7Resolution: file layers > remote > defaults
search.mmr.enabled / search.mmr.lambda / search.source_weights.*Default: false / 0.7 / 1.0Resolution: file layers > remote > defaults
initial_injection.enabled / initial_injection.min_scoreDefault: true / runtime 0.0 when unsetResolution: file layers > remote > defaults
embedding.provider / embedding.model / embedding.dimensionsDefault: api / unset, shipped empty for full-text search only / 1024Resolution: file layers > remote > defaults
watcher.stale_claim_secs / gc.max_age_daysDefault: 60 / 30Resolution: file layers > defaults
dream.enabled / dream.min_hours / dream.min_sessions / dream.stale_lock_secs / dream.check_interval_secsDefault: true / 4 / 3 / 3600 / unsetResolution: file layers > remote > defaults
[compaction]
memory_flush.enabled / memory_flush.soft_threshold_tokens / memory_flush.flush_model / memory_flush.max_flush_write_chars / memory_flush.idle_timeout_secs / memory_flush.semantic_dedup_thresholdDefault: true / 4000 / session model / 8000 / unset / runtime 0.92 when unsetResolution: file layers > remote > defaults
pruning.enabled / pruning.keep_last_n_turns / pruning.soft_trim_threshold / pruning.soft_trim_head / pruning.soft_trim_tail / pruning.hard_clear_age_turnsDefault: true / 3 / 4000 / 1500 / 1500 / 10Resolution: file layers > remote > defaults

Agents and extensions

KeyDefaultResolution
[subagents]
enabledDefault: trueResolution: CLI --subagents > environment > config.toml > default; no remote tier
max_depth / max_concurrent / limit_behavior / workflow_max_concurrentDefault: 1 / 32 / queue / 32Resolution: environment > config.toml > remote > default
toggle.* / models.* / roles.* / personas.*Default: omitted types enabled / no overrides or definitionsResolution: inline config > native role and persona files > legacy discovery
[workflows]
enabledDefault: trueResolution: remote false veto; otherwise environment > config.toml > remote true > default
[skills]
paths / ignore / disabledDefault: empty / empty / emptyResolution: file layers > built-in roots
[plugins]paths and disabled also in .rightnow/config.toml
paths / disabledDefault: empty / emptyResolution: effective user configuration; trusted project paths and project disabled entries extend it
enabledDefault: emptyResolution: file layers; enables matching discovered plugins
[compat]
cursor.skills / cursor.rules / cursor.agents / cursor.mcps / cursor.hooksDefault: built-in true; shipped disables skills, rules, and agentsResolution: environment > config.toml > remote > default
claude.skills / claude.rules / claude.agents / claude.plugins / claude.mcps / claude.hooksDefault: built-in true; shipped disables skills, rules, and agentsResolution: environment > config.toml > remote > default
cursor.sessions / claude.sessions / codex.sessionsDefault: true; staged and inertResolution: environment > config.toml > remote > default
codex.skills / codex.rules / codex.agents / codex.mcps / codex.hooksDefault: true; reserved and inertResolution: environment > config.toml > default; no remote tier

Interface

KeyDefaultResolution
[ui]
simple_mode / vim_modeDefault: true / falseResolution: file layers > defaults
max_thoughts_widthDefault: 120Resolution: file layers > default
default_selected_permissionDefault: always_allow_all_sessionsResolution: environment > config.toml > default
permission_modeDefault: askResolution: CLI mode flags > effective [ui] value > remote permission_mode > ask
disable_bypass_permissions_modeDefault: falseResolution: set in requirements.toml; true locks always-approve off
remember_tool_approvals / show_thinking_blocks / group_tool_verbs / collapsed_edit_blocksDefault: false / true / true / falseResolution: file layers > defaults
page_flip_on_send / follow_up_behavior / compact_modeDefault: true / queue / falseResolution: file layers > defaults
screen_modeDefault: unsetResolution: CLI screen flag > config.toml > terminal policy
scroll_speed / scroll_mode / scroll_lines / invert_scrollDefault: 50 / auto / unset / falseResolution: environment > config.toml > defaults
themeDefault: shipped: rightnow-nightResolution: RIGHTNOW_THEME > LC_RIGHTNOW_THEME > config.toml > built-in default
auto_dark_theme / auto_light_themeDefault: rightnow-night / rightnow-dayResolution: file layers > built-in auto-mode mappings
voice_keybind_enabledDefault: shipped: falseResolution: file layers > default
[ui.notifications]
method / condition / idle_threshold_secs / eventsDefault: auto / unfocused / 3 / turn_complete and approval_requiredResolution: file layers > defaults
sleep_prevention / progress_bar / title.enabled / title.itemsDefault: true / true / true / action-required, spinner, activity, session-name, rightnowResolution: file layers > defaults
hooks[].command / hooks[].events / hooks[].only_unfocused / hooks[].timeout_secsDefault: required / empty / true / 10Resolution: file layers > defaults
[hints]
memory_modal_fullscreen / new_session_worktree_mode / fork_worktree_modeDefault: false / never / askResolution: requirements > user > managed > system managed
[dashboard]
enabledDefault: trueResolution: RIGHTNOW_AGENT_DASHBOARD=0 disables; otherwise config.toml > default
grouping / pinned / reorderDefault: state / empty / emptyResolution: user config.toml > built-in defaults

Maintenance and trust

KeyDefaultResolution
[worktree.auto_gc]
enabled / max_age_secs / dry_run / include_rebuildDefault: true / 604800 / false / falseResolution: process overrides where implemented > config.toml > remote > defaults
min_interval_secs / include_orphan_snapshots / rebuild_min_interval_secsDefault: 21600 / Linux true, other platforms false / 86400Resolution: config.toml > remote > defaults
max_age_by_kind.*Default: manual never; other entries unsetResolution: config.toml per-kind value > remote per-kind value > product default
[folder_trust]
enabledDefault: no effect in 1.0.5 builds: every folder is trustedResolution: the gate needs a release stamp that 1.0.5 builds lack; a stamped build resolves environment > user config > managed > remote > default true
[marketplace]
require_sha / sourcesDefault: false / emptyResolution: require_sha is tighten-only across environment and config; sources come from config.toml

Telemetry and endpoints

KeyDefaultResolution
[telemetry]
events_url / events_api_key / mixpanel_enabledDefault: build-seeded or unset / build-seeded or unset / build-seeded or falseResolution: environment > file layers > build-seeded defaults
trace_uploadDefault: inherits effective telemetryResolution: requirement > environment > config.toml > remote while telemetry is on > inherited effective telemetry
otel_enabled / otel_log_user_prompts / otel_log_tool_detailsDefault: false / false / falseResolution: requirements > environment > config.toml; remote settings can only disable or lock
otel_metrics_exporter / otel_logs_exporter / otel_endpoint / otel_protocolDefault: none / none / local collector / http/protobufResolution: environment > config.toml > defaults; remote settings may disable the stream
[endpoints]
cli_chat_proxy_base_url / models_base_url / models_list_url / feedback_base_url / trace_upload_url / trace_upload_endpoint_url / managed_config_urlDefault: environment-seeded or unsetResolution: config.toml > environment-seeded defaults
deployment_keyDefault: RIGHTNOW_DEPLOYMENT_KEY or unsetResolution: config.toml > environment-seeded default
trace_upload_bucketDefault: RIGHTNOW_TRACE_UPLOAD_BUCKET or unsetResolution: RIGHTNOW_TELEMETRY_GCS_BUCKET > config.toml > RIGHTNOW_TRACE_UPLOAD_BUCKET > unset

pager.toml keys

pager.toml controls TUI appearance separately from config.toml, and changes apply after restart. Each key resolves from pager.toml, then built-in default.

KeyDocumented default
show_plan_chipDefault: false
terminal.alt_screenDefault: auto
terminal.minimal / terminal.minimal_live_rows / terminal.minimal_max_commit_rows / terminal.minimal_collapse_thinkingDefault: false / 10 / 2000 / false
animation.fps / animation.wave_rows / animation.show_fpsDefault: 30 / 32 / false
prompt.collapse_unfocused / prompt.mouse_hover / prompt.show_prefixDefault: true / true / true
scrollback.layout.outer_vpad / scrollback.layout.outer_hpad_left / scrollback.layout.outer_hpad_right / scrollback.layout.block_pad_left / scrollback.layout.block_pad_rightDefault: 1 / 2 / 2 / 2 / 2
scrollback.scrollbar.enabled / scrollback.scrollbar.gap_left / scrollback.scrollbar.gap_right / scrollback.scrollbar.scrollbar_bg / scrollback.scrollbar.scrollbar_fgDefault: true / 0 / 0 / none / none
scrollback.scroll.margin / scrollback.scroll.min_page_fraction / scrollback.scroll.follow_indicator / scrollback.scroll.follow_auto_select / scrollback.scroll.follow_by_overscroll / scrollback.scroll.anchor_on_fold / scrollback.scroll.respect_manual_foldsDefault: 0 / 0 / center / true / true / true / false
scrollback.display.sticky_headers / scrollback.display.tab_width / scrollback.display.expandable_indicator / scrollback.display.expandable_indicator_running / scrollback.display.expandable_indicator_char / scrollback.display.collapsed_accent_char / scrollback.display.group_max_visibleDefault: true / 4 / true / true / › / theme glyph / 10
scrollback.display.selection_buttons / scrollback.display.line_under_last_entry / scrollback.display.group_selection_split / scrollback.display.highlight_overlays_border / scrollback.display.dim_accentDefault: false / false / true / false / 0.5
scrollback.blocks.edit.indent / scrollback.blocks.edit.vpad / scrollback.blocks.edit.bg / scrollback.blocks.edit.accent_bg / scrollback.blocks.edit.accent / scrollback.blocks.edit.gutter_bg / scrollback.blocks.edit.indent_bgDefault: true / false / none / false / none / false / false
scrollback.blocks.edit.expanded_by_default / scrollback.blocks.edit.dual_line_numbers / scrollback.blocks.edit.line_summary / scrollback.blocks.edit.hunk_separatorDefault: unset / false / unset / …
scrollback.blocks.prompt.vpad / scrollback.blocks.prompt.bg / scrollback.blocks.prompt.accent_bg / scrollback.blocks.prompt.show_prefix / scrollback.blocks.prompt.min_linesDefault: true / light / false / true / 2
scrollback.blocks.thinking.accent / scrollback.blocks.thinking.accent_enabled / scrollback.blocks.thinking.bg_blend / scrollback.blocks.thinking.animate / scrollback.blocks.thinking.truncated_lines / scrollback.blocks.thinking.header / scrollback.blocks.thinking.header_brightDefault: none / true / 70 / true / 3 / true / false
scrollback.blocks.tool.muted_collapsed / scrollback.blocks.tool.dim_details / scrollback.blocks.tool.bulletDefault: true / true / diamond
scrollback.blocks.list_dir.terminal_bgDefault: true
scrollback.blocks.execute.first_lines / scrollback.blocks.execute.last_lines / scrollback.blocks.execute.accent_enabled / scrollback.blocks.execute.running_accent / scrollback.blocks.execute.header_style / scrollback.blocks.execute.muted_command_collapsedDefault: 2 / 3 / true / none / label / true
todo.badge_formatDefault: default
disable_pluginsDefault: false

Environment variables

This table covers selected configuration and process variables, including credentials, paths, and hook output. Their resolution follows the field-specific rules above; it is not one universal environment-over-file order.

VariablesUnset behaviorResolution
AuthenticationRIGHTNOW_API_KEY, RUNINFRA_GATEWAY_KEY, CEREBRAS_API_KEY, GROQ_API_KEY, OPENROUTER_API_KEY, AI_GATEWAY_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEYUnset: unsetResolution: Environment credential > stored key in <RIGHTNOW_HOME>/auth.json
AuthenticationRIGHTNOW_AUTH_PROVIDER_COMMAND / RIGHTNOW_AUTH_EARLY_INVALIDATION_SECSUnset: unset / 300Resolution: The helper command can also be set in config.toml; the refresh window is environment-only
EndpointsRIGHTNOW_CLI_CHAT_PROXY_BASE_URLUnset: unset; proxy-backed features offResolution: config.toml > environment-seeded default
Model discoveryRIGHTNOW_MODELS_BASE_URL / RIGHTNOW_MODELS_LIST_URLUnset: base unset / list derives from model base, then CLI proxy, else unsetResolution: config.toml > environment-seeded values; explicit list URL > model base /models > CLI proxy /models
Web-search modelRIGHTNOW_WEB_SEARCH_MODELUnset: built-in search modelResolution: CLI web-search override > environment > [models].web_search > remote > built-in default
Operational endpointsRIGHTNOW_FEEDBACK_BASE_URL / RIGHTNOW_TRACE_UPLOAD_URL / RIGHTNOW_TRACE_UPLOAD_ENDPOINT_URL / RIGHTNOW_MANAGED_CONFIG_URLUnset: unsetResolution: config.toml > environment-seeded default
Trace upload bucketRIGHTNOW_TELEMETRY_GCS_BUCKET / RIGHTNOW_TRACE_UPLOAD_BUCKETUnset: unset / unsetResolution: RIGHTNOW_TELEMETRY_GCS_BUCKET > [endpoints].trace_upload_bucket seeded by RIGHTNOW_TRACE_UPLOAD_BUCKET > unset
MemoryRIGHTNOW_MEMORYUnset: built-in 0; shipped config enables memoryResolution: --no-memory > --experimental-memory > environment > local [memory] section > remote > built-in default
SubagentsRIGHTNOW_SUBAGENTSUnset: 1Resolution: --subagents > environment > local [subagents] section > built-in default; no remote tier
WorkflowsRIGHTNOW_WORKFLOWSUnset: 1Resolution: remote false veto; otherwise environment > config.toml > remote true > built-in default
Claude plugin compatibilityRIGHTNOW_CLAUDE_PLUGINS_ENABLEDUnset: 1Resolution: environment > [compat.claude].plugins > remote > built-in default
Cursor compatibilityRIGHTNOW_CURSOR_SKILLS_ENABLED / RIGHTNOW_CURSOR_RULES_ENABLED / RIGHTNOW_CURSOR_AGENTS_ENABLED / RIGHTNOW_CURSOR_MCPS_ENABLED / RIGHTNOW_CURSOR_HOOKS_ENABLEDUnset: built-in 1; shipped config disables skills, rules, and agentsResolution: environment > corresponding [compat.cursor] key > remote > built-in default
Claude compatibilityRIGHTNOW_CLAUDE_SKILLS_ENABLED / RIGHTNOW_CLAUDE_RULES_ENABLED / RIGHTNOW_CLAUDE_AGENTS_ENABLED / RIGHTNOW_CLAUDE_MCPS_ENABLED / RIGHTNOW_CLAUDE_HOOKS_ENABLEDUnset: built-in 1; shipped config disables skills, rules, and agentsResolution: environment > corresponding [compat.claude] key > remote > built-in default
Compatibility sessionsRIGHTNOW_CURSOR_SESSIONS_ENABLED / RIGHTNOW_CLAUDE_SESSIONS_ENABLED / RIGHTNOW_CODEX_SESSIONS_ENABLEDUnset: 1; staged and inertResolution: environment > corresponding [compat] key > remote > built-in default
Reserved Codex compatibilityRIGHTNOW_CODEX_SKILLS_ENABLED / RIGHTNOW_CODEX_RULES_ENABLED / RIGHTNOW_CODEX_AGENTS_ENABLED / RIGHTNOW_CODEX_MCPS_ENABLED / RIGHTNOW_CODEX_HOOKS_ENABLEDUnset: 1; accepted but runtime-inertResolution: environment > corresponding [compat.codex] key > built-in default
Web fetchRIGHTNOW_WEB_FETCHUnset: agent launches default to 1Resolution: requirements > environment > config.toml fallback > remote
Web-fetch networkRIGHTNOW_WEB_FETCH_ALLOW_LOCAL / RIGHTNOW_WEB_FETCH_PROXYUnset: 0 / unsetResolution: allow_local: config.toml > environment > default; proxy: config.toml > environment > remote > unset
Web searchRIGHTNOW_WEB_SEARCH_ENGINE / RIGHTNOW_BRAVE_SEARCH_API_KEYUnset: agent launches default to duckduckgo / unsetResolution: duckduckgo or brave; the environment overrides the configured engine; the credential is environment-only
Session selectionRIGHTNOW_AGENT / RIGHTNOW_SANDBOX / RIGHTNOW_EXIT_TIMEOUT_SECSUnset: unset / off / 20Resolution: Agent: ACP metadata > CLI > config > environment > built-in; sandbox: requirement > CLI > environment > config; exit timeout: environment > default
InterfaceRIGHTNOW_DEFAULT_SELECTED_PERMISSION / RIGHTNOW_SCROLL_SPEED / RIGHTNOW_SCROLL_MODE / RIGHTNOW_SCROLL_LINES / RIGHTNOW_INVERT_SCROLLUnset: always_allow_all_sessions / 50 / auto / unset / falseResolution: Environment > config.toml > built-in defaults
Tool behaviorRIGHTNOW_ASK_USER_QUESTION_TIMEOUT_ENABLED / RIGHTNOW_ASK_USER_QUESTION_TIMEOUT_SECS / RIGHTNOW_RESPECT_GITIGNOREUnset: true / 1800 / falseResolution: Requirements where supported > environment > config.toml > defaults
MCP limitsRIGHTNOW_MCP_STARTUP_TIMEOUT_SECS / MCP_TIMEOUTUnset: 30 seconds / unsetResolution: Per-server setting > requirements > environment > effective config > remote > 30 seconds
MCP limitsRIGHTNOW_MAX_MCP_OUTPUT_BYTES / MAX_MCP_OUTPUT_BYTESUnset: 20000 bytesResolution: Requirements > environment > project > user > remote > default
ThemeRIGHTNOW_THEME / LC_RIGHTNOW_THEMEUnset: rightnow-nightResolution: RIGHTNOW_THEME > LC_RIGHTNOW_THEME > config.toml > built-in default
Appearance detectionRIGHTNOW_APPEARANCE / LC_RIGHTNOW_APPEARANCEUnset: detected terminal or operating-system appearanceResolution: RIGHTNOW_APPEARANCE > LC_RIGHTNOW_APPEARANCE > detected fallback
ClipboardRIGHTNOW_COPY_FILE / RIGHTNOW_CLIPBOARD_NO_DATA_CONTROL / RIGHTNOW_CLIPBOARD_NO_OSC52Unset: <RIGHTNOW_HOME>/last-copy.txt / 0 / 0Resolution: Environment-only path and route overrides
Voice captureRIGHTNOW_VOICE_CAPTUREUnset: short-lived helper on macOSResolution: The value inprocess selects the in-process fallback
Folder trustRIGHTNOW_FOLDER_TRUSTUnset: ignored in 1.0.5 buildsResolution: the gate needs a release stamp that 1.0.5 builds lack; a stamped build resolves environment > user config > managed > remote > default
Marketplace integrityRIGHTNOW_MARKETPLACE_REQUIRE_SHAUnset: 0Resolution: Tighten-only: environment or config can require a full commit SHA
DashboardRIGHTNOW_AGENT_DASHBOARDUnset: 1Resolution: The value 0 disables; otherwise [dashboard].enabled > built-in default
Agent serverRIGHTNOW_AGENT_SECRETUnset: generated tokenResolution: CLI --secret > environment > generated token
UpdatesRIGHTNOW_DISABLE_AUTOUPDATERUnset: unsetResolution: CLI --no-auto-update or a truthy environment value disables background updates
UpdatesRIGHTNOW_CHANNELUnset: stableResolution: config.toml [cli].channel > environment > installer.toml > stable
Account issuerRIGHTNOW_ISSUER_URLUnset: https://www.rightnowai.coResolution: environment > built-in default
Logging and pathsRIGHTNOW_LOG_FILE / RUST_LOG / RIGHTNOW_HOMEUnset: built-in logging policy / built-in log filter / platform product homeResolution: Environment overrides the built-in location or policy
Debug loggingRIGHTNOW_DEBUG_LOGUnset: unsetResolution: RIGHTNOW_LOG_FILE > RIGHTNOW_DEBUG_LOG > no debug target
Windows shellRIGHTNOW_SHELLUnset: auto-detectedResolution: environment override > automatic pwsh, Windows PowerShell, Git Bash, or cmd selection
TLS trustRIGHTNOW_EXTRA_CA_BUNDLE / SSL_CERT_FILEUnset: no extra bundleResolution: RIGHTNOW_EXTRA_CA_BUNDLE > SSL_CERT_FILE fallback; unusable bundles are skipped
Runtime workersRIGHTNOW_WORKER_THREADSUnset: up to 8 logical CPUsResolution: environment integer clamped to 1 through the logical CPU count > default
Version policyRIGHTNOW_MINIMUM_VERSION / RIGHTNOW_MAXIMUM_VERSION / RIGHTNOW_REQUIRED_MINIMUM_VERSION / RIGHTNOW_REQUIRED_MAXIMUM_VERSIONUnset: unsetResolution: Each environment or file bound can only tighten the effective range
Product telemetryRIGHTNOW_TELEMETRY_ENABLEDUnset: disabledResolution: requirements > environment > config.toml > remote > disabled
Mixpanel telemetryRIGHTNOW_TELEMETRY_MIXPANEL_ENABLEDUnset: build-seeded or falseResolution: environment > file layers > build-seeded default
FeedbackRIGHTNOW_FEEDBACK_ENABLEDUnset: trueResolution: requirements > environment > config.toml > remote > true
Trace uploadRIGHTNOW_TELEMETRY_TRACE_UPLOADUnset: inherits effective telemetryResolution: requirement > environment > [telemetry].trace_upload > remote while telemetry is on > inherited effective telemetry
Deployment keyRIGHTNOW_DEPLOYMENT_KEYUnset: unsetResolution: [endpoints].deployment_key > environment-seeded default
External OpenTelemetryRIGHTNOW_EXTERNAL_OTEL and the OTEL_* variables documented on the Monitoring pageUnset: master switch 0; exporters noneResolution: requirements for guarded fields > environment > config.toml; remote settings can only disable or lock
Notification hook outputRIGHTNOW_EVENT / RIGHTNOW_MESSAGE / RIGHTNOW_SESSION_IDUnset: set only while a notification hook runsResolution: Provided by RightNow; not a user setting
Hook outputRIGHTNOW_HOOK_EVENT / RIGHTNOW_HOOK_NAME / RIGHTNOW_SESSION_ID / RIGHTNOW_WORKSPACE_ROOT / RIGHTNOW_PLUGIN_ROOT / RIGHTNOW_PLUGIN_DATAUnset: set only for the applicable hook processResolution: Provided by RightNow; not a user setting

External collector defaults and every supported OTEL variable are listed on the Monitoring page.

LSP resolution

LSP definitions merge by server name in this order: Project > user > trusted plugin. A project or user entry replaces a lower-priority entry of the same name; plugin file entries precede inline plugin entries and only fill names not already defined locally.

  1. .rightnow/lsp.json: current repository
  2. <RIGHTNOW_HOME>/lsp.json: all projects
  3. .lsp.json or plugin.json: enabled trusted plugin