Understand the saved settings affecting app behavior

Inspect approved preference values in your React Native app and make targeted changes during local debugging.

Preferences tools help explain behavior that depends on saved configuration or user state. Read the allowed stores and keys, then enable writes or removal only when you need to test or repair a specific setting.

Register the Suite

await Ansight.initializeAndActivate(
  Ansight.createOptionsBuilder()
    .withPreferencesTools({
      allowedStores: ["standard"],
      allowedKeyPrefixes: ["debug."],
    })
    .withReadWriteToolAccess()
    .build(),
);

Registration API

withPreferencesTools(options): configures native preferences tool options.
remoteTools.preferences.defaultStore: sets the default store.
remoteTools.preferences.allowedStores: restricts stores.
remoteTools.preferences.allowedKeys / allowedKeyPrefixes: restrict keys.

Specific Concerns

Preference values often include configuration or user state.
Restrict stores, keys, or key prefixes at registration time.
prefs.set_value uses write.
prefs.remove_key uses critical and requires withAllToolAccess().

Tool Matrix

Name	Id	Policy	Description
`List Preference Keys`	`prefs.list_keys`	`Read`	Lists native preference keys.
`Get Preference Value`	`prefs.get_value`	`Read`	Reads one native preference value.
`Set Preference Value`	`prefs.set_value`	`Write`	Writes one native preference value.
`Remove Preference Key`	`prefs.remove_key`	`Critical`	Deletes one preference key.

Tool Details

Use read tools for inspection. Enable write and delete only for local workflows that need preference repair.