{"id":26629903,"url":"https://github.com/aspadax/you","last_synced_at":"2026-04-24T10:32:52.088Z","repository":{"id":281584310,"uuid":"945729435","full_name":"AspadaX/you","owner":"AspadaX","description":"Translate your natural language into executable command(s) on the fly","archived":false,"fork":false,"pushed_at":"2025-07-07T13:13:07.000Z","size":174,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-07T14:33:49.904Z","etag":null,"topics":["ai","anthropic","command-line-tool","deepseek","gpt","gpt-4","linux","openai"],"latest_commit_sha":null,"homepage":"https://github.com/AspadaX/you","language":"Rust","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/AspadaX.png","metadata":{"files":{"readme":"README.md","changelog":"Changes.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}},"created_at":"2025-03-10T03:09:25.000Z","updated_at":"2025-07-07T13:13:11.000Z","dependencies_parsed_at":"2025-06-13T02:20:41.133Z","dependency_job_id":"549832d8-091c-4626-9a25-67ab6981797b","html_url":"https://github.com/AspadaX/you","commit_stats":null,"previous_names":["aspadax/do","aspadax/done","aspadax/eai","aspadax/you"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/AspadaX/you","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AspadaX%2Fyou","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AspadaX%2Fyou/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AspadaX%2Fyou/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AspadaX%2Fyou/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AspadaX","download_url":"https://codeload.github.com/AspadaX/you/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AspadaX%2Fyou/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264094544,"owners_count":23556661,"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","anthropic","command-line-tool","deepseek","gpt","gpt-4","linux","openai"],"created_at":"2025-03-24T13:15:55.373Z","updated_at":"2025-12-24T10:48:02.994Z","avatar_url":"https://github.com/AspadaX.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# You - Your Optimized UNIX (and Windows too)\n\nEnglish | [中文](./README_CN.md)\n\n`you` is a command-line tool that translates natural language instructions into executable shell commands, making command-line operations more accessible and intuitive. It's designed especially for newcomers to command-line interfaces, but also helps experienced users by reducing cognitive load and documentation searches.\n\n## Core Features\n\n- **Talk in Plain Language**: Just tell the tool what you want to do in regular words, and it turns that into commands the computer understands\n- **Chat Mode**: Have a back-and-forth conversation where you can ask for multiple things while the tool remembers what you talked about before\n- **Command Review**: The tool handles the hard technical stuff but lets you decide when to run commands\n- **Save for Later**: Keep useful commands to use again without having to ask the tool each time\n\n## Installation\n\n### Setup Script (Linux \u0026 macOS)\n\nDownload and run the setup script:\n\n```bash\ncurl -O https://raw.githubusercontent.com/AspadaX/you/main/setup.sh \u0026\u0026 chmod +x ./setup.sh \u0026\u0026 ./setup.sh \u0026\u0026 rm ./setup.sh\n```\n\nTo update:\n\n```bash\ncurl -O https://raw.githubusercontent.com/AspadaX/you/main/update.sh \u0026\u0026 chmod +x ./update.sh \u0026\u0026 ./update.sh \u0026\u0026 rm ./update.sh\n```\n\nTo uninstall:\n\n```bash\ncurl -O https://raw.githubusercontent.com/AspadaX/you/main/uninstall.sh \u0026\u0026 chmod +x ./uninstall.sh \u0026\u0026 ./uninstall.sh \u0026\u0026 rm ./uninstall.sh\n```\n\n### Using Cargo\n\nIf you have Rust installed:\n\n```bash\ncargo install you\n```\n\n## Usage\n\n### About Setting Up the LLM\n\nBy default, the environment variables in your `~/.zshrc` (for zsh, primarily macOS), or `~/.bashrc` (for bash, most Linux systems), should look like this:\n```bash\nexport YOU_OPENAI_API_BASE=\"https://api.openai.com/v1\"\nexport YOU_OPENAI_API_KEY=\"sk-yourapikey\"\nexport YOU_OPENAI_MODEL=\"gpt-4.1\" # model you want to use\n```\nNotice that for all OpenAI-compatible API bases, it needs to end with a `/v1`. If adding `v1` does not work, then you might want to remove it. \n\nFor Ollama users, you will also need the `/v1` at the end of the url. For example, if your endpoint is `http://localhost:11434`, then you probably need to put `http://localhost:11434/v1`. \n\n### Basic Command Execution\n\nRun a command described in natural language:\n\n```bash\nyou run \"find the largest file in my downloads directory\"\n```\n\n### Command Explanation\n\nGet an explanation of what a command does:\n\n```bash\nyou explain \"find . -type f -name '*.txt' -size +10M\"\n```\n\n### Interactive Mode\n\nStart a conversational session to run multiple related commands:\n\n```bash\nyou run\n```\n\n### Cache Management\n\nList all cached scripts:\n\n```bash\nyou list\n# or use the alias\nyou ls\n```\n\nRemove a specific cached script:\n\n```bash\nyou remove \u003cscript_name\u003e\n# or use the alias\nyou rm \u003cscript_name\u003e\n```\n\n### Configure your preferred CLI\n\nYou may want to use `fd` over `find`, or prefer using a different CLI rather than letting the LLM guess. In this case, you may update the configuration file located at `~/.you/configurations.json`. Below is an example:\n\n```json\n{\n  \"preferred_clis\": [\n    {\n      \"name\": \"fd\",\n      \"preferred_for\": \"search files. and replace find\"\n    }\n  ]\n}\n```\n\nNow, `you` will use `fd` over `find` when you issue commands relevant to searching files. \n\n### Enable Cache\n\nIf you would like to enable cache feature, you may also want to enable it in the `~/.you/configurations.json`:\n\n```json\n{\n  \"enable_cache\": true,\n  \"preferred_clis\": [\n    {\n      \"name\": \"fd\",\n      \"preferred_for\": \"search files. and replace find\"\n    }\n  ]\n}\n```\n\n## Other Examples\n\n```bash\n# Find files you've modified in the last week\nyou run \"show me files I've modified in the last 7 days\"\n\n# Get system information\nyou run \"how many CPU cores and how much RAM does this system have?\"\n\n# Complex tasks made simple\nyou run \"compress all JPG images in the current directory and save them to a new folder\"\n\n# Remote operations\nyou run \"connect to my server at 192.168.*.* and check disk space\"\n```\n\n## LLM Support\n\n`you` works with various LLMs:\n\n- Works well with small models like `smollm2`\n- Compatible with OpenAI compatible APIs, such as DeepSeek.\n- Compatible with `ollama` for using any open-source model for free\n- Configure your preferred model for the best balance of performance and accuracy\n\n## Workflow\n\n1. Type your request in natural language\n2. Review the suggested command(s) and explanation\n3. Type 'y' to execute or provide additional guidance\n4. If there's an error, the AI automatically suggests a corrected command\n5. Optionally save useful command sequences for future reuse\n\n## Why Use You?\n\n- **Reduce Documentation Searches**: Get the right command without extensive searching\n- **Learning Tool**: See how natural language translates to actual commands\n- **Productivity Boost**: Accomplish complex tasks with simple instructions\n- **Safe Command Execution**: Review commands before execution\n- **Error Recovery**: Get help when commands fail\n- **Context Retention**: In interactive mode, the AI remembers previous commands\n\n## License\n\nMIT\n\n## Credits\n\nCreated by Xinyu Bao\n\n## Acknowledgments\n\nThis project would not be possible without these amazing libraries:\n\n- **anyhow**: Error handling made simple and flexible\n- **async-openai**: API client for interacting with OpenAI's language models\n- **cchain**: Command chaining functionality for shell operations\n- **chrono**: Date and time handling with precision\n- **clap**: Command-line argument parsing with a beautiful interface\n- **console**: Terminal text styling and utilities\n- **indicatif**: Progress indicators for command-line applications\n- **serde/serde_json**: Powerful serialization and deserialization framework\n- **sysinfo**: System information gathering across platforms\n- **tokio**: Asynchronous runtime for efficient operations\n- **surfing**: Parse JSON out of plain texts\n\nA big thank you to all the developers who maintain these open-source libraries!\n\n---\n\n_`you` - because command lines should understand you, not the other way around._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faspadax%2Fyou","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faspadax%2Fyou","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faspadax%2Fyou/lists"}