{"id":26163633,"url":"https://github.com/zmuhls/cli-adventures","last_synced_at":"2025-07-24T03:05:17.060Z","repository":{"id":281260228,"uuid":"944731601","full_name":"zmuhls/cli-adventures","owner":"zmuhls","description":"Learn command line basics through a series of interactive, game-based challenges","archived":false,"fork":false,"pushed_at":"2025-03-16T22:43:26.000Z","size":44,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-16T23:29:08.128Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zmuhls.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-03-07T21:40:24.000Z","updated_at":"2025-03-16T22:43:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"9306d57c-ead3-4190-9514-8c3db4a202dd","html_url":"https://github.com/zmuhls/cli-adventures","commit_stats":null,"previous_names":["zmuhls/cli-adventures"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zmuhls/cli-adventures","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmuhls%2Fcli-adventures","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmuhls%2Fcli-adventures/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmuhls%2Fcli-adventures/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmuhls%2Fcli-adventures/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zmuhls","download_url":"https://codeload.github.com/zmuhls/cli-adventures/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmuhls%2Fcli-adventures/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266786798,"owners_count":23983871,"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","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":"2025-03-11T14:37:02.307Z","updated_at":"2025-07-24T03:05:17.053Z","avatar_url":"https://github.com/zmuhls.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CLI Adventures [BETA]\n\nA web-based game for learning terminal commands through interactive challenges in a simulated CLI environment. This is currently in beta - please submit a pull request if you find any bugs or have suggestions for improvements.\n\n## About\n\nCLI Adventures is an educational game that helps users learn terminal commands through practical, hands-on scenarios. The game simulates a command-line interface in the browser, allowing users to practice essential commands like `ls`, `cd`, `cat`, and more in a risk-free environment.\n\n## Features\n\n- Interactive terminal simulator with vintage aesthetic\n- Step-by-step challenges to learn core CLI commands\n- Virtual file system for exploration\n- Command history and navigation (arrow keys)\n- Responsive design for desktop and mobile\n- Hint system for beginners\n\n## Deployment Options\n\n### GitHub Pages (Current)\n\nThis version is configured for GitHub Pages deployment:\n1. Push this code to your GitHub repository\n2. Enable GitHub Pages in your repository settings\n3. Set the source to the main branch\n4. The game will be available at your GitHub Pages URL\n\n### Static Web Server\n\nJust upload all files to your web server - no server-side processing required.\n\n### Flask App (Python)\n\nFor additional features or server-side processing:\n\n1. Install the required packages: `pip install -r requirements.txt`\n2. Run the Flask app: `python app.py`\n3. Access at http://localhost:5000\n\n## Commands Supported\n\n- `ls` - List directory contents\n- `cd [directory]` - Change directory\n- `cat [file]` - View file contents\n- `pwd` - Print working directory\n- `mkdir [directory]` - Create directory\n- `touch [file]` - Create empty file\n- `rm [file]` - Remove file\n- `mv [src] [dst]` - Move/rename file\n- `cp [src] [dst]` - Copy file\n- `unzip [file.zip]` - Extract zip file\n- `clear` - Clear the terminal\n- `reset` - Reset the game\n- `help` - Show available commands\n\n## Challenges\n\nThe game includes several challenges designed to progressively teach CLI concepts:\n1. Navigation - Learn to move around directories\n2. File inspection - View file contents\n3. Hidden treasures - Find secret locations and complete the treasure hunt mission\n\n## Technologies Used\n\n- Frontend: HTML, CSS, JavaScript\n- Backend: Pure JavaScript (GitHub Pages version) or Python with Flask (optional)\n- Styling: Custom CSS with terminal aesthetics\n\n## License\n\nMIT\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzmuhls%2Fcli-adventures","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzmuhls%2Fcli-adventures","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzmuhls%2Fcli-adventures/lists"}