Repository navigation
feat(storage): inspect and reset app storage - #22
Merged
Merged
Conversation
Read MMKV, AsyncStorage, UserDefaults, SharedPreferences, DataStore and SQLite stores from the app's data directory without app code, mark keys changed since the first read, and clear one store or all app data.
The model tool budget is full, so the destructive clear tool is panel-only and the read tool's schema is shorter.
Browse groups the app's own stores apart from SDK data, renders values by type with inline JSON trees, and searches every store at once. The Changes tab reads storage every 5 seconds while open and lists keys added, changed, and removed, highlighting only the changed JSON fields.
Buttons write realistic data to MMKV (default, custom ID, encrypted), AsyncStorage, UserDefaults or SharedPreferences, SQLite, and files, and the app shows what it reads back. run.sh builds a standalone release app; the Android release build is debuggable so the storage tool can read it.
Use Select, Tabs, InputGroup, and ButtonGroup with outline buttons, and shorten the sidebar hover highlights so neighbouring rows keep a gap.
…rage header The storage header now matches the 28px controls in the workspace toolbar, using shadcn's sm sizes for Select and Button and new sm sizes for TabsList and InputGroup.
…picker App icons and Android labels now come from one cache per view, keyed by device and app, so a panel never refetches an icon another panel loaded. AppAvatar moves to its own component with xs, sm, and md sizes.
…apsed A collapsed simulator panel left the resize handle's line directly under the toolbar's border. The handle stays draggable but hides its line while the simulators are collapsed.
SelectItem's text wrapper now centers its children, so icons line up with the text in every dropdown. The storage app picker lists each app on two lines with a larger icon.
Files becomes a normal sidebar row with its size and file count, and the size breakdown moves into the Files panel header. Store and file rows align their icon with the title line.
SDK changes stay hidden by default. A switch in the feed footer shows them, tagged SDK, and the Changes count follows the toggle.
A panel-only mobile_app_storage_table tool reads one page of rows from a database the scan found, matching the store and table against the listing so no other file or SQL can be named. Blobs arrive as hex previews. Clicking a table in a database opens the grid with column types and paging.
The table no longer has its own toolbar. The store header gains an outline back button, the table name, its column and row counts, and paging when a table has more than one page.
…r helpers Split storage-view.tsx into the shell, browse, changes, entries, and shared parts modules, with one SidebarRow for stores and files and chip colors defined once. StoragePanel runs reads and actions through one helper, and the workspace switches tools through a panel lookup instead of ternary chains. On the server, each tool resolves its driver and container in one place, store lookup and database copying are shared, AppContainer loses its duplicated copy method, AsyncStorage databases set their kind explicitly, and table limits live in storageLimits.
![github-advanced-security[bot]](https://avatars.githubusercontent.com/in/57789?s=60&v=4){kind=small}
Codex limits model-visible MCP tools to 8,000 bytes each and 64,000 combined only for plugins with a root plugin.json; this plugin's .codex-plugin manifest is the legacy format and has neither limit. The check now detects the format, always flags input schemas Codex would compact, and fails only on limits that apply.
# Conflicts: # src/server/telemetry.ts
… them first CodeQL flagged the single-pass comment removal as incomplete sanitization. The plist and SharedPreferences parsers now match comments, declarations, and doctypes as tokens and skip them, so nothing is rewritten before parsing.
The app picker now takes labels from the shared icon cache, so Android apps show their names instead of package names. Expo's internal preferences move under SDKs & system, and AsyncStorage's Android database is titled default, as on iOS.
mobile_app_storage_table and mobile_clear_app_storage were panel-only only because of the mistaken tool budget. The model can now page through SQLite rows and reset app data to test fresh states; clearing stays marked destructive, and the skill asks the model to confirm before deleting data the user may need.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a Storage tool to the workspace for inspecting and resetting what an app has saved on an iOS simulator or a debuggable Android build. It needs no code in the app.
What it does
defaults, so values the app hasn't written to disk yet are included), SharedPreferences, DataStore, SQLite and the largest files.appIcons) and avatar component (AppAvatar), now also used by the device popover.smsizes forTabsandInputGroup.ButtonGroup.Tools
mobile_app_storagemobile_app_storage_tablemobile_clear_app_storageCodex's 64 KB combined tool limit applies only to Agent Plugins (a root
plugin.json). Mobile Dev uses the legacy.codex-plugin/plugin.jsonformat, so all of its model-visible tools stay visible. This PR also correctsnpm run check:mcp-budgetanddocs/architecture.md, which had applied that limit to every plugin.Clear and the table reader only reach stores found in a fresh listing of the app's files. Table names must be in the database's own table list, so callers can't reach other files or inject SQL.
Telemetry
app_storage.operation.*per operation (read,clear,reset,table).ui.storage.*timings plus astoragesurface.docs/telemetry.md.Test app
examples/storage-test-appis an Expo app that writes realistic data to every supported store.run.sh ios|androidbuilds and installs a standalone release build; on Android it's marked debuggable so its data can be read.Verification
npm testpasses, 724 tests. They cover MMKV fixtures (including expiring and encrypted files), plist, SharedPreferences and DataStore parsing, the change diff, the SDK toggle, and table paging against a real 250-row SQLite database, including the injection attempt and a path outside the app's data folder.RKStorage), SQLite and the table grid all read correctly. The Changes feed picked up writes from the app, and clearing a store removed only its files after stopping the app.Known gaps
main.