{"id":31280645,"url":"https://github.com/instantos/instantcli","last_synced_at":"2026-04-11T21:29:10.602Z","repository":{"id":313613097,"uuid":"1052021980","full_name":"instantOS/instantCLI","owner":"instantOS","description":"Consolidating lots of instantOS stuff into a single CLI","archived":false,"fork":false,"pushed_at":"2026-04-07T12:02:27.000Z","size":5859,"stargazers_count":3,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-07T13:05:37.525Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/instantOS.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-09-07T08:27:53.000Z","updated_at":"2026-04-07T10:42:35.000Z","dependencies_parsed_at":"2026-04-07T13:02:14.592Z","dependency_job_id":null,"html_url":"https://github.com/instantOS/instantCLI","commit_stats":null,"previous_names":["instantos/instantcli"],"tags_count":107,"template":false,"template_full_name":null,"purl":"pkg:github/instantOS/instantCLI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instantOS%2FinstantCLI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instantOS%2FinstantCLI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instantOS%2FinstantCLI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instantOS%2FinstantCLI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/instantOS","download_url":"https://codeload.github.com/instantOS/instantCLI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instantOS%2FinstantCLI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31515151,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2025-09-24T02:41:08.521Z","updated_at":"2026-04-07T14:00:54.558Z","avatar_url":"https://github.com/instantOS.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# InstantCLI\n\n[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)\n[![Rust](https://img.shields.io/badge/rust-%23000000.svg?style=flat\u0026logo=rust\u0026logoColor=white)](https://www.rust-lang.org/)\n\nA powerful, Rust-based command-line tool for managing dotfiles, game saves,\nsystem diagnostics, and instantOS configurations. InstantCLI provides a\ndecentralized approach to dotfile management that respects user modifications\nwhile enabling easy theme and configuration switching.\n\n## Features\n\n### **Dotfile Management**\n- **Multi-repository support** with priority-based overlaying\n- **Smart modification detection** using hashes to protect user changes\n- **Subdirectory management** for organizing different configuration sets like themes\n\n### **Game Save Management**\n- Centralized game save backup and restore\n- Support for popular free cloud storage services\n- Automatic save location detection\n\n### **Application Launcher**\n- Launch desktop applications\n- Fuzzy finding\n- Frecency (Higher ranking for frequently and recently used apps)\n- Based on reusing Terminal windows using scratchpads\n\n\n## Installation\n\n### Quick install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/instantOS/instantCLI/main/scripts/install.sh | sh\n```\n\nSet `INSTALL_DIR` to override the destination directory (defaults to a writable user bin in your `PATH`, otherwise `/usr/local/bin`).\n\nCheck before you pipe `:)`\n\n### Cargo\n\n```bash\ncargo install ins\n```\n\n### AUR\n\n```bash\nyay -S ins\n```\n\n### From Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/your-username/instantCLI.git\ncd instantCLI\n\n# Build and install locally\njust install\n\n# Or install system-wide (requires sudo)\njust rootinstall\n```\n\n### Dependencies\n\n- Rust\n- Git\n- FZF\n- Restic\n- SQLite3\n\n#### Arch\n\n```bash\nsudo pacman -Sy git fzf restic sqlite --needed\n```\n\n#### Ubuntu\n\n```bash\nsudo apt update; sudo apt install -y git fzf restic libsqlite3-dev sqlite3\n```\n\n## Dotfile Management\n\n### Dotfile Structure\n\n`ins` expects dotfile repositories to have a specific structure:\n\n```\nyour-dotfiles-repo/\n├── instantdots.toml          # Repository metadata\n├── dots/                     # Main dotfiles directory\n│   ├── .config/\n│   │   ├── kitty/\n│   │   │   └── kitty.conf\n│   │   └── nvim/\n│   │       └── init.vim\n│   └── .bashrc\n├── mytheme/                   # Optional: theme-specific configs\n│   └── .config/\n│       └── kitty/\n│           └── theme.conf\n└── myothertheme/              # Optional: theme-specific configs\n    └── ...\n```\n\n## Development\n\n### Building\n\n```bash\n# Debug build\ncargo build\n\n# Release build\ncargo build --release\n\n# Run with debug logging\ncargo run -- --debug \u003ccommand\u003e\n```\n\n### Testing\n\n```bash\n# Run all tests\ncargo test\n\n# Run integration tests\njust test\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstantos%2Finstantcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finstantos%2Finstantcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstantos%2Finstantcli/lists"}