{"id":19156063,"url":"https://github.com/tzador/englishell","last_synced_at":"2025-05-07T07:33:31.947Z","repository":{"id":187397040,"uuid":"676764376","full_name":"tzador/englishell","owner":"tzador","description":"Translate plain english commands to shell commands and execute","archived":false,"fork":false,"pushed_at":"2024-11-22T16:04:51.000Z","size":184,"stargazers_count":37,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-19T20:16:44.221Z","etag":null,"topics":["chatg","nlp","nodejs","productivity","shell"],"latest_commit_sha":null,"homepage":"https://englishell.js.org","language":"JavaScript","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/tzador.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,"zenodo":null}},"created_at":"2023-08-10T00:55:06.000Z","updated_at":"2024-11-23T15:42:46.000Z","dependencies_parsed_at":"2025-04-19T18:55:00.854Z","dependency_job_id":null,"html_url":"https://github.com/tzador/englishell","commit_stats":null,"previous_names":["tzador/englishell"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzador%2Fenglishell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzador%2Fenglishell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzador%2Fenglishell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzador%2Fenglishell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tzador","download_url":"https://codeload.github.com/tzador/englishell/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252833943,"owners_count":21811280,"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":["chatg","nlp","nodejs","productivity","shell"],"created_at":"2024-11-09T08:33:07.111Z","updated_at":"2025-05-07T07:33:31.920Z","avatar_url":"https://github.com/tzador.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# englishell\n\nA command-line tool that translates English instructions into shell commands using OpenAI's GPT-3.5, making terminal operations more intuitive and accessible.\n\n## Features\n\n- Translates natural language to shell commands\n- Works on macOS and Linux\n- Provides detailed explanations for each command\n- Requires confirmation before execution\n- Available as both `englishell` and `e` commands for convenience\n\n## Installation\n\n```bash\nnpm install -g englishell\n```\n\n## Prerequisites\n\nYou need to have an OpenAI API key set in your environment variables:\n\n```bash\nexport OPENAI_API_KEY='your-api-key-here'\n```\n\n## Usage\n\nSimply type your instruction in plain English after the command:\n\n```bash\nenglishell [your instruction]\n# or use the short form\ne [your instruction]\n```\n\n### Examples\n\n1. **Finding large files**\n\n```bash\n$ englishell find all files larger than 100MB in my home directory\n\n$ find ~/ -type f -size +100M\n\nThis command searches your home directory (~/) for files (-type f) that are larger\nthan 100 megabytes (-size +100M). The results will show the full path to each file\nthat matches these criteria.\n```\n\n2. **Process management**\n\n```bash\n$ englishell show me all running node processes\n\n$ ps aux | grep node\n\nThis command lists all running processes (ps aux) and filters the results to show\nonly those containing \"node\" in their description. The output will show the process\nID, CPU usage, memory usage, and other details for each Node.js process.\n```\n\n3. **System information**\n\n```bash\n$ englishell show system memory usage\n\n$ free -h\n\nThis command displays the system's memory usage in a human-readable format (-h).\nIt shows total memory, used memory, free memory, shared memory, and available memory,\nas well as swap usage statistics.\n```\n\n## How It Works\n\n1. Your English instruction is sent to OpenAI's GPT-3.5 model\n2. The AI generates an appropriate shell command and explanation\n3. The command and explanation are displayed for your review\n4. You can press Enter to execute the command or input a follow-up instruction\n5. The command is executed in your default shell\n\n## Supported Platforms\n\n- macOS\n- Linux\n\n## Security\n\n- All commands are shown before execution\n- Requires explicit confirmation (Enter key) before running any command\n- You can review the explanation and command before execution\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftzador%2Fenglishell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftzador%2Fenglishell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftzador%2Fenglishell/lists"}