{"id":16826535,"url":"https://github.com/dlemstra/github-actions-debugger","last_synced_at":"2025-03-22T04:30:22.428Z","repository":{"id":167485819,"uuid":"643112708","full_name":"dlemstra/github-actions-debugger","owner":"dlemstra","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-25T10:36:23.000Z","size":214,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-18T07:51:45.186Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dlemstra.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2023-05-20T06:20:04.000Z","updated_at":"2024-12-25T10:36:26.000Z","dependencies_parsed_at":"2024-05-31T14:43:59.118Z","dependency_job_id":null,"html_url":"https://github.com/dlemstra/github-actions-debugger","commit_stats":null,"previous_names":["dlemstra/github-actions-debugger"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dlemstra%2Fgithub-actions-debugger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dlemstra%2Fgithub-actions-debugger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dlemstra%2Fgithub-actions-debugger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dlemstra%2Fgithub-actions-debugger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dlemstra","download_url":"https://codeload.github.com/dlemstra/github-actions-debugger/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244907420,"owners_count":20529850,"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-10-13T11:17:40.181Z","updated_at":"2025-03-22T04:30:21.834Z","avatar_url":"https://github.com/dlemstra.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Actions Debugger\n\nThis action that can be used to debug a GitHub action on a hosted runner. This action needs to used be together with the [runner-codespace](https://github.com/dlemstra/runner-codespace) project. This project will start a codespace where this action connects to and allows a shell access to the runner that is running the action. And it also allows you to edit the files on the runner through a codespace.\n\n## Inputs\n\n### `token`\n\n**Required** The personal access token that has access to codespaces.\n\n```yaml\n# GitHub token with the following permissions:\n# - Full control of codespaces (codespace).\n\ntoken: ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n### `codespace`\n\n**Optional** The name of the codespace that should be used.\n\nIf not specified the action will try to find the codespace that is using the `runner-codespace` project. The name of the codespace can be found in the URL of the codespace (`https://[NAME].github.dev/`).\n\n```yaml\n# The name of the codespace can be found in the URL of # the codespace\n# (`https://[NAME].github.dev/`). If not specified the action will try\n# to find the codespace that is using the runner-codespace project.\n\ncodespace: laughing-cod-jxvr564g44cpx9r\n```\n\n## Example\n\nBelow is an example of how this action can be used in a GitHub workflow.\n\n```yaml\njobs:\n  build:\n    # also works on windows-latest and ubuntu-latest\n    runs-on: macos-latest\n\n    steps:\n    - uses: actions/checkout@v4\n\n    - run: something-that-fails.sh\n\n    - name: Debug in Codespace\n      if: failure()\n      uses: dlemstra/github-actions-debugger@v1\n      with:\n        token: ${{ secrets.TOKEN_FOR_CODESPACES }}\n```\n\nOnce the action has been triggered and the job has failed, the action will try to find the codespace that is using the `runner codespace` project. And when it has found the codespace it will connect to it and allow a shell to be opened on the runner that is running the action.\n\n```console\n/workspaces/runner-codespace # shell\nWarning: Permanently added '[localhost]:4748' (ED25519) to the list of known hosts.\n\nThe default interactive shell is now zsh.\nTo update your account to use zsh, please run `chsh -s /bin/zsh`.\nFor more details, please visit https://support.apple.com/kb/HT208050.\nMac-1717160438331:runner-codespace runner$ uname -a\nDarwin Mac-1717160438331.local 23.5.0 Darwin Kernel Version 23.5.0: Wed May  1 20:12:39 PDT 2024; root:xnu-10063.121.3~5/RELEASE_ARM64_VMAPPLE arm64\nMac-1717160438331:runner-codespace runner\n```\n\n## Demo\n\n A demo of this project can be found here: https://github.com/dlemstra/github-actions-debugger-demo.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdlemstra%2Fgithub-actions-debugger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdlemstra%2Fgithub-actions-debugger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdlemstra%2Fgithub-actions-debugger/lists"}