{"id":18813044,"url":"https://github.com/oddsdk/odd-devtools","last_synced_at":"2026-01-12T06:30:12.950Z","repository":{"id":48278027,"uuid":"516817404","full_name":"oddsdk/odd-devtools","owner":"oddsdk","description":"An extension to help developers use the Webnative SDK","archived":false,"fork":false,"pushed_at":"2023-05-11T16:31:34.000Z","size":688,"stargazers_count":2,"open_issues_count":6,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-30T00:24:07.378Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Svelte","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oddsdk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-22T16:26:57.000Z","updated_at":"2023-04-30T05:14:46.000Z","dependencies_parsed_at":"2024-11-07T23:36:27.890Z","dependency_job_id":"91b9d982-4b47-45c7-badc-e68be79f87e2","html_url":"https://github.com/oddsdk/odd-devtools","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":"jeffgca/browser-extension-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oddsdk%2Fodd-devtools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oddsdk%2Fodd-devtools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oddsdk%2Fodd-devtools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oddsdk%2Fodd-devtools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oddsdk","download_url":"https://codeload.github.com/oddsdk/odd-devtools/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239748295,"owners_count":19690237,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T23:36:06.698Z","updated_at":"2025-02-19T23:17:34.028Z","avatar_url":"https://github.com/oddsdk.png","language":"Svelte","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ODD Devtools\n\nODD Devtools is a browser extension for debugging applications that use the ODD SDK. It logs session and file system events across domains and app namespaces. Each event includes information about the state of an application, including ODD SDK version, data root CID, username, account DID, agent DID, and capabilities.\n\nGet started by setting debug to true in your ODD program. Open the devtools and select the ODD SDK tab. The ODD Devtools will connect to the ODD SDK and start logging events when they occur.\n\nODD Devtools organizes event logs by app namespace when debugging more than one app, for example, when one app requests capabilities from another. Select a namespace from the left panel to filter events, or select \"All Namespaces\" to view all events.\n\nFilter events by entering a search term into the filter input. The filter checks for matches in any event payload value. For example, you could enter \"private\" to only view changes to the private file system.\n\n## Set up\n\nInstall the dependencies\n\n```\nnpm install\n```\n\n## Build\n\nThe build produces Firefox and Chrome extensions in the `dist` directory.\n\n```\nnpm run build\n```\n\n## Development\n\n### Chrome\n\nThe Chrome extension can be loaded at `chrome://extensions/`. Make sure the \"Developer mode\" toggle at the top right is enabled.\n\nSelect \"Load unpacked\". Find the directory with the built Chrome extension and select it.\n\nOpen a web app that is using ODD SDK with `debug` set to `true`. In the devtools, select the ODD SDK panel. The devtools will connect to ODD SDK when the panel is shown and on page reloads.\n\nThe extension will listen for messages after the extension has successfully connected with the ODD SDK.\n\n### Firefox\n\nThe Firefox extension can be loaded at `about:debugging`. Select \"This Firefox\", then \"Load Temporary Add-on\". Find the directory with the Firefox build and select `manifest.json` and \"Open\".\n\nFirefox requires an extra permission step. Open `about:addons` and find the extension. Select it and in the permissions tab toggle \"Access your data for all websites\" on.\n\n\n#### Notes to reviewer\n\nThis extension was built on macOS Ventura version 13.3.1 (a). The build used `npm` at version 8.15.0 and node at `v18.7.0`.\n\nThe extension is compiled using Vite configured by `vite.chrome.config.ts` and `vite.firefox.config.ts`. Vite emits distributions for Firefox and Chrome in `dist/firefox` and `dist/chrome` respectively.\n\nAll utilities necessary for building the extension are installed by running `npm install`.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foddsdk%2Fodd-devtools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foddsdk%2Fodd-devtools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foddsdk%2Fodd-devtools/lists"}