{"id":20668098,"url":"https://github.com/daelvn/cosrun","last_synced_at":"2026-02-27T10:33:00.529Z","repository":{"id":94198982,"uuid":"242663680","full_name":"daelvn/cosrun","owner":"daelvn","description":"Run projects with CraftOS-PC 2","archived":false,"fork":false,"pushed_at":"2020-08-26T15:23:44.000Z","size":42,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-10T15:12:00.158Z","etag":null,"topics":["computercraft","craftos","craftos-pc"],"latest_commit_sha":null,"homepage":"","language":"MoonScript","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/daelvn.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2020-02-24T06:32:20.000Z","updated_at":"2020-03-01T23:23:42.000Z","dependencies_parsed_at":"2023-04-26T15:16:33.852Z","dependency_job_id":null,"html_url":"https://github.com/daelvn/cosrun","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/daelvn/cosrun","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daelvn%2Fcosrun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daelvn%2Fcosrun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daelvn%2Fcosrun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daelvn%2Fcosrun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daelvn","download_url":"https://codeload.github.com/daelvn/cosrun/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daelvn%2Fcosrun/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29891480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T09:48:51.284Z","status":"ssl_error","status_checked_at":"2026-02-27T09:48:43.992Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["computercraft","craftos","craftos-pc"],"created_at":"2024-11-16T19:47:36.627Z","updated_at":"2026-02-27T10:33:00.513Z","avatar_url":"https://github.com/daelvn.png","language":"MoonScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# COSRun\n\nCOSRun is a project that makes running projects in [CraftOS-PC](https://www.craftos-pc.cc) much easier, by letting you use environments and using features such as CraftOS-PC mounts.\n\n## Installation\n\nYou can install this using LuaRocks:\n\n```sh\n$ luarocks install cosrun\n```\n\nAlternatively, clone the repo and run `luarocks make`:\n\n```sh\n$ git clone daelvn/cosrun\n$ luarocks make\n```\n\n## Usage\n\n\u003e You can get a full list of commands with `cosrun -h` or `cosrun \u003ccommand\u003e -h`\n\nBefore using COSRun, you have to create a `cosrun.yml` file in your working directory. This will contain the executable path and other options.\n\n```yaml\nexecutable: /mnt/c/Program Files/CraftOS-PC/CraftOS-PC.exe\n# skip this if you're not on wsl\nwsl:\n  use:    true\n  prefix: \\\\wsl$\\Alpine\\\n# this is optional\nflags: ''\n```\n\nTo start a new environment and then change to it, use:\n\n```sh\n$ cosrun env new \u003cname\u003e\n$ cosrun env set \u003cname\u003e\n```\n\nThen, you can attach folders to it. You need to attach at least root to run it. Let's attach two folders.\n\n```sh\n### cosrun attach add path/ --root\n### cosrun attach add path/ insidepath/\n$ cosrun attach add project/src/ --root\n$ cosrun attach add project/lib/ /lib/\n```\n\nNow you can run it with: (ID defaults to 0, change that with `--id` option.)\n\n```sh\n$ cosrun run \u003cname\u003e\n```\n\nWhen a COSRun project runs, it copies the files from your root path to the computer ID root, and then mounts the rest of folders using CraftOS-PC's `mounter` API. It isn't recommended that you edit files in your source code while it's running or you could lose changes. Other mounts that aren't root don't need copying because CraftOS-PC works directly in them instead of copying them over.\n\nIf you want to clear the files *inside* the computer, use `clean`:\n\n```sh\n# Don't worry, this doesn't delete source files\n$ cosrun clean \u003cid\u003e\n$ cosrun clean --all # only if you want to delete all files\n```\n\nIf you want to share your project, instead of copying the `.cosrun` folder, just create an image like this:\n\n```sh\n$ cosrun image pack \u003cenv\u003e project.yml\n```\n\nThen someone else can clone your repo, unpack the image and run it like this:\n\n```sh\n$ git clone you/your-amazing-repo\n$ cosrun image unpack amazing-project.yml\n$ cosrun run amazing-project\n```\n\n### Merging projects\n\nYou can use several projects in the same emulator by using `cosrun image import`:\n\n```sh\n$ cosrun image import child.yml 0      # cosrun img import \u003cimg\u003e \u003cid\u003e\n$ cosrun run parent\n```\n\n## License\n\nSee LICENSE.md.\n\nBasically: This project, filekit and ansikit are Unlicensed. LuaFileSystem uses its own. argparse and lyaml are MIT.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaelvn%2Fcosrun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaelvn%2Fcosrun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaelvn%2Fcosrun/lists"}