{"id":13408203,"url":"https://github.com/catallo/ht","last_synced_at":"2025-05-08T20:37:57.431Z","repository":{"id":201031546,"uuid":"705767979","full_name":"catallo/ht","owner":"catallo","description":"ht - a shell command that answers your questions about shell commands","archived":false,"fork":false,"pushed_at":"2024-01-26T15:15:06.000Z","size":23023,"stargazers_count":26,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-02-13T02:44:41.028Z","etag":null,"topics":["ai","bash","fish-shell","gpt","linux","linux-shell","llm","llm-inference","llms","macos","macos-shell","macosx","openai","openai-api","shell","shellcode","zsh"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/catallo.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}},"created_at":"2023-10-16T16:48:14.000Z","updated_at":"2024-01-22T10:54:01.000Z","dependencies_parsed_at":"2023-11-25T20:24:05.791Z","dependency_job_id":"de5368a3-175e-42c8-b9d8-2f952bb4c69c","html_url":"https://github.com/catallo/ht","commit_stats":null,"previous_names":["catallo/ht"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catallo%2Fht","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catallo%2Fht/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catallo%2Fht/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catallo%2Fht/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/catallo","download_url":"https://codeload.github.com/catallo/ht/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253146735,"owners_count":21861456,"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":["ai","bash","fish-shell","gpt","linux","linux-shell","llm","llm-inference","llms","macos","macos-shell","macosx","openai","openai-api","shell","shellcode","zsh"],"created_at":"2024-07-30T20:00:51.388Z","updated_at":"2025-05-08T20:37:57.381Z","avatar_url":"https://github.com/catallo.png","language":"Dart","readme":"\n### ht - a shell command that answers your questions about shell commands.\n\n\nhttps://github.com/catallo/ht/assets/45834058/ec95fa8f-038a-4a1d-a85e-130b0af1630d\n\nht is a shell helper tool focused on simplicity that can generate, explain and execute shell commands using AI.\n\n##### Usage\n\n- **ht \u0026lt;instruction\u003e** - answers with shell command\n\n- **ht e|explain** - explains last answer\n\n- **ht e|explain \u0026nbsp;[command]** - explains command\n\n- **ht x|execute** - executes last answer\n\n##### Examples\n\n- `ht find all IPv4 addresses in file A and write to file B`\n- `ht explain`\n- `ht explain ls -lS`\n- `ht explain \"ps -aux | grep nvidia\"`\n- `ht execute`\n\n#### Features\n\n- **Low token usage**\n- **Cached responses**\n- **Easy installation (no root required)**\n- **Automatic updates**\n\n##### About\n\nI initially created ht as a simple experiment to test GPT3's usefulness with shell commands. However, I now find myself using it extensively in my daily tasks. So I'm sharing it with the hope that it can benefit others in the same way. It's using OpenAI's GPT3.5-Turbo model now and I plan to add more models in the future, including locally running models. \n\nht is written in Dart. As a result, it is compiled into a single, self-contained binary. This means that the ht binary operates independently without requiring any external dependencies or runtime environments. Linux (x86_64) and MacOS (arm64 \u0026 Intel) binaries are available for download.\n\nTo use ht, you'll need an OpenAI API key. The good news is that due to ht's low token usage, a typical request costs about $0.00025, making it an incredibly budget-friendly tool for daily usage. You can [sign up for an API key here](https://platform.openai.com/signup) or refer to [this article](https://www.howtogeek.com/885918/how-to-get-an-openai-api-key) for detailed instructions.\n\n##### Privacy\n\nht communicates directly with OpenAI's API, without involving a third-party server. For automated updates to work, ht will send a request to the GitHub API to check for new releases.\n\n##### Installation\n\n1. Download the archive for your platform from the Downloads section below.\n2. Unzip the archive.\n3. Using a terminal, navigate to the directory containing the ht binary and run it with the -i flag to start the installation process.\n\n```\ncd Downloads\n./ht_2-0-3_linux64 -i\n```\n\nht will be installed to '~/.config/ht' and the directory will be added to your PATH. Future updates will be installed automatically.\n\n##### Downloads\n\n- [Releases](https://github.com/catallo/ht/releases)\n\n\n","funding_links":[],"categories":["\u003ca name=\"ai-cli-commands\"\u003e\u003c/a\u003eAI terminal command generator"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatallo%2Fht","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcatallo%2Fht","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatallo%2Fht/lists"}