{"id":13475820,"url":"https://github.com/darcyclarke/rawkit","last_synced_at":"2025-04-05T11:06:11.769Z","repository":{"id":57332736,"uuid":"91830875","full_name":"darcyclarke/rawkit","owner":"darcyclarke","description":"🦊 Immediately Open Chrome DevTools when debugging Node.js apps","archived":false,"fork":false,"pushed_at":"2022-02-07T12:13:17.000Z","size":1567,"stargazers_count":325,"open_issues_count":16,"forks_count":20,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-29T10:05:19.314Z","etag":null,"topics":["browser","chrome","cli","debugger","devtool","devtools","inspector","nodejs","rawkit","tools"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/darcyclarke.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-05-19T17:42:01.000Z","updated_at":"2025-03-29T09:43:20.000Z","dependencies_parsed_at":"2022-09-26T16:31:25.926Z","dependency_job_id":null,"html_url":"https://github.com/darcyclarke/rawkit","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darcyclarke%2Frawkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darcyclarke%2Frawkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darcyclarke%2Frawkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darcyclarke%2Frawkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/darcyclarke","download_url":"https://codeload.github.com/darcyclarke/rawkit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247325693,"owners_count":20920714,"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":["browser","chrome","cli","debugger","devtool","devtools","inspector","nodejs","rawkit","tools"],"created_at":"2024-07-31T16:01:23.844Z","updated_at":"2025-04-05T11:06:11.736Z","avatar_url":"https://github.com/darcyclarke.png","language":"JavaScript","readme":"[![npm version](https://badge.fury.io/js/rawkit.svg)](https://badge.fury.io/js/rawkit)\n[![Build Status](https://travis-ci.org/darcyclarke/rawkit.svg?branch=master)](https://travis-ci.org/darcyclarke/rawkit)\n[![Build status](https://ci.appveyor.com/api/projects/status/aypcyq2ry7jh8a1k?svg=true)](https://ci.appveyor.com/project/darcyclarke/rawkit)\n[![Known Vulnerabilities](https://snyk.io/test/github/darcyclarke/rawkit/badge.svg)](https://snyk.io/test/github/darcyclarke/rawkit)\n[![Dependency Status](https://david-dm.org/darcyclarke/rawkit/master.svg)](https://david-dm.org/darcyclarke/rawkit/master)\n\n# \u003cimg src=\"extension/icon.png\" width=\"48\" align=\"left\"\u003erawkit\n\n**rawkit** grabs the chrome inspector URL returned from the `node --inspect` command and immediately opens devtools. No more *clicking*, *selecting*, *copying*/*pasting* or *navigating*. Just run the command and jump into debugging.\n\n## Installation \u0026 Usage\n\n```bash\n$ npm install -g rawkit\n...\n$ rawkit example.js\n```\n\n#### With [npx](https://www.npmjs.com/package/npx)\n```bash\n$ npx rawkit example.js\n```\n\n\u003cimg src=\"https://user-images.githubusercontent.com/459713/29084045-d01c953a-7c38-11e7-9711-a2875d81f1c1.gif\" width=\"100%\" alt=\"tutorial\"\u003e\n\n## Features\n\n- ✅ Works offline\n- ✅ Supports `nodemon` \u0026 reloading\n- ✅ Supports legacy Node `\u003cv7.x` debugging protocols \u0026 devtools\n\n## Options\n\nBy default, running `rawkit` can detect any `main` script that's been defined in the current working directory's `package.json` and run that. It also will detect the version of Node.js you're running to determine whether or not to fallback to older `debug` APIs.\n\n#### `--inspect-brk` or `b`\n\nTo break on the first line of the application code.\n\n#### `--inspect-port` or `p`\n\nThe debugger port. Defaults to 9229.\n\n#### `--canary` or `c`\n\nOpen the devtools in canary.\n\n#### `--nodemon` or `n`\n\nUse [`nodemon`](https://github.com/remy/nodemon) to run/watch your node process \u0026 reload when files change. **rawkit** supports all the default configuration options for `nodemon` including `execMap` inside your project's `package.json` or `nodemon.json` files.\n\n#### `--silent` or `s`\n\nHide stdout/stderr output from child process in the terminal window.\n\n#### `--executable=[name]` or `e`\n\nSpecify the name of the executable. Defaults to `google chrome`.\n\n\u003e **Note:** `--executable` is an experimental feature as rawkit typically does all the work to determine the right executable to use based on your operating system and any other arguments or environmental configuration.\n\n## FAQ\n\n### Chrome opens to a blank page?\nYou may have some issues if your version of Chrome has recently updated and it and/or your OS hasn't be restarted. Quick fix here is to just try restarting Chrome and/or restarting your machine. This was identified in the [`opn`](https://github.com/sindresorhus/opn/issues/83) project.\n\n### Do I need to install a Chrome Extension?\n\n**rawkit** will automatically launch a splash page asking you to install a corresponding Chrome Extension the first time you run it. If you don't want to install the extension (not recommended, as the extension comes with some nice-to-have behaviors) AND are using a Mac, you can install [chrome-cli](https://github.com/prasmussen/chrome-cli) to get around this. **rawkit** will automatically detect if `chrome-cli` exists on your machine and use that to open/launch chrome once it's installed.\n\n```bash\n$ brew install chrome-cli\n```\n\n\u003e **Note:** Unfortunately, opening internal Chrome links, externally, is not possible without an aid at the moment (ie. urls that contain `chrome://` or `chrome-devtools://` in this case). This is most likely a security feature. That said, you can use a Chrome Extension as a proxy to make this work. Check out the [RESEARCH.md](https://github.com/darcyclarke/rawkit/blob/master/RESEARCH.md) for more information.\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarcyclarke%2Frawkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdarcyclarke%2Frawkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarcyclarke%2Frawkit/lists"}