{"id":19635529,"url":"https://github.com/talandar99/riptide","last_synced_at":"2025-02-26T21:41:53.565Z","repository":{"id":179513434,"uuid":"663611926","full_name":"Talandar99/riptide","owner":"Talandar99","description":"cli tool for running scripts","archived":false,"fork":false,"pushed_at":"2025-01-18T13:23:47.000Z","size":61,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-18T14:47:45.760Z","etag":null,"topics":["bash","bash-completion","cli","linux","rust","scripting","tool"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Talandar99.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}},"created_at":"2023-07-07T17:46:40.000Z","updated_at":"2025-01-18T13:23:48.000Z","dependencies_parsed_at":"2024-05-06T16:44:29.019Z","dependency_job_id":null,"html_url":"https://github.com/Talandar99/riptide","commit_stats":null,"previous_names":["talandar99/riptide"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Talandar99%2Friptide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Talandar99%2Friptide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Talandar99%2Friptide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Talandar99%2Friptide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Talandar99","download_url":"https://codeload.github.com/Talandar99/riptide/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240941484,"owners_count":19882062,"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":["bash","bash-completion","cli","linux","rust","scripting","tool"],"created_at":"2024-11-11T12:25:42.240Z","updated_at":"2025-02-26T21:41:53.552Z","avatar_url":"https://github.com/Talandar99.png","language":"Rust","readme":"# 🌊 Riptide \nSimple cli tool for running scripts \n\n## How it works / How to use\n- Add scripts to `~/scripts` directory (or other directory specified in `$HOME/.config/riptide`)\n- run by typing `riptide $SCRIPT_NAME`. You can use `\u003cTAB\u003e` for autocompletion\n- example usage:\n```bash\n~\u003e riptide my_script.sh\n# output:\nHello From my_script\n```\n- You can use alias `rt` insted of typing `riptide` (only if installed using `make install-with-alias`):\n```bash\n~\u003e rt my_script.sh\n# output:\nHello From my_script\n```\n- You can also use script arguments:\n```bash\n~\u003e riptide echo_script_args.sh foo bar \n# output:\nHello From echo_script_args\nfoo\nbar\n```\n- You can execute script using ssh with `--remote` or `-r` flag. Script will be coppied via scp, executed, and removed from remote host:\n```bash\n~\u003e riptide make_dir.sh test --remote username@hostname\n# output:\n-------------------------------\nRemote Execution of make_dir.sh\nat username@hostname\n-------------------------------\nmake_dir.sh         100%   21     9.2KB/s   00:00\n```\n- You can edit script using `--edit` or `-e` flag. default editor is VIM but you can change it in config file\n```bash\n~\u003e riptide --edit make_dir.sh\n# output: \"it will open vim\"\n```\n- You can cat script into your terminal using `--cat` or `-c` flag.\n```bash\n~\u003e riptide --cat make_dir.sh\n# output:\n#!/bin/bash\nmkdir \n```\n## Requirements\n- Rust\n- Bash (not tested on other shells)\n- SSH \n- [bash-completion](https://github.com/scop/bash-completion) **(optional)** (install for autocomplete)\n- make sure you have `~/.cargo/bin` in your path \n\n## How to install\n##### - basic install\n```\nmake install\n```\n##### - install with alias (typing `rt` insted of `riptide` is faster but check first if it's not in conflict with other command)\n```\nmake install-with-alias\n```\n##### !!note!! \u003cbr/\u003emake will create config file at `$HOME/.config/riptide`, and scripts file at `$HOME/scripts` with 3 examples\n## How to remove\n```\nmake uninstall\n```\n## Default config file\n```toml\n[path]\npath=\"/home/username/scripts/\"\n[editor]\neditor=\"vim\"\n```\n## FAQ\n#### command not found. Why?\nMake sure you added .cargo/bin to your path. Just add this into `.bashrc`:\n```\nexport PATH=$HOME/.cargo/bin:$PATH\n```\nand restart your terminal emulator . I will add global installation in future\n## TODO / current state\n- [x] running scripts from predefined path\n- [x] autocompletion\n- [x] makefile or installation script\n- [x] config file\n- [x] support for `rt` alias\n- [x] support for script arguments\n- [x] remote execution \n- [x] cat - you can see script with a flag\n- [x] edit - you can edit/create script with a flag\n- [x] manual/help command\n- [x] running nonexisting flag now result in popup \n- [ ] editing not executable script make it executable\n- [ ] support for multiple paths\n- [ ] support for ~ (home directory)\n- [ ] support for other shells \n    - [ ] ash\n    - [ ] fish\n    - [ ] nush\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftalandar99%2Friptide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftalandar99%2Friptide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftalandar99%2Friptide/lists"}