{"id":20929384,"url":"https://github.com/cognitive-engineering-lab/repo-quest","last_synced_at":"2025-04-11T12:50:56.324Z","repository":{"id":251545837,"uuid":"808844607","full_name":"cognitive-engineering-lab/repo-quest","owner":"cognitive-engineering-lab","description":"Learn programming concepts through interactive Github tutorials","archived":false,"fork":false,"pushed_at":"2025-04-08T22:25:20.000Z","size":2562,"stargazers_count":10,"open_issues_count":8,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-08T22:26:10.855Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","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/cognitive-engineering-lab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","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":"2024-06-01T00:39:27.000Z","updated_at":"2025-04-08T22:19:09.000Z","dependencies_parsed_at":"2024-08-28T00:44:33.401Z","dependency_job_id":"d0253188-cb2f-4afe-8e02-42e783c107a2","html_url":"https://github.com/cognitive-engineering-lab/repo-quest","commit_stats":null,"previous_names":["cognitive-engineering-lab/repo-quest"],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cognitive-engineering-lab%2Frepo-quest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cognitive-engineering-lab%2Frepo-quest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cognitive-engineering-lab%2Frepo-quest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cognitive-engineering-lab%2Frepo-quest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cognitive-engineering-lab","download_url":"https://codeload.github.com/cognitive-engineering-lab/repo-quest/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247941702,"owners_count":21022038,"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-18T21:19:13.968Z","updated_at":"2025-04-11T12:50:56.305Z","avatar_url":"https://github.com/cognitive-engineering-lab.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RepoQuest\n\nRepoQuest is an experimental tool for interactive programming tutorials. Each lesson takes place in a Github repository, and RepoQuest uses the Github interface for issues and pull requests to provide starter code and explain programming concepts. You can see how RepoQuest works in this short video: \u003chttps://www.youtube.com/watch?v=MY75S1sEuc8\u003e\n\n## Installation\n\n### Option A: Download prebuilt binary\n\nThe latest binary release is on our Github releases page: \u003chttps://github.com/cognitive-engineering-lab/repo-quest/releases/latest\u003e\n\nWe have prebuilt binaries for MacOS (x86-64 and ARM64), Linux (x86-64), and Windows (x86-64 and ARM64).\n\n#### MacOS\n\n1. Download the `.dmg` for your platform (aarch64 for M-series Macs, x64 otherwise).\n2. Drag `RepoQuest.app` into `/Applications`.\n3. Configure your OS to allow the app by running at the terminal:\n   ```console\n   xattr -cr /Applications/RepoQuest.app\n   ```\n\n#### Linux\n\n1. Download the relevant package file for your distro (`.deb` for Ubuntu, `.rpm` for Fedora, `.AppImage` otherwise).\n2. Install it through your package manager (e.g., `apt install ./the-file.deb`).\n\n#### Windows\n\n1. Download the installer (either `.msi` or `.exe`) for your platform (arm64 for ARM chips, x64 otherwise).\n2. Run the installer.\n\nNote that Windows will aggressively prevent you from running the installer. For example, in Edge you will need to right click the download and select \"Keep\", then hit \"Show More\", then hit \"Keep anyway\". When you open the installer, Windows Defender will stop it from running \u0026mdash; again, hit \"More Info\" and click \"Run anyway\".\n\n### Option B: Build from source\n\nYou will need [Rust](https://rustup.rs/) and [pnpm](https://pnpm.io/installation). Then install `tauri-cli`:\n\n```console\ncargo install tauri-cli --version \"^2.0.0-rc\"\n```\n\nThen clone the repository and build it:\n\n```console\ngit clone https://github.com/cognitive-engineering-lab/repo-quest\ncd repo-quest/rs/crates/repo-quest\ncargo run --bin export-bindings\ncargo tauri build\n```\n\nThen install the generated bundle. (TODO: flesh this out)\n\n## Setup\n\nTo setup RepoQuest, you first need to have Git installed on your computer with the `git` executable accessible on your PATH. You will need a Github account.\n\n### Github Token\n\nYou need to generate a Github access token that allows RepoQuest to perform automatically Github actions (e.g., filing an issue). You can do this in one of two ways:\n\n#### Option A: Generate a one-off token\n\nGo to \u003chttps://github.com/settings/tokens/new\u003e. Select the **repo** scope. Click \"Generate Token\" at the bottom. Copy the token into the file `~/.rqst-token`. On MacOS, you can run:\n\n```console\npbpaste \u003e ~/.rqst-token\n```\n\n*Note:* these tokens will expire after a few months. You will have to refresh the token if you want to use RepoQuest after its expiration.\n\n#### Option B: Use the github CLI\n\nInstall the `gh` tool following these instructions: \u003chttps://github.com/cli/cli#installation\u003e\n\nThen login by running:\n\n```console\ngh auth login\n```\n\nTry running `gh auth token`. If that succeeds, then you're good.\n\n### Launching RepoQuest\n\nNext, you need to launch the RepoQuest app. This depends on which OS you're using.\n\n#### MacOS\n\nYou can launch the app via the finder (Cmd+Space) by searching for \"RepoQuest\". Or you can add `/Applications/RepoQuest.app/Contents/MacOS` to your `PATH` and run `repo-quest` from the command line.\n\n#### Linux\n\nRun `repo-quest` from the command line.\n\n#### Windows\n\nSearch for \"RepoQuest\" in your applications list and run it.\n\n\n**FAQ**\n\n- **Q:** On Mac, when I open RepoQuest, I get the error \"“RepoQuest” is damaged and can’t be opened. You should move it to the Trash.\"\n\n  **A:** Make sure you run the `xattr` command [described above](#macos).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcognitive-engineering-lab%2Frepo-quest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcognitive-engineering-lab%2Frepo-quest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcognitive-engineering-lab%2Frepo-quest/lists"}