{"id":50940966,"url":"https://github.com/trippwill/copilot-fedora-toolbox","last_synced_at":"2026-06-17T14:33:33.803Z","repository":{"id":362361353,"uuid":"1254685452","full_name":"trippwill/copilot-fedora-toolbox","owner":"trippwill","description":"toolbox image builder for copilot cli in a toolbox","archived":false,"fork":false,"pushed_at":"2026-06-03T20:50:27.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T22:18:31.491Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trippwill.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-30T22:05:50.000Z","updated_at":"2026-06-03T20:50:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/trippwill/copilot-fedora-toolbox","commit_stats":null,"previous_names":["trippwill/copilot-fedora-toolbox"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/trippwill/copilot-fedora-toolbox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trippwill%2Fcopilot-fedora-toolbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trippwill%2Fcopilot-fedora-toolbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trippwill%2Fcopilot-fedora-toolbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trippwill%2Fcopilot-fedora-toolbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trippwill","download_url":"https://codeload.github.com/trippwill/copilot-fedora-toolbox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trippwill%2Fcopilot-fedora-toolbox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34453431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":"2026-06-17T14:33:32.475Z","updated_at":"2026-06-17T14:33:33.796Z","avatar_url":"https://github.com/trippwill.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# copilot-fedora-toolbox\n\n[![CI](https://github.com/trippwill/copilot-fedora-toolbox/actions/workflows/ci.yml/badge.svg)](https://github.com/trippwill/copilot-fedora-toolbox/actions/workflows/ci.yml)\n\nBuild a Fedora Toolbox image for GitHub Copilot CLI and install a host-side\n`copilot` wrapper that runs the CLI inside the Toolbox container.\n\n## Prerequisites\n\n- Fedora Toolbx (`toolbox`) and Podman on the host.\n- `~/.local/bin` on your `PATH` for the installed wrapper.\n- Optional local development tools: `just`, `shellcheck`, and `shfmt`.\n\nThe image includes GitHub CLI, Git, common shell utilities, `shellcheck`,\n`shfmt`, `just`, `mise`, and GitHub Copilot CLI.\n\n## Install\n\nRun the setup script from the repository root:\n\n```sh\n./create-copilot-toolbox.sh\n```\n\nIf you have `just` installed, the equivalent convenience command is:\n\n```sh\njust install\n```\n\nThe script:\n\n1. Builds `localhost/copilot-cli-toolbox:latest`.\n2. Creates the `copilot-cli` Toolbox container if it does not already exist.\n3. Installs the host wrapper to `~/.local/bin/copilot`.\n\nIf `~/.local/bin` is not on your `PATH`, add it in your shell startup file:\n\n```sh\nexport PATH=\"$HOME/.local/bin:$PATH\"\n```\n\n## Usage\n\nRun Copilot CLI as usual from the host:\n\n```sh\ncopilot --help\ncopilot\n```\n\nThe wrapper runs `copilot` inside the `copilot-cli` Toolbox container, preserves\nyour current working directory, and forwards all arguments.\n\n## Configuration\n\nThe setup script and wrapper use these environment variables:\n\n| Variable | Default | Used by |\n| --- | --- | --- |\n| `COPILOT_TOOLBOX_IMAGE` | `localhost/copilot-cli-toolbox:latest` | setup script |\n| `COPILOT_TOOLBOX_CONTAINER` | `copilot-cli` | setup script and wrapper |\n| `COPILOT_TOOLBOX_BIN_DIR` | `${XDG_BIN_HOME:-$HOME/.local/bin}` | setup script |\n| `COPILOT_TOOLBOX_EDITOR` | `${EDITOR:-vim}` | wrapper |\n| `COPILOT_TOOLBOX_VISUAL` | `${VISUAL:-$COPILOT_TOOLBOX_EDITOR}` | wrapper |\n\nIf you change `COPILOT_TOOLBOX_CONTAINER`, export it persistently in your shell\nstartup file before running the setup script and before using `copilot`. The\nscript and wrapper must agree on the container name.\n\n## Update or recreate the Toolbox\n\nRebuilding the image does not update an already-created Toolbox container. To\nrebuild the image and recreate the container:\n\n```sh\n./create-copilot-toolbox.sh --recreate\n```\n\nOr with `just`:\n\n```sh\njust recreate\n```\n\nNormal rebuilds reuse Podman layers, including the Copilot CLI and `mise`\nlayers. To refresh those floating latest installs and recreate the Toolbox so\nit uses the rebuilt image:\n\n```sh\njust refresh\n```\n\nTo refresh the Copilot CLI and `mise` image layers without recreating the\nToolbox:\n\n```sh\n./create-copilot-toolbox.sh --refresh-tools\njust build-refresh\n```\n\nTo rebuild the image and skip wrapper installation:\n\n```sh\n./create-copilot-toolbox.sh --no-install-wrapper\n```\n\nRerun `./create-copilot-toolbox.sh` to reinstall the wrapper after editing it.\n\n## Local validation\n\nIf you have `just`, `shellcheck`, and `shfmt` installed on the host:\n\n```sh\njust check\n```\n\nUseful recipes:\n\n```sh\njust --list\njust install\njust recreate\njust refresh\njust fmt\njust lint\njust build\njust build-refresh\n```\n\nThe container image also installs these tools, so you can run validation from\ninside the Toolbox after it is created.\n\n## Troubleshooting\n\n- `copilot: command not found`: make sure `~/.local/bin` is on `PATH`, then run\n  `./create-copilot-toolbox.sh` again.\n- `toolbox: command not found`: install Fedora Toolbx on the host.\n- `mise: command not found` inside the Toolbox: recreate the Toolbox with\n  `./create-copilot-toolbox.sh --recreate` so the latest image is used.\n- Terminal display issues in Ghostty: the image installs the included\n  `xterm-ghostty` terminfo entry during build.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrippwill%2Fcopilot-fedora-toolbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrippwill%2Fcopilot-fedora-toolbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrippwill%2Fcopilot-fedora-toolbox/lists"}